Vantage: Advanced Laravel Queue Monitoring & Insights

In a complex Laravel ecosystem, background jobs are often the backbone of the application. However, monitoring these jobs usually requires toggling between CLI commands and database managers. Vantage by Houda Slassi provides a high-fidelity, real-time dashboard to track, manage, and optimize your Laravel queues with surgical precision.

Unlike basic loggers, Vantage captures the entire lifecycle of a job, providing metrics on execution time, memory usage, and throughput across any queue driver.

🚀 Quick Start Installation

Vantage is designed to be "plug-and-play." Follow these steps to integrate it into your Laravel project:

1. Install the Package

Pull Vantage into your project via Composer:

composer require houdaslassi/vantage

2. Publish Configuration

Publish the vantage.php config file to your application's config directory. This allows you to customize the dashboard path, middleware, and database settings.

php artisan vendor:publish --tag=vantage-config

3. Run Migrations

Vantage uses dedicated tables to store job metrics and history without bloating your main application tables. Run the migrations to set them up:

php artisan migrate

⚙️ Key Technical Features

Comprehensive Job Lifecycle Tracking

Vantage monitors more than just "Success" or "Failure." It breaks down every job into actionable data points:

Wait Time: How long the job sat in the queue before a worker picked it up.
Execution Time: The exact duration of the handle() method.
Memory Peak: The maximum RAM consumed, helping you identify heavy jobs that need optimization.

Driver Agnostic Observability

While Laravel Horizon is restricted to Redis, Vantage works seamlessly across:

Database
Redis
SQS / Beanstalkd

Advanced Management UI

Search & Filter: Instantly find jobs by class name, queue name, or status.
Payload Inspection: View the exact data passed to the job and the full exception stack trace if it fails.
Manual Control: Retry failed jobs or cancel pending ones directly from the browser.

🔒 Security & Access Control

By default, Vantage is accessible at /vantage. You can secure this dashboard in your AppServiceProvider or within the vantage.php config file by defining authorized users:

// config/vantage.php
'middleware' => [
    'web',
    \App\Http\Middleware\Authenticate::class,
    \App\Http\Middleware\CheckAdmin::class,
],

💡 Why Vantage?

Standard Laravel tools tell you if a job failed. Vantage tells you why your queue is slow. By visualizing throughput and resource consumption, you can make informed decisions about scaling your worker nodes or refactoring expensive background logic.

GitHub Repository: houdaslassi/vantage