README

Monitor your Laravel queues at a glance. Laravel Queue Monitor records the full lifecycle of every queued job and shows you pending, running, completed, and failed jobs — from an Artisan command or a live web dashboard.

Laravel ships with failed_jobs (failed) and a jobs table (pending, database driver only), but it never stores completed jobs. This package fills that gap by subscribing to Laravel's queue events and persisting each job's lifecycle to a dedicated queue_monitor table — so it works with any queue driver (database, Redis, SQS, …).

Requirements

• PHP 7.4 – 8.4
• Laravel 8 – 12

Installation

composer require jaydeep/laravel-queue-monitor

The service provider is auto-discovered. Publish and run the migration:

php artisan vendor:publish --tag=queue-monitor-migrations
php artisan migrate

Optionally publish the config and views:

php artisan vendor:publish --tag=queue-monitor-config
php artisan vendor:publish --tag=queue-monitor-views

Usage

Artisan command

php artisan queue-monitor:show

Queue Monitor
+---------+---------+-----------+--------+-------+
| Pending | Running | Completed | Failed | Total |
+---------+---------+-----------+--------+-------+
| 3       | 1       | 128       | 2      | 134   |
+---------+---------+-----------+--------+-------+

Options:

Web dashboard

Visit /queue-monitor in your browser for a live, auto-refreshing dashboard. It polls /queue-monitor/stats (JSON) on the interval set in config.

Security: the dashboard uses the web middleware group by default. Before exposing it in production, add authentication/authorization middleware in config/queue-monitor.php (route.middleware).

Configuration

config/queue-monitor.php:

How it works

The package registers a subscriber for Laravel's queue events:

All monitor writes are wrapped in a guard, so a monitoring error can never interrupt the job being processed.

Testing

composer install
./vendor/bin/phpunit

License

MIT © Jaydeep Gadhiya