Laravel Queue Monitor

Production-ready queue monitoring for Laravel with individual job tracking, payload storage, and job replay.

Overview

Laravel Queue Monitor provides granular visibility into every queue job in your Laravel application. Unlike aggregate metrics packages, it tracks each job individually from dispatch to completion, stores payloads for replay, and offers comprehensive analytics.

Key Capabilities

Individual Job Tracking

Monitor every single job with complete lifecycle visibility:

• Job queued → processing → completed/failed
• Retry chain tracking
• Exception capture with stack traces
• Server and worker identification

Job Replay

Re-dispatch failed jobs from stored payloads:

• Complete payload serialization
• Validation before replay
• Retry chain maintenance
• Perfect for development debugging

Resource Metrics

Track resource usage per job:

• Memory peak (MB)
• Duration (milliseconds)
• CPU time (via queue-metrics integration)
• File descriptors (future)

Comprehensive Analytics

Deep insights into queue performance:

• Global statistics (success rate, failure rate)
• Per-server analytics
• Per-queue analytics
• Per-job-class analytics
• Queue health scoring
• Failure pattern analysis
• Tag-based analytics

REST API

Full-featured API for custom dashboards:

• 14 endpoints covering all functionality
• Advanced filtering (20+ parameters)
• Pagination and sorting
• Rate limiting
• Authentication-ready

Quick Example

use Cbox\LaravelQueueMonitor\Facades\LaravelQueueMonitor as QueueMonitor;

// Get failed jobs from last 24 hours
$filters = new JobFilterData(
    statuses: [JobStatus::FAILED],
    queuedAfter: Carbon::now()->subHours(24)
);

$failed = QueueMonitor::getJobs($filters);

// Replay each one
foreach ($failed as $job) {
    QueueMonitor::replay($job->uuid);
}

// Check statistics
$stats = QueueMonitor::statistics();
echo "Success Rate: {$stats['success_rate']}%\n";

Documentation Structure

Getting Started

• Introduction - Package overview and key features
• Installation - Setup in 5 minutes
• Quick Start - Common usage patterns
• Configuration - Customize behavior

Core Features

• Facade Usage - Programmatic API
• Job Replay - Replay system deep dive
• Advanced Usage - Custom monitoring and dashboards
• Events - Event-driven integration

Reference

• Queue-Metrics Integration - Resource tracking
• API Reference - Complete REST API docs
• Testing Guide - Write tests with Pest 4
• Architecture - Package design patterns

Architecture

Built on solid patterns for maintainability:

• Action Pattern - Business logic in single-responsibility classes
• DTO Pattern - Type-safe data transfer objects
• Repository Pattern - Clean data access abstraction
• Event-Driven - Loosely coupled integration
• SOLID Principles - Professional code quality

Requirements

• PHP 8.3+
• Laravel 10.0+
• cboxdk/laravel-queue-metrics ^1.0

Features at a Glance

Next Steps

Start with the Installation Guide to get up and running in minutes.