Laravel Horizon提供可视化队列管理，通过安装配置后启用Redis队列监控，支持实时查看任务状态、失败日志与性能指标，可设置优先级、进程策略及访问权限，并结合优化建议提升系统稳定性。
Laravel Horizon 提供了一套优雅的仪表盘和代码驱动的方式来监控和管理 Laravel 的 Redis 队列系统。它不仅能实时展示队列的运行状态，还能帮助你优化任务处理效率、排查失败任务以及设置合理的进程调度策略。
安装与配置 Horizon
要在项目中启用 Horizon，先通过 Composer 安装：
%ignore_a_1% 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 次。
处理失败队列任务
当任务抛出异常且超过最大重试次数时，会被记录到失败任务列表中。你可以在 Horizon 界面的 “Failed Jobs” 标签页查看详细错误堆栈。
操作选项包括：
手动点击“Retry”重新推入队列查看具体异常信息定位问题代码永久删除不再需要处理的任务
同时可监听失败事件，发送通知或写入日志：
php artisan horizon:failed-table
然后创建自定义处理器监听 JobFailed 事件。
优化建议与最佳实践
为了充分发挥 Horizon 的作用，注意以下几点：
定期清理已完成的日志数据，避免 Redis 内存过高为关键任务设置独立队列并赋予更高优先级合理设置 worker 数量，避免服务器资源耗尽结合 Laravel Telescope（开发环境）与 Horizon（生产环境）全面掌握应用行为使用 heartbeat 机制检测 worker 是否正常运行
基本上就这些。Laravel Horizon 让队列管理变得可视化且可控，减少运维复杂度，提升系统稳定性。只要配置得当，就能轻松应对高并发任务场景。不复杂但容易忽略细节，建议上线前充分测试队列流程。
以上就是laravel Horizon如何监控和管理队列_Laravel Horizon队列监控与管理教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/195402.html
微信扫一扫 
支付宝扫一扫 
