laravel Horizon如何监控和管理队列_Laravel Horizon队列监控与管理教程-Laravel-PHP中文网

laravel Horizon如何监控和管理队列_Laravel Horizon队列监控与管理教程

裘德小鎮的故事

发布： 2025-09-30 11:01:01

原创

372人浏览过

Laravel Horizon提供可视化队列管理，通过安装配置后启用Redis队列监控，支持实时查看任务状态、失败日志与性能指标，可设置优先级、进程策略及访问权限，并结合优化建议提升系统稳定性。

laravel horizon如何监控和管理队列_laravel horizon队列监控与管理教程

Laravel Horizon 提供了一套优雅的仪表盘和代码驱动的方式来监控和管理 Laravel 的 Redis 队列系统。它不仅能实时展示队列的运行状态，还能帮助你优化任务处理效率、排查失败任务以及设置合理的进程调度策略。

安装与配置 Horizon

要在项目中启用 Horizon，先通过 Composer 安装：

composer require laravel/horizon

安装完成后，发布 Horizon 的资源文件：

php artisan horizon:install

这会生成配置文件 config/horizon.php，你可以在此定义工作进程数量、队列优先级、平衡策略等。

确保你的 .env 文件中的 QUEUE_CONNECTION 设置为 redis，并正确配置 Redis 连接信息。

启动 Horizon 服务

运行以下命令启动 Horizon 监听器：

php artisan horizon

该命令会根据配置启动多个工作进程来处理队列任务。Horizon 自动使用 Supervisor 推荐的守护进程模式运行，适合生产环境。

若需重启 Horizon（例如部署更新后），可执行：

php artisan horizon:terminate

Horizon 会在下次请求时自动重启，保证平滑过渡。

访问 Horizon 仪表盘

默认情况下，Horizon 的 Web 界面位于 /horizon 路径下。只有在本地或配置允许的用户才能访问，安全性由内置中间件控制。

你可以在 app/Providers/HorizonServiceProvider.php 中修改授权逻辑，例如限制仅管理员访问：

乾坤圈新媒体矩阵管家

新媒体账号、门店矩阵智能管理系统

查看详情

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

监控队列状态与性能指标

Horizon 仪表盘展示了丰富的实时数据：

当前活跃任务数：显示各队列中正在处理的任务数量
等待任务数：反映积压情况，有助于判断是否需要增加 worker
最近吞吐量：每分钟完成的任务数，用于评估系统负载能力
处理时间统计：最长、最短及平均执行时间
失败任务日志：自动记录异常任务，支持重试或删除

这些数据帮助你快速识别瓶颈，比如某个队列长时间积压可能意味着任务处理过慢或 worker 不足。

配置队列优先级与进程策略

在 config/horizon.php 中可以精细控制每个环境下的进程行为。例如：

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

上述配置表示 supervisor 将从 high 队列优先取任务，使用自动负载均衡分配 10 个进程处理三个队列，每个任务最多尝试 3 次。