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

• Visti Kløft
• Peter Suhm

License

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