PHPackages spatie/laravel-health - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. spatie/laravel-health ActiveLibrary[Logging & Monitoring](/categories/logging) spatie/laravel-health ===================== Monitor the health of a Laravel application 1.39.1(2mo ago)85810.0M—2.5%17420MITPHPPHP ^8.2CI passing Since Nov 22Pushed 2mo ago3 watchersCompare [ Source](https://github.com/spatie/laravel-health)[ Packagist](https://packagist.org/packages/spatie/laravel-health)[ Docs](https://github.com/spatie/laravel-health)[ GitHub Sponsors](https://github.com/spatie)[ RSS](/packages/spatie-laravel-health/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (55)Versions (155)Used By (20) [ ![Logo for laravel-health](https://camo.githubusercontent.com/302e50abe5e3120c9b6bdb36bf80e8073b700ab7e1343d40049de8b516f41abb/68747470733a2f2f7370617469652e62652f7061636b616765732f6865616465722f6c61726176656c2d6865616c74682f68746d6c2f6c696768742e776562703f31) ](https://spatie.be/open-source?utm_source=github&utm_medium=banner&utm_campaign=laravel-health)Check the health of your Laravel app ==================================== [](#check-the-health-of-your-laravel-app) [![Latest Version on Packagist](https://camo.githubusercontent.com/bac3cf83456601280e2989a2bf057cbfb42dc940c9af1f9cf0f25c197c664f02/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f6c61726176656c2d6865616c74682e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/laravel-health)[![run-tests](https://github.com/spatie/laravel-health/actions/workflows/run-tests.yml/badge.svg)](https://github.com/spatie/laravel-health/actions/workflows/run-tests.yml)[![Check & fix styling](https://github.com/spatie/laravel-health/actions/workflows/pint.yml/badge.svg)](https://github.com/spatie/laravel-health/actions/workflows/pint.yml)[![Total Downloads](https://camo.githubusercontent.com/9c3efb16e1064a880907b0c0a99b805ccf45d806f104464273c81056e803ad9f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f6c61726176656c2d6865616c74682e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/laravel-health) 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 ---------- [](#support-us) [![](https://camo.githubusercontent.com/eb1cc2d53eba5fbe0a3bfc0d9fa49f325228cf587151e17f3beddeee4ebd530e/68747470733a2f2f6769746875622d6164732e73332e65752d63656e7472616c2d312e616d617a6f6e6177732e636f6d2f6c61726176656c2d6865616c74682e6a70673f743d31)](https://spatie.be/github-ad-click/laravel-health) We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us). 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](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards). Documentation ------------- [](#documentation) All documentation is available [on our documentation site](https://spatie.be/docs/laravel-health). Alternatives ------------ [](#alternatives) If you don't like our package, do try out one of these alternatives: - [ans-group/laravel-health-check](https://github.com/ans-group/laravel-health-check) - [Antonioribeiro/health](https://github.com/antonioribeiro/health) Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Freek Van der Herten](https://github.com/freekmurze) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 74 — ExcellentBetter than 100% of packages Maintenance87 Actively maintained with recent releases Popularity71 Solid adoption and visibility Community45 Growing community involvement Maturity81 Battle-tested with a long release history Bus Factor1 Top contributor holds 80.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~10 days Total 151 Last Release 62d ago Major Versions 0.15.0 → 1.0.02021-12-07 PHP version history (2 changes)0.0.1PHP ^8.0 1.34.9PHP ^8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/7535935?v=4)[Spatie](/maintainers/spatie)[@spatie](https://github.com/spatie) --- Top Contributors [![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (750 commits)")[![jackwh](https://avatars.githubusercontent.com/u/627533?v=4)](https://github.com/jackwh "jackwh (19 commits)")[![pelmered](https://avatars.githubusercontent.com/u/680058?v=4)](https://github.com/pelmered "pelmered (13 commits)")[![kudashevs](https://avatars.githubusercontent.com/u/15892462?v=4)](https://github.com/kudashevs "kudashevs (13 commits)")[![ralphjsmit](https://avatars.githubusercontent.com/u/59207045?v=4)](https://github.com/ralphjsmit "ralphjsmit (12 commits)")[![ahinkle](https://avatars.githubusercontent.com/u/17038330?v=4)](https://github.com/ahinkle "ahinkle (12 commits)")[![abenerd](https://avatars.githubusercontent.com/u/7523903?v=4)](https://github.com/abenerd "abenerd (8 commits)")[![mateusjatenee](https://avatars.githubusercontent.com/u/10816999?v=4)](https://github.com/mateusjatenee "mateusjatenee (7 commits)")[![Nicholasbell03](https://avatars.githubusercontent.com/u/104824661?v=4)](https://github.com/Nicholasbell03 "Nicholasbell03 (7 commits)")[![oprypkhantc](https://avatars.githubusercontent.com/u/54406427?v=4)](https://github.com/oprypkhantc "oprypkhantc (7 commits)")[![christosku](https://avatars.githubusercontent.com/u/905336?v=4)](https://github.com/christosku "christosku (6 commits)")[![patrick-levesque](https://avatars.githubusercontent.com/u/16340194?v=4)](https://github.com/patrick-levesque "patrick-levesque (6 commits)")[![HajMo](https://avatars.githubusercontent.com/u/50548630?v=4)](https://github.com/HajMo "HajMo (6 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (6 commits)")[![rbibby](https://avatars.githubusercontent.com/u/4687015?v=4)](https://github.com/rbibby "rbibby (5 commits)")[![mtawil](https://avatars.githubusercontent.com/u/700753?v=4)](https://github.com/mtawil "mtawil (5 commits)")[![faustoFF](https://avatars.githubusercontent.com/u/653752?v=4)](https://github.com/faustoFF "faustoFF (5 commits)")[![AdrianMrn](https://avatars.githubusercontent.com/u/12762044?v=4)](https://github.com/AdrianMrn "AdrianMrn (4 commits)")[![rcerljenko](https://avatars.githubusercontent.com/u/16762056?v=4)](https://github.com/rcerljenko "rcerljenko (4 commits)")[![saeedhosseiinii](https://avatars.githubusercontent.com/u/39903221?v=4)](https://github.com/saeedhosseiinii "saeedhosseiinii (4 commits)") --- Tags spatielaravellaravel-health ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/spatie-laravel-health/health.svg) ``` [![Health](https://phpackages.com/badges/spatie-laravel-health/health.svg)](https://phpackages.com/packages/spatie-laravel-health) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.6k509.9M17.0k](/packages/laravel-framework)[spatie/laravel-backup A Laravel package to backup your application 6.0k21.8M191](/packages/spatie-laravel-backup)[spatie/laravel-activitylog A very simple activity logger to monitor the users of your website or application 5.8k45.4M309](/packages/spatie-laravel-activitylog)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[laravel-zero/framework The Laravel Zero Framework. 3371.4M369](/packages/laravel-zero-framework)[laravel/cashier Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services. 2.5k25.9M107](/packages/laravel-cashier) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)