PHPackages okipa/laravel-stuck-jobs-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-stuck-jobs-notifier ActiveLibrary[Queues & Workers](/categories/queues) okipa/laravel-stuck-jobs-notifier ================================= Get notified when stuck jobs are detected. 2.4.0(3y ago)58.9k2[1 PRs](https://github.com/Okipa/laravel-stuck-jobs-notifier/pulls)MITPHPPHP 8.1.\*|8.2.\* Since May 6Pushed 3y ago1 watchersCompare [ Source](https://github.com/Okipa/laravel-stuck-jobs-notifier)[ Packagist](https://packagist.org/packages/okipa/laravel-stuck-jobs-notifier)[ Docs](https://github.com/Okipa/laravel-stuck-jobs-notifier)[ Fund](https://paypal.me/arthurlorent)[ GitHub Sponsors](https://github.com/Okipa)[ RSS](/packages/okipa-laravel-stuck-jobs-notifier/feed)WikiDiscussions master Synced 3w ago READMEChangelog (10)Dependencies (10)Versions (14)Used By (0) [![Laravel Stuck Jobs Notifier](/docs/laravel-stuck-jobs-notifier.png)](/docs/laravel-stuck-jobs-notifier.png) [ ![Latest Stable Version](https://camo.githubusercontent.com/acf9acb48688d29d2be8b1521fa8175a98d6a51c45e5c83d34ea35d90617488c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f4f6b6970612f6c61726176656c2d737475636b2d6a6f62732d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265) ](https://github.com/Okipa/laravel-stuck-jobs-notifier/releases "Latest Stable Version") [ ![Total Downloads](https://camo.githubusercontent.com/e6faa37b112f24be9b2d43c3bf458e69633b3b51bd6056153f000e5cf436f3da/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f6b6970612f6c61726176656c2d737475636b2d6a6f62732d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/Okipa/laravel-stuck-jobs-notifier "Total Downloads") [ ![Build Status](https://github.com/Okipa/laravel-stuck-jobs-notifier/workflows/CI/badge.svg) ](https://github.com/Okipa/laravel-stuck-jobs-notifier/actions "Build Status") [ ![Coverage Status](https://camo.githubusercontent.com/150797d287cc312566e196bb869a8ef8a8c49a4ecc2511603e15c3cff493acd1/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f4f6b6970612f6c61726176656c2d737475636b2d6a6f62732d6e6f7469666965722f62616467652e7376673f6272616e63683d6d6173746572) ](https://coveralls.io/github/Okipa/laravel-stuck-jobs-notifier?branch=master "Coverage Status") [ ![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667) ](/LICENSE.md "License: MIT") Get notified and execute PHP callback when you have stuck jobs for a defined number of hours. 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) - [From okipa/failed-jobs-notifier](/docs/upgrade-guides/from-failed-job-notifier.md) Table of Contents ----------------- [](#table-of-contents) - [Installation](#installation) - [Configuration](#configuration) - [Translations](#translations) - [Usage](#usage) - [Testing](#testing) - [Changelog](#changelog) - [Contributing](#contributing) - [Credits](#credits) - [Licence](#license) Installation ------------ [](#installation) Install the package with composer: ``` composer require okipa/laravel-stuck-jobs-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=stuck-jobs-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: ``` * {1}[:app - :env] :count job is stuck in queue|[2,*][:app - :env] :count jobs are stuck in queue * {1}We have detected that :count job is stuck in the [:app - :env](:url) queue since the :day at :hour.|[2,*]We have detected that :count jobs are stuck in the [:app - :env](:url) queue since the :day at :hour. * Please check your stuck jobs connecting to your server and executing the "php artisan queue:failed" command. * {1}`[:app - :env]` :count job is stuck in the :url queue since the :day at :hour.|[2,*]`[:app - :env]` :count jobs are stuck in the :url queue since the :day at :hour. * {1}:count job is stuck in queue since the :day at :hour.|[2,*]:count jobs are stuck in queue since the :day at :hour. * Notification test: * Exception test: ``` Usage ----- [](#usage) Just add this command in the `schedule()` method of your `\App\Console\Kernel` class: ``` $schedule->command('queue:stuck:notify')->twiceDaily(10, 16); ``` And you will be notified as soon as some jobs will be stuck in the `failed_jobs` table for the number of days you configured. Once everything has been set up, you can check if the configuration is correct by simulating stuck jobs detection: ``` php artisan queue:stuck: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 79% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity26 Limited adoption so far Community5 Small or concentrated contributor base Maturity76 Established project with proven stability 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 ~82 days Recently: every ~61 days Total 13 Last Release 1251d 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) --- Tags detectionfailedjobjobslaravelnotificationnotifierphpqueuestuckphplaravelpackagenotifierqueuejobjobsnotifyfailedokipastucklaravel-stuck-jobs-notifier ### Code Quality Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/okipa-laravel-stuck-jobs-notifier/health.svg) ``` [![Health](https://phpackages.com/badges/okipa-laravel-stuck-jobs-notifier/health.svg)](https://phpackages.com/packages/okipa-laravel-stuck-jobs-notifier) ``` ### Alternatives [larastan/larastan Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel 6.4k51.0M7.6k](/packages/larastan-larastan)[harris21/laravel-fuse Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures. 43140.3k](/packages/harris21-laravel-fuse)[croustibat/filament-jobs-monitor Background Jobs monitoring like Horizon for all drivers for FilamentPHP 271298.4k8](/packages/croustibat-filament-jobs-monitor)[renoki-co/horizon-exporter Export Laravel Horizon metrics using this Prometheus exporter. 24152.8k](/packages/renoki-co-horizon-exporter)[calebdw/larastan Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel 15104.9k4](/packages/calebdw-larastan)[mateffy/laravel-job-progress Track and show progress of your background jobs (for progress bar UIs etc.) 452.0k](/packages/mateffy-laravel-job-progress) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)