README

Add health checks to your Laravel applications with this package.

Examples

Install

First, use Composer to install this package.

$ composer require phpsafari/health-checks

After the package has been installed, go ahead and add ``PhpSafari\ServiceProvider\HealthCheckServiceProvider::classto yourconfig/app.php` file.

After doing this, you can publish the health.php configuration file into your config folder by running:

$ php artisan vendor:publish --tag=health

Usage

Inside the config/health.php file is where you configure all your available health checks. By default, this package comes packed with a few checks already:

CorrectEnvironment will check if your application's environment is set to production
DatabaseOnline will check your database connection
DatabaseUpToDate will check if your application has any migrations that hasn't been migrated yet
DebugModeOff will check if debug mode is off
QueueProcessing will check if the queue is running and jobs are getting processed
PathIsWritable will check if a provided path is writable
LogLevel will check if log level is set to the given value
MaxRatioOf500Responses will check if the ratio of 500 response are above a given threshold (The last 60 min)
MaxResponseTimeAvg will check if average response time for all request are above a given threshold (The last 60 min)

To run a health check of your application, run:

$ php artisan health:check

You can also use Laravel's scheduler to schedule your health checks:

$schedule->command('health:check')->hourly();

Url based health checks

You can also run a health check by hitting the https://<APP_URL>/_health url in a browser or with a tool like Pingdom.

Note: _This feature can be disabled in the config/health.php file, by setting route.enabled to false.

You can navigate to https://<APP_URL>/_health/stats and get all stats, including avg response time,

Creating your own health checks

In order to create your own health checks, you just need to extend the PhpSafari\Checks\HealthCheck class and implement the run() method.

Example:

class IsFriday extends PhpSafari\Checks\HealthCheck
{
    public function run(): bool
    {
        return Carbon::now()->isFriday();
    }
}

Then add new IsFriday() to the list of checks in config/health.php.

Testing

$ phpunit tests/

Security

If you discover any security related issues, please email :author_email instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.

phpsafari / health-checks

Maintainers

Details