The Complete Production SOP: How to Deploy and Run Laravel Horizon Redis Queue Management & Metrics in Autonomous AI Agents

---
name: "laravel-queues-horizon-monitoring"
description: "Manage and monitor Redis queues in Laravel with real-time throughput metrics and auto-scaling."
metadata:
  author: "Laravel"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "setup laravel horizon"
  - "auto balance horizon workers"
  - "retry failed jobs horizon"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: true
  net_access: false
---

return [
    'environments' => [
        'production' => [
            'supervisor-1' => [
                'connection' => 'redis',
                'queue' => ['high', 'default', 'low'],
                'balance' => 'auto',
                'autoScalingStrategy' => 'time',
                'minProcesses' => 2,
                'maxProcesses' => 16,
                'balanceMaxShift' => 2,
                'balanceCooldown' => 3,
                'memory' => 128,
                'tries' => 3,
                'timeout' => 60,
                'nice' => 0,
            ],
        ],
    ],
];

namespace App\Providers;

use Illuminate\Support\Facades\Gate;
use Laravel\Horizon\HorizonApplicationServiceProvider;

class HorizonServiceProvider extends HorizonApplicationServiceProvider
{
    protected function gate(): void
    {
        Gate::define('viewHorizon', function ($user) {
            return in_array($user->email, config('horizon.allowed_admins', [])) 
                || $user->tokenCan('admin:horizon');
        });
    }
}