PHPackages mvpopuk/laravel-enhanced-failed-jobs - 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. [CLI & Console](/categories/cli) 4. / 5. mvpopuk/laravel-enhanced-failed-jobs Abandoned → [queuewatch/laravel](/?search=queuewatch%2Flaravel)Library[CLI & Console](/categories/cli) mvpopuk/laravel-enhanced-failed-jobs ==================================== Laravel package for Queuewatch - Real-time queue failure monitoring v1.1.1(5mo ago)24[2 PRs](https://github.com/queuewatch/laravel/pulls)MITPHPPHP ^8.1|^8.2|^8.3|^8.4CI passing Since Nov 25Pushed 1mo agoCompare [ Source](https://github.com/queuewatch/laravel)[ Packagist](https://packagist.org/packages/mvpopuk/laravel-enhanced-failed-jobs)[ Docs](https://github.com/mvpopuk/laravel-enhanced-failed-jobs)[ GitHub Sponsors](https://github.com/mvpopuk)[ RSS](/packages/mvpopuk-laravel-enhanced-failed-jobs/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (11)Versions (8)Used By (0) Queuewatch Laravel ================== [](#queuewatch-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/01d85a24b139d37f555051ab7e938bfb20ea11bab390e448b6081494ee5a79be/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f717565756577617463682f6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/queuewatch/laravel)[![GitHub Tests Action Status](https://camo.githubusercontent.com/24cbe8620ab994b0150bd22f8313b53ed28fafd406eda619983e7deb0d6bdea8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f717565756577617463682f6c61726176656c2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/queuewatch/laravel/actions?query=workflow%3Arun-tests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/6cd9e1400bfd13212a010c7f1cb2d528d7c0cdb991500b7a539cb6207afae62b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f717565756577617463682f6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/queuewatch/laravel) Enhanced CLI ------------ [](#enhanced-cli) Installation ------------ [](#installation) ``` composer require queuewatch/laravel ``` ### Basic Commands [](#basic-commands) ``` # List all failed jobs (table format) php artisan queue:failed # Output as JSON php artisan queue:failed --json ``` ### Filtering Options [](#filtering-options) ``` # Filter by queue name php artisan queue:failed --queue=emails # Filter by connection php artisan queue:failed --connection=redis # Filter by date range php artisan queue:failed --after="2025-11-20" php artisan queue:failed --before="2025-11-21" php artisan queue:failed --after=yesterday --before=today # Filter by job class (partial match) php artisan queue:failed --class=SendEmail # Limit results php artisan queue:failed --limit=50 # Combine multiple filters php artisan queue:failed --queue=emails --after=yesterday --limit=10 --json ``` ### JSON Output Format [](#json-output-format) ``` { "failed_jobs": [ { "id": "1234", "uuid": "550e8400-e29b-41d4-a716-446655440000", "connection": "redis", "queue": "emails", "payload": { "displayName": "App\\Jobs\\SendEmail", "job": "Illuminate\\Queue\\CallQueuedHandler@call", "data": {} }, "exception": "Connection timeout...", "failed_at": "2025-11-21 10:30:00" } ], "count": 1 } ``` [Queuewatch.io](https://queuewatch.io) (Optional) ------------------------------------------------- [](#queuewatchio-optional) Official Laravel package for [Queuewatch](https://queuewatch.io) - Real-time queue failure monitoring with instant notifications. - **Real-time Failure Reporting** - Automatically capture and report queue job failures to your Queuewatch dashboard - **Rich Exception Data** - Full stack traces, job payloads, and server context - **Smart Filtering** - Ignore specific jobs, queues, or exception types - **Remote Retry** - Retry failed jobs directly from the Queuewatch dashboard - **Instant Notifications** - Get notified via Slack, Discord, email, or webhooks when jobs fail [![Banners Frame 2](https://private-user-images.githubusercontent.com/35864222/526182332-8efc68c0-f3e8-499a-bb53-955c31ce85f8.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0MzQxMDIsIm5iZiI6MTc3NTQzMzgwMiwicGF0aCI6Ii8zNTg2NDIyMi81MjYxODIzMzItOGVmYzY4YzAtZjNlOC00OTlhLWJiNTMtOTU1YzMxY2U4NWY4LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA2VDAwMDMyMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWM4OGQ5OTM5NzhiY2ZlNGVmMGU5NjA5ZmM3ZmVmMTJlNGMzMWNlMmE5MGFkNGE0MGRmYzk5NjQ3MTE5YjcyNGMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.hIklJrbMTBKZl1t1Y0wMo7JDbZpHyR4BornsfTbLiQA)](https://private-user-images.githubusercontent.com/35864222/526182332-8efc68c0-f3e8-499a-bb53-955c31ce85f8.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0MzQxMDIsIm5iZiI6MTc3NTQzMzgwMiwicGF0aCI6Ii8zNTg2NDIyMi81MjYxODIzMzItOGVmYzY4YzAtZjNlOC00OTlhLWJiNTMtOTU1YzMxY2U4NWY4LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA2VDAwMDMyMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWM4OGQ5OTM5NzhiY2ZlNGVmMGU5NjA5ZmM3ZmVmMTJlNGMzMWNlMmE5MGFkNGE0MGRmYzk5NjQ3MTE5YjcyNGMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.hIklJrbMTBKZl1t1Y0wMo7JDbZpHyR4BornsfTbLiQA)Requirements ------------ [](#requirements) - PHP 8.1+ - Laravel 10.x, 11.x, or 12.x - A [Queuewatch](https://queuewatch.io) account Installation ------------ [](#installation-1) ``` composer require queuewatch/laravel ``` Add your API key to `.env`: ``` QUEUEWATCH_API_KEY=qw_live_xxxxxxxxxxxxxxxxxxxx ``` That's it! The package automatically hooks into Laravel's queue system and starts reporting failures. Getting Your API Key -------------------- [](#getting-your-api-key) 1. Sign up at [queuewatch.io](https://queuewatch.io) 2. Create a new project in your dashboard 3. Copy the API key from **Settings → API Keys** 4. Add it to your `.env` file Configuration ------------- [](#configuration) Publish the config file for advanced customization: ``` php artisan vendor:publish --tag=queuewatch-config ``` ### Available Options [](#available-options) ``` // config/queuewatch.php return [ 'enabled' => env('QUEUEWATCH_ENABLED', true), 'api_key' => env('QUEUEWATCH_API_KEY'), 'project' => env('QUEUEWATCH_PROJECT', env('APP_NAME')), 'environment' => env('QUEUEWATCH_ENVIRONMENT', env('APP_ENV')), // Jobs to ignore 'ignored_jobs' => [ // App\Jobs\NoisyJob::class, ], // Queues to ignore 'ignored_queues' => [ // 'low-priority', ], // Exceptions to ignore 'ignored_exceptions' => [ // Illuminate\Database\Eloquent\ModelNotFoundException::class, ], ]; ``` ### Environment Variables [](#environment-variables) VariableDescriptionDefault`QUEUEWATCH_ENABLED`Enable/disable failure reporting`true``QUEUEWATCH_API_KEY`Your Queuewatch API key-`QUEUEWATCH_PROJECT`Project name in dashboard`APP_NAME``QUEUEWATCH_ENVIRONMENT`Environment label (production, staging, etc.)`APP_ENV``QUEUEWATCH_RETRY_ENABLED`Enable remote retry feature`false`Testing Your Integration ------------------------ [](#testing-your-integration) ``` php artisan queuewatch:test ``` This verifies your API key and connection. Add `--send-test` to send a test failure: ``` php artisan queuewatch:test --send-test ``` You should see the test failure appear in your [Queuewatch dashboard](https://queuewatch.io/dashboard) within seconds. What Gets Reported ------------------ [](#what-gets-reported) When a job fails, Queuewatch captures: - **Job Details** - Class name, queue, connection, attempts, max tries - **Exception** - Message, class, file, line, full stack trace - **Payload** - Complete job payload (can be disabled for sensitive data) - **Context** - Server hostname, PHP version, Laravel version, timestamp - **Environment** - Your configured environment label Remote Retry ------------ [](#remote-retry) Enable remote retry to retry failed jobs directly from the Queuewatch dashboard: ``` QUEUEWATCH_RETRY_ENABLED=true ``` Configure allowed queues for security: ``` 'retry' => [ 'enabled' => env('QUEUEWATCH_RETRY_ENABLED', false), 'allowed_queues' => ['payments', 'emails'], // or ['*'] for all ], ``` When enabled, you can click "Retry" on any failed job in your Queuewatch dashboard, and it will be re-dispatched to your Laravel application. Notifications ------------- [](#notifications) Configure notifications in your [Queuewatch dashboard](https://queuewatch.io/dashboard/settings/notifications): - **Slack** - Get alerts in your team's Slack channel - **Discord** - Send notifications to Discord webhooks - **Email** - Receive email alerts for failures - **Webhooks** - Integrate with any service via custom webhooks Set up notification rules to filter by environment, job type, or failure frequency. Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Marian Pop](https://github.com/mvpopuk) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 41 — FairBetter than 89% of packages Maintenance82 Actively maintained with recent releases Popularity6 Limited adoption so far Community9 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 87.5% 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 ~1 days Total 4 Last Release 164d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/db5a4af32c7965f857c9d02d268942a1e023a52e2b97705bf6c1176d5e2ebad4?d=identicon)[mvpopuk](/maintainers/mvpopuk) --- Top Contributors [![mvpopuk](https://avatars.githubusercontent.com/u/35864222?v=4)](https://github.com/mvpopuk "mvpopuk (14 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)") --- Tags laravelmonitoring-toolqueuesjsonclilaravelqueuefailed jobsmvpopuk ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/mvpopuk-laravel-enhanced-failed-jobs/health.svg) ``` [![Health](https://phpackages.com/badges/mvpopuk-laravel-enhanced-failed-jobs/health.svg)](https://phpackages.com/packages/mvpopuk-laravel-enhanced-failed-jobs) ``` ### Alternatives [roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k12.1M99](/packages/laravel-pulse)[nunomaduro/laravel-console-menu Laravel Console Menu is an output method for your Laravel/Laravel Zero commands. 815412.0k48](/packages/nunomaduro-laravel-console-menu)[laravel-notification-channels/discord Laravel notification driver for Discord. 2371.3M11](/packages/laravel-notification-channels-discord)[torchlight/torchlight-laravel A Laravel Client for Torchlight, the syntax highlighting API. 120452.8k11](/packages/torchlight-torchlight-laravel)[glhd/conveyor-belt 14797.0k](/packages/glhd-conveyor-belt) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)