PHPackages okipa/laravel-supervisor-downtime-notifier - 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. [Queues & Workers](/categories/queues) 4. / 5. okipa/laravel-supervisor-downtime-notifier ActiveLibrary[Queues & Workers](/categories/queues) okipa/laravel-supervisor-downtime-notifier ========================================== Get notified when supervisor is down. 2.4.0(3y ago)88.1k1[1 PRs](https://github.com/Okipa/laravel-supervisor-downtime-notifier/pulls)MITPHPPHP 8.1.\*|8.2.\* Since May 13Pushed 3y ago1 watchersCompare [ Source](https://github.com/Okipa/laravel-supervisor-downtime-notifier)[ Packagist](https://packagist.org/packages/okipa/laravel-supervisor-downtime-notifier)[ Docs](https://github.com/Okipa/laravel-supervisor-downtime-notifier)[ Fund](https://paypal.me/arthurlorent)[ GitHub Sponsors](https://github.com/Okipa)[ RSS](/packages/okipa-laravel-supervisor-downtime-notifier/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (10)Versions (12)Used By (0) [![Laravel Supervisor Downtime Notifier](/docs/laravel-supervisor-downtime-notifier.png)](/docs/laravel-supervisor-downtime-notifier.png) [ ![Latest Stable Version](https://camo.githubusercontent.com/3265db373e7b106dde283045adb8c2c586e8b25d00f50e1a23f74cea008f0d7a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f4f6b6970612f6c61726176656c2d73757065727669736f722d646f776e74696d652d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265) ](https://github.com/Okipa/laravel-supervisor-downtime-notifier/releases "Latest Stable Version") [ ![Total Downloads](https://camo.githubusercontent.com/d3c17de4386c6ba7fb1e992c72c63e66c34d0082ffc8981c1f33685c6e04cf58/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f6b6970612f6c61726176656c2d73757065727669736f722d646f776e74696d652d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/Okipa/laravel-supervisor-downtime-notifier "Total Downloads") [ ![Build Status](https://github.com/Okipa/laravel-supervisor-downtime-notifier/workflows/CI/badge.svg) ](https://github.com/Okipa/laravel-supervisor-downtime-notifier/actions "Build Status") [ ![Coverage Status](https://camo.githubusercontent.com/64526db17583fee7e3abcded9eeab0ae339100768eefb98a53305a5cdfb1c21c/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f4f6b6970612f6c61726176656c2d73757065727669736f722d646f776e74696d652d6e6f7469666965722f62616467652e7376673f6272616e63683d6d6173746572) ](https://coveralls.io/github/Okipa/laravel-supervisor-downtime-notifier?branch=master "Coverage Status") [ ![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667) ](/LICENSE.md "License: MIT") Get notified and execute PHP callback when: - The supervisor service is not running on your server - Your environment supervisor processes are down Notifications can be sent by mail, Slack and webhooks (chats often provide a webhook API). Found this package helpful? Please consider supporting my work! [![Donate](https://camo.githubusercontent.com/6c3b5a78d466728cacf06baad81fbd1e05af9cdb0406db055d37df429291a74f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4275795f6d655f612d4b6f2d2d66692d6666356635662e737667)](https://ko-fi.com/arthurlorent)[![Donate](https://camo.githubusercontent.com/3cd689d69c5219f5c2f2675b7ccccb50061b112100f2468c1cec746765762ebd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174655f6f6e2d50617950616c2d677265656e2e737667)](https://paypal.me/arthurlorent) Compatibility ------------- [](#compatibility) Laravel versionPHP versionPackage version^9.0 | ^10.08.1.\* | 8.2.\*^2.4^8.0 | ^9.0^8.1 | ^8.2^2.3^8.0 | ^9.0^8.0 | ^8.1^2.2^7.0 | ^8.0^7.4 | ^8.0^2.1^7.0 | ^8.0^7.4^2.0^6.0 | ^7.0^7.4^1.0Upgrade guide ------------- [](#upgrade-guide) - [From v1 to V2](/docs/upgrade-guides/from-v1-to-v2.md) Table of Contents ----------------- [](#table-of-contents) - [Requirements](#requirements) - [Installation](#installation) - [Configuration](#configuration) - [Translations](#translations) - [Usage](#usage) - [Testing](#testing) - [Changelog](#changelog) - [Contributing](#contributing) - [Credits](#credits) - [Licence](#license) Requirements ------------ [](#requirements) By default, this package monitors supervisor downtime for projects running on Linux servers. The user running PHP CLI will execute the following commands: - `systemctl is-active supervisor` - `supervisorctl status ""` As so, make sure you give him permission to execute these actions (`sudo visudo -f /etc/sudoers.d/`): - ` ALL=NOPASSWD:/bin/systemctl is-active supervisor` - ` ALL=NOPASSWD:/usr/bin/supervisorctl status *` That being said, you still can use this package for other servers OS by using your own `SupervisorChecker` class and defining OS-specific commands. Installation ------------ [](#installation) Install the package with composer: ``` composer require okipa/laravel-supervisor-downtime-notifier ``` If you intend to send `Slack` notifications you will have to install: - ``` composer require laravel/slack-notification-channel ``` If you intend to send `webhook` notifications you will have to install: - ``` composer require laravel-notification-channels/webhook ``` Configuration ------------- [](#configuration) Publish the package configuration: ``` php artisan vendor:publish --tag=supervisor-downtime-notifier:config ``` Translations ------------ [](#translations) All words and sentences used in this package are translatable. See how to translate them on the Laravel official documentation: . Here is the list of the words and sentences available for translation by default: ``` * [:app - :env] supervisor service is not started * We have detected that the supervisor service is not started on [:app - :env](:url). * `[:app - :env]` supervisor service is not started on :url. * Supervisor service is not started. * {1}[:app - :env] :count supervisor down process has been detected|[2,*][:app - :env] :count supervisor down processes have been detected * {1}We have detected :count supervisor down process on [:app - :env](:url): ":processes".|[2,*]We have detected :count supervisor down processes on [:app - :env](:url): ":processes". * Please check your down processes connecting to your server and executing the "supervisorctl status" command. * {1}`[:app - :env]` :count supervisor down process has been detected on :url: ":processes".|[2,*]`[:app - :env]` :count supervisor down processes have been detected on :url: ":processes". * {1}:count supervisor down process has been detected: ":processes".|[2,*]:count supervisor down processes have been detected: ":processes". * Notification test: * Exception test: ``` Usage ----- [](#usage) Just add this command in the `schedule()` method of your `\App\Console\Kernel` class: ``` $schedule->command('supervisor:downtime:notify')->everyFifteenMinutes(); ``` And you will be notified if your supervisor service is not running, or if your environment supervisor processes are down when the command will be executed. Once everything has been set up, you can check if the configuration is correct by simulating supervisor processes downtime: ``` php artisan supervisor:downtime:simulate ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Credits ------- [](#credits) - [Arthur LORENT](https://github.com/okipa) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 36 — LowBetter than 82% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity25 Limited adoption so far Community8 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor1 Top contributor holds 100% 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 ~98 days Recently: every ~46 days Total 11 Last Release 1206d ago Major Versions 1.1.2 → 2.0.02020-09-25 PHP version history (5 changes)1.0.0PHP ^7.4 2.1.0PHP ^7.4||^8.0 2.2.0PHP ^8.0|^8.1 2.3.0PHP ^8.1|^8.2 2.4.0PHP 8.1.\*|8.2.\* ### Community Maintainers ![](https://www.gravatar.com/avatar/cc5b2b60afe2f6f28bd3ef5105fc1883386967efcc744b1b6829b8eb289f5a91?d=identicon)[Okipa](/maintainers/Okipa) --- Top Contributors [![Okipa](https://avatars.githubusercontent.com/u/5328934?v=4)](https://github.com/Okipa "Okipa (18 commits)") --- Tags downdowntimelaravelnotifiernotifyokipapackagephpprocessprocessesservicesupervisorworkerworkersphplaravelpackageprocessnotifierserviceworkernotifysupervisorprocessesworkersdownokipadowntimelaravel-supervisor-downtime-notifier ### Code Quality Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/okipa-laravel-supervisor-downtime-notifier/health.svg) ``` [![Health](https://phpackages.com/badges/okipa-laravel-supervisor-downtime-notifier/health.svg)](https://phpackages.com/packages/okipa-laravel-supervisor-downtime-notifier) ``` ### Alternatives [dusterio/laravel-aws-worker Run Laravel (or Lumen) tasks and queue listeners inside of AWS Elastic Beanstalk workers 3105.7M](/packages/dusterio-laravel-aws-worker)[okipa/laravel-table Generate tables from Eloquent models. 56752.8k](/packages/okipa-laravel-table)[foxxmd/laravel-elasticbeanstalk-queue-worker Deploy your Laravel application as a queue worker on AWS ElasticBeanstalk 5493.5k](/packages/foxxmd-laravel-elasticbeanstalk-queue-worker)[demi/php-gearman Gearman job server workers helper 176.6k](/packages/demi-php-gearman)[okipa/laravel-form-components Ready-to-use and customizable form components. 198.0k1](/packages/okipa-laravel-form-components) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)