Queue Monitoring

The AdminQueueController provides visibility into background job processing and tools for managing failed jobs.

Supported Drivers

• Redis — recommended for production
• Database — good for development and low-traffic setups
• Amazon SQS — for AWS-native deployments

Queue Statistics

GET /api/admin/queues

Returns current queue health metrics:

{
    "stats": {
        "pending": 142,
        "processing": 3,
        "delayed": 18
    },
    "driver": "redis"
}

Failed Jobs

List Failed Jobs

GET /api/admin/queues/failed

Returns all failed jobs with their exception messages, queue name, and failure timestamps.

Retry a Specific Job

POST /api/admin/queues/failed/{id}/retry

Pushes the failed job back onto the queue for another attempt.

Retry All Failed Jobs

POST /api/admin/queues/failed/retry-all

Retries every failed job at once. Use with caution on large failure backlogs.

Delete a Specific Failed Job

DELETE /api/admin/queues/failed/{id}

Permanently removes a single failed job record.

Purge All Failed Jobs

DELETE /api/admin/queues/failed/purge

Deletes all failed job records. This does not affect pending or delayed jobs.