Download the PHP package caminodeldev/laravel-queue-top without Composer
On this page you can find all versions of the php package caminodeldev/laravel-queue-top. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download caminodeldev/laravel-queue-top
More information about caminodeldev/laravel-queue-top
Files in caminodeldev/laravel-queue-top
Package laravel-queue-top
Short Description A safe terminal dashboard for inspecting Laravel queues, failed jobs, workers and queue health.
License MIT
Informations about the package laravel-queue-top
Laravel Queue Top
A terminal dashboard for Laravel queues.
I started this package from a very practical problem: when queues begin to grow, fail, or behave strangely, it should not take several commands and a lot of guesswork to understand what is happening.
Laravel Queue Top gives you a quick operational view from Artisan: queue snapshots, failed job summaries, worker heartbeat, health checks, diagnostics, and safe failed-job actions.
The package is intentionally careful. Most commands are read-only. The commands that can change failed jobs require explicit filters and --confirm.
Installation
Publish the configuration file:
Then try a first snapshot:
Requirements
Laravel Queue Top is prepared for Laravel 10, 11, 12, and 13 through the Illuminate component constraints in composer.json.
The package is designed to work without shelling out to external tools such as redis-cli, psql, watch, or top.
Quick start
A one-shot queue snapshot:
A live terminal view:
JSON output for scripts:
Queue health:
Failed jobs grouped by fingerprint:
Inspect a job safely:
Run configuration diagnostics:
Main commands
| Command | What I use it for |
|---|---|
queue:top |
See queue backlog and workers from the terminal. |
queue:health |
Get a script-friendly health result with stable exit codes. |
queue:failed:summary |
Understand repeated failures without opening every failed job. |
queue:inspect |
Inspect an active or failed job without exposing raw payloads by default. |
queue:doctor |
Check whether the queue setup looks safe and predictable. |
queue:failed:retry-safe |
Retry selected failed jobs with dry-run by default. |
queue:failed:forget-safe |
Delete selected failed jobs with dry-run by default. |
Safety defaults
This package tries hard not to surprise you.
- It does not print raw payloads by default.
- It does not deserialize queued commands during inspection.
- It redacts sensitive-looking keys when payload preview is enabled.
- It does not retry or delete failed jobs unless
--confirmis used. - It requires an explicit selection before failed-job operations.
- It keeps JSON output available for automation and logs.
Safe operations
Preview selected failed jobs:
Actually retry them:
Preview deletion:
Actually delete:
Documentation
| Topic | English | Spanish |
|---|---|---|
| Command reference | docs/COMMAND_REFERENCE.md |
docs/COMMAND_REFERENCE.es.md |
| Interactive mode | docs/INTERACTIVE_MODE.md |
docs/INTERACTIVE_MODE.es.md |
| Health checks | docs/HEALTH_CHECKS.md |
docs/HEALTH_CHECKS.es.md |
| Failed jobs summary | docs/FAILED_JOBS_SUMMARY.md |
docs/FAILED_JOBS_SUMMARY.es.md |
| Job inspection | docs/JOB_INSPECTION.md |
docs/JOB_INSPECTION.es.md |
| Worker heartbeat | docs/WORKER_HEARTBEAT.md |
docs/WORKER_HEARTBEAT.es.md |
| Redis driver | docs/REDIS_DRIVER.md |
docs/REDIS_DRIVER.es.md |
| Doctor mode | docs/DOCTOR_MODE.md |
docs/DOCTOR_MODE.es.md |
| Safe operations | docs/SAFE_OPERATIONS.md |
docs/SAFE_OPERATIONS.es.md |
| Driver matrix | docs/DRIVER_MATRIX.md |
docs/DRIVER_MATRIX.es.md |
Validation
For local validation:
Branch and release style
The repository uses master as the main branch.
The release tags follow semantic versioning:
Contributing
Small, focused pull requests are easier to review.
Before opening a PR, please run:
Read CONTRIBUTING.md for the workflow.
Security
Please do not open public issues with secrets, tokens, private queue payloads, or production data.
Read SECURITY.md before reporting a vulnerability.
License
MIT.
All versions of laravel-queue-top with dependencies
illuminate/console Version ^10.0|^11.0|^12.0|^13.0
illuminate/contracts Version ^10.0|^11.0|^12.0|^13.0
illuminate/database Version ^10.0|^11.0|^12.0|^13.0
illuminate/support Version ^10.0|^11.0|^12.0|^13.0