README

A simple CLI tool to inspect delayed Redis queue jobs in Laravel. Useful for debugging, auditing, and gaining visibility into scheduled or stuck jobs.

📥 Installation

Install the package via Composer:

composer require pdmfc/redis-queue-inspector

Laravel will auto-discover the service provider, no manual registration needed.

🚀 Basic Usage

php artisan queue:inspect

This will inspect the first 50 delayed jobs in the default Redis queue.

🔍 Options

✅ Examples

Show all delayed jobs in the default queue

php artisan queue:inspect

Show jobs in the emails queue that contain "SendWelcome" in the class name

php artisan queue:inspect --queue=emails --job=SendWelcome

View jobs scheduled from a specific date

php artisan queue:inspect --from=2025-06-01

Search jobs that reference a model ID in the payload

php artisan queue:inspect --identifier=47004

Look up a job by UUID

php artisan queue:inspect --uuid=123e4567-e89b-12d3-a456-426614174000

Only return a count of matching jobs

php artisan queue:inspect --job=SendInvoice --count

Output results in JSON format

php artisan queue:inspect --queue=emails --job=SendWelcome --limit=2 --json

📌 Output Example

Showing 10 jobs (page 1) of 47 matching jobs.
+---------+--------------------------+--------------------------------------+---------------------+
| Queue   | Job Name                 | Job ID                               | Release At          |
+---------+--------------------------+--------------------------------------+---------------------+
| default | App\Jobs\SendWelcome     | 123e4567-e89b-12d3-a456-426614174000 | 2025-06-12 21:58:54 |
+---------+--------------------------+--------------------------------------+---------------------+
Tip: Run with --page=2 to see more.

🛠 Requirements

• PHP 8.1+
• Laravel with Redis queue driver enabled

📄 License

MIT License

👤 Author

Mário Souto
mario.souto@pdmfc.com