Laravel Horizon 必須使用 Redis 作為隊(duì)列驅(qū)動(dòng)，安裝后通過(guò) php artisan horizon:install 配置，設(shè)置 QUEUE_CONNECTION=redis，發(fā)布資源后啟動(dòng) php artisan horizon，通過(guò) /horizon 訪問(wèn)儀表板，1. 在 HorizonServiceProvider 中使用 Gate 控制訪問(wèn)權(quán)限，2. 通過(guò)“Recent Jobs”查看最近任務(wù)，3. 在“Failed Jobs”重試或刪除失敗任務(wù)，4. 使用“Metrics”分析處理速率和瓶頸，5. 在“Monitoring”監(jiān)控特定任務(wù)類，6. 通過(guò)“Workers”管理 worker 狀態(tài)，7. 在 config/horizon.php 中配置多 supervisor 和隊(duì)列平衡策略，8. 設(shè)置 Slack 或郵件通知以接收失敗或性能警報(bào)，9. 為任務(wù)添加標(biāo)簽以便追蹤，10. 定期使用 php artisan horizon:terminate 重啟 Horizon，確保 Redis 內(nèi)存管理得當(dāng)，從而實(shí)現(xiàn)全面的隊(duì)列監(jiān)控。

Laravel Horizon is a powerful dashboard and configuration tool for managing and monitoring Laravel’s Redis-based queues. It gives you deep insights into job throughput, runtime, failed jobs, and worker performance—all through a clean, real-time UI. Here’s how to set it up and use it effectively for monitoring your queues.

? Install and Configure Horizon

First, make sure you’re using Redis as your queue driver since Horizon only works with Redis.

1. Install Horizon via Composer:

   

   composer require laravel/horizon

2. Publish the Horizon configuration and assets:

   php artisan horizon:install
   php artisan vendor:publish --provider="Laravel\Horizon\HorizonServiceProvider"

   This creates a config/horizon.php file.

   

3. Set your queue driver to redis in .env:

   QUEUE_CONNECTION=redis

4. Ensure Redis is configured properly in config/database.php.

?? Start Horizon and Access the Dashboard

1. Start the Horizon process:

   php artisan horizon

   This starts the Horizon queue worker (replace php artisan queue:work in your production processes).

2. Access the dashboard: By default, Horizon is available at:

   http://your-app.test/horizon

   ? Access is restricted. You can customize who can view the dashboard in app/Providers/HorizonServiceProvider.php using gate logic.

   Example (allow only admins):

   Gate::define('viewHorizon', function ($user) {
       return in_array($user->email, [
           'admin@yoursite.com'
       ]);
   });

? Monitor Queues Using the Horizon Dashboard

Once logged in, you’ll see several key tabs:

1. Recent Jobs

• Shows jobs processed in the last 5 minutes.
• Includes job name, runtime, status (completed/failed), and timestamp.
• Helps spot slow or failing jobs quickly.

2. Failed Jobs

• Lists all failed jobs with full exception trace.
• You can:
  • Retry individual jobs.
  • Delete them.
  • Automatically notify via email or Slack (if configured).

3. Metrics

• Visual graphs showing:
  • Jobs processed per minute.
  • Job run time averages.
  • Queue wait times.
• Great for identifying bottlenecks over time.

4. Monitoring

• Allows you to "watch" specific job classes.
• Shows real-time stats: total processed, failed, runtime.
• Useful for high-priority jobs like email sends or webhooks.

5. Workers

• Shows active Horizon workers.
• Displays CPU, memory, and job counts.
• You can pause/resume queue processing from here.

6. Master

• View all Horizon processes (supervisors and workers).
• Useful for debugging scaling or deployment issues.

?? Configure Horizon for Better Monitoring

In config/horizon.php, you can define supervisor and queue behavior:

'environments' => [
    'production' => [
        'supervisor-1' => [
            'connection' => 'redis',
            'queue' => ['default'],
            'balance' => 'auto',
            'processes' => 10,
            'tries' => 3,
        ],
    ],
],

• Use multiple supervisors for different queues (e.g., high, default, low).
• Set balance to auto, simple, or false depending on load.
• Horizon automatically adjusts process count based on queue activity when using auto.

? Set Up Notifications

Horizon can alert you when:

• A job fails.
• A long-running job exceeds a threshold.
• Horizon is down.

Configure notifications in config/horizon.php under notifications:

'notifications' => [
    'slack' => [
        'webhook_url' => env('SLACK_WEBHOOK_URL'),
    ],
    'email' => [
        'address' => 'admin@yoursite.com',
    ],
],

Enable specific alerts:

'failed' => true,
'metrics' => true,
'trim' => true,

Make sure your app has the Notifiable user and proper mail/slack drivers set up.

? Tips for Effective Monitoring

• Tag your jobs so they appear clearly in Horizon:

  public function tags()
  {
      return ['mail', 'user:' . $this->user->id];
  }

• Use different queues for different priorities and monitor them separately.

• Schedule regular Horizon restarts in production (e.g., after deployments) using:

  php artisan horizon:terminate

  This gracefully restarts Horizon.

• Monitor Redis memory usage — Horizon stores metrics, so large apps may need Redis cleanup strategies.

---

Horizon makes Laravel queue monitoring visual, actionable, and reliable. Once set up, it’s like having a control panel for your background jobs — you’ll catch issues before users do.

Basically: install, configure Redis, run horizon, secure the dashboard, and start watching your queues.

以上是如何使用Laravel Horizon監(jiān)視隊(duì)列？的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！