Laravel Queue Metrics
Production-ready queue monitoring and metrics collection for Laravel. Track job execution, monitor worker performance, and export to Prometheus.
Laravel Queue Metrics collects detailed telemetry from your queue workers: job execution times, success rates, failure patterns, throughput, and worker health. It is the metrics foundation for Laravel Queue Autoscale, but also valuable as a standalone monitoring solution.
Queue Visibility
Real-Time Metrics
Execution times, success rates, failure patterns, and throughput for every queue and job class. Updated in real-time with ~1-2ms overhead per job.
Health Scores
A 0-100 health score for each queue based on failure rate, processing time trends, and queue depth. Instant signal for operational dashboards.
Prometheus Export
Built-in /metrics endpoint for Prometheus scraping. Pre-configured metric names following Prometheus naming conventions.
Worker Heartbeats
Detect stale or crashed workers automatically. Each worker sends periodic heartbeats; missing heartbeats trigger alerts.
Event System
Listen for MetricsRecorded, HealthScoreChanged, WorkerEfficiencyChanged, and QueueDepthThresholdExceeded events in your application.
Multi-Tenancy Hooks
Enrich metrics with custom metadata via the hook system. Tag metrics by tenant, team, or any other dimension.
Storage backends
Redis is recommended for performance-critical environments. Database storage is available for teams that prefer persistence and queryability over raw speed. Both backends support the same API surface.
Zero configuration
Install with composer require, and metrics collection starts automatically. The package auto-registers its service provider and begins collecting from the first job dispatch.
