Looking to hire Laravel developers? Try LaraJobs

laravel-health maintained by leek

Description
Monitor the health of a Laravel application (fork of spatie/laravel-health)
Last update
2026/04/30 18:59 (dev-main)
License
Downloads
0

Comments
comments powered by Disqus

leek/laravel-health

Fork of spatie/laravel-health with PRs the upstream maintainer rejected but real users want. Drop-in replacement — keeps the Spatie\Health\* namespace and declares replace: spatie/laravel-health in composer.

Install

composer require leek/laravel-health

If your project (or another package) already requires spatie/laravel-health, the replace directive resolves to this fork — no other changes needed.

What's added on top of upstream

  • HEALTH_MAIL_TO, HEALTH_THROTTLE_NOTIFICATIONS_FOR_MINUTES env-driven config (PR #313, #73)
  • Health::setTheme() for runtime theme override (PR #22)
  • Check::environments() constraint (PR #121)
  • Per-check disableNotifications() + throttleNotificationsFor() (PR #234)
  • JSON output status + failingChecks summary (PR #236)
  • Microsoft Teams notification channel (PR #199)
  • TypesenseCheck, OctaneCheck (PR #69, #147)

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

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.