spatie/laravel-health

Monitor the health of a Laravel application

Maintainers

👁 spatie

Package info

github.com/spatie/laravel-health

pkg:composer/spatie/laravel-health

Fund package maintenance!

spatie

Statistics

Installs: 11 898 136

Dependents: 92

Suggesters: 6

Stars: 874

Open Issues: 0

1.40.0 2026-05-28 08:55 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT 6fa735589c04fd99970b434fc22dddbdc716a264

  • Freek Van der Herten <freek.woop@spatie.be>

laravelspatielaravel-health

This package is auto-updated.

Last update: 2026-06-16 13:05:42 UTC


README

👁 Logo for laravel-health

Check the health of your Laravel app

👁 Latest Version on Packagist
👁 run-tests
👁 Check & fix styling
👁 Total Downloads

Using this package you can monitor the health of your application by registering checks.

Here's an example where we'll monitor available disk space.

// typically, in a service provider

use Spatie\Health\Facades\Health;
use Spatie\Health\Checks\Checks\UsedDiskSpaceCheck;

Health::checks([
 UsedDiskSpaceCheck::new()
 ->warnWhenUsedSpaceIsAbovePercentage(70)
 ->failWhenUsedSpaceIsAbovePercentage(90),
]);

When the used disk space is over 70%, then a notification with a warning will be sent. If it's above 90%, you'll get an error notification. Out of the box, the package can notify you via mail and Slack.

Support us

👁 Image

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.

Documentation

All documentation is available on our documentation site.

Alternatives

If you don't like our package, do try out one of these alternatives:

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

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