# Laravel Queue Insights

> Self-hosted, driver-agnostic queue observability for Laravel: depth, wait time, throughput, batches, chains, alerting, Prometheus and scheduler runs, across SQS, Redis and database queues.

## Getting started

- [Why Queue Insights?](https://sandermuller.github.io/laravel-queue-insights/why-queue-insights): The questions it answers that queue:work and a failed_jobs table leave open.
- [Installation](https://sandermuller.github.io/laravel-queue-insights/installation): Requirements, the install command, the snapshot scheduler, and the environment knobs.
- [Getting started](https://sandermuller.github.io/laravel-queue-insights/getting-started): Authorize the route, run a worker, and read depth against throughput.
- [Payload capture](https://sandermuller.github.io/laravel-queue-insights/payload-capture): Three capture modes, the separate pending budget, and binding your own sanitizer.

## Dashboard

- [Dashboard](https://sandermuller.github.io/laravel-queue-insights/dashboard): Authorisation, multi-connection scoping, retry permissions, and the filter row.
- [Jobs, batches, and chains](https://sandermuller.github.io/laravel-queue-insights/jobs-batches-chains): Wait time, the pending inspector, batch progress, chain lineage, and job initiator.
- [Failure context](https://sandermuller.github.io/laravel-queue-insights/failure-context): What is captured when a job fails, and the Sentry deep-link into the matching issue.
- [Theming and embedding](https://sandermuller.github.io/laravel-queue-insights/theming-and-embedding): Custom row markup, mounting inside an admin layout, dark mode, and the cloud look.

## Operations

- [Running workers](https://sandermuller.github.io/laravel-queue-insights/running-workers): The queue-insights:work supervisor, its non-goals, and shutdown grace tuning.
- [Ops runbook](https://sandermuller.github.io/laravel-queue-insights/ops-runbook): Console commands, dashboard signals, driver quirks, key prefixes, and Redis Cluster.
- [Alerting](https://sandermuller.github.io/laravel-queue-insights/alerting): Nine detectors, per-rule cooldown, notification channels, typed events, and silencing.

## Integrations

- [Horizon auto-discovery](https://sandermuller.github.io/laravel-queue-insights/horizon): Read supervisor queues and silenced jobs straight out of your Horizon config.
- [Connection aliasing](https://sandermuller.github.io/laravel-queue-insights/connection-aliasing): Collapse dispatcher/worker connection drift onto one canonical key.
- [Prometheus](https://sandermuller.github.io/laravel-queue-insights/prometheus): The opt-in /metrics endpoint, the metric catalogue, and the push gateway command.
- [Scheduler observability](https://sandermuller.github.io/laravel-queue-insights/scheduler): Per-task snapshots, per-run records, missed and hung detection, and retention.
- [Vapor and Laravel Cloud](https://sandermuller.github.io/laravel-queue-insights/vapor-and-cloud): What the managed platforms handle for you, and the few queues you list yourself.

## Reference

- [Configuration reference](https://sandermuller.github.io/laravel-queue-insights/configuration): Every key in config/queue-insights.php, with defaults and what each one changes.