Zenith For Laravel

Think Laravel Horizon, but for database-backed queues. Zenith brings the same real-time visibility and worker management that Horizon provides for Redis — to the database queue driver.

If you're running queues out of your database and want a live dashboard, worker process management, and job lifecycle tracking without switching to Redis, Zenith is built for you. See pending, processing, completed, and failed jobs alongside the worker processes handling them. Scale workers up or down, terminate supervisors, retry failures in bulk, and track performance over time — all from your browser, all without leaving your application.

Quick Install

Then visit /zenith in your browser. The dashboard is protected by the auth middleware by default.

Start workers with:

Add the monitor to your scheduler in routes/console.php:

Run A Demo

Spin up a fresh Laravel app with Zenith installed in under a minute:

Notes:

• -n in laravel new skips the default auth scaffolding since Zenith doesn't require it.
• With the above steps also update zenith.php config to remove auth from the middleware array.

Then browse to http://localhost:8000/zenith to see the dashboard.

Features

Live Dashboard

A real-time overview of your queue system refreshing every 5 seconds. At a glance: how many workers are active, how many are idle or stuck, jobs pending and completed today, average processing time, throughput (jobs/hour), and failure rate.

Job Visibility Across the Full Lifecycle

Browse every stage of a job's journey across dedicated tabs:

• Pending — jobs waiting in the queue, filterable by queue name
• Completed — successful jobs with processing time and batch membership
• Failed — full exception messages, per-job retry and delete, bulk retry all
• Batches — batch progress bars, pending/failed counts, status at a glance

Worker Management

The Workers page shows the full supervisor/child process hierarchy. For each supervisor you see its queue, connection, worker count, total jobs processed, last heartbeat, and uptime. For each child worker you see individual job counts, health status, and a "Stuck" indicator when a heartbeat goes missing.

From the UI you can:

• Scale Up — spawn an additional child worker under a supervisor (manual balance only)
• Scale Down — remove a child worker gracefully (manual balance only)
• Terminate — send a shutdown signal to a supervisor

Supervisor Groups & Balance Strategies

Each zenith:work invocation is tied to a named supervisor group defined in config/zenith.php. Groups configure the queue, connection, and — importantly — the balance strategy:

Heartbeat-Based Health Monitoring

Every worker reports a heartbeat on a configurable interval (default: 30 seconds). The zenith:monitor command — run every minute via the scheduler — compares last heartbeat times against a configurable stuck threshold (default: 120 seconds). Workers that go silent are marked terminated; jobs held by those workers can be automatically released back to the queue.

Job Lifecycle Events

Zenith hooks into Laravel's job events to record a JobEvent at every transition: started, completed, failed, retried, cancelled. Each event captures the queue, connection, attempt count, and processing time. The event log is the foundation for metrics, audit trails, and debugging.

API

All dashboard data is also available via JSON endpoints under /zenith/api/ — useful for external monitoring systems or custom tooling.

Built-In Test Dispatcher

The Tests tab dispatches real jobs through your queue so you can verify the full stack is wired up correctly. Dispatch a single job or a batch of configurable size, with optional logging enabled, and watch them flow through the dashboard in real time.

Installation

1. Install via Composer

2. Publish and Run Migrations

This creates three tables: zenith_processes, zenith_history, and zenith_events.

3. Publish the Config (optional)

4. Publish the Views (optional)

Artisan Commands

zenith:work

The primary worker command. Replaces queue:work with full Zenith monitoring.

zenith:monitor

Detects stuck workers and optionally releases their held jobs back to the queue. Run this every minute via the scheduler.

zenith:prune

Removes old records to keep the database lean. Safe to schedule daily.

Configuration

Multiple named groups are supported — useful when different queues need different strategies:

Then start each group as a separate process:

Recommended Scheduler Setup

How It Works

Process Model

zenith:work starts a supervisor process that manages a pool of child worker processes. Each child runs queue:work under the hood. The supervisor monitors its children and respawns them if they exit, and listens for scaling instructions delivered via the heartbeat action column in the database.

Heartbeats

On every worker loop iteration, Zenith updates last_heartbeat_at in the zenith_processes table for both the worker and its supervisor. zenith:monitor compares these timestamps against stuck_job_threshold and marks unresponsive processes as terminated. If auto_retry_stuck_jobs is enabled, any job the stuck worker was holding gets released back to the queue automatically.

Job Events

Zenith registers listeners for Laravel's built-in job lifecycle events:

Each JobHistory record stores the full payload, processing time in milliseconds, attempt count, queue, and connection. The JobEvent log provides the per-transition audit trail that drives the dashboard metrics.

Dashboard Metrics

The MetricsService computes all metrics on demand from the Zenith tables:

• Active workers — processes with status idle or working
• Completed today — JobHistory records with completed_at today
• Jobs per hour — completed events in the last 60 minutes
• Failure rate — (failed / (failed + completed)) * 100 over the same window
• Avg processing time — mean of processing_time_ms from today's completed jobs

Testing

Changelog

Please see CHANGELOG for recent changes.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Ralph Schindler
• All Contributors

License

The MIT License (MIT). Please see License File for more information.