关于 laravel:horizon:metrics-and-dashboards
用于提升 Laravel Horizon 队列可观测性和管理能力的 Skill。内容涵盖队列命名、Worker 设置、安全重试、指标、仪表盘及测试。
主要功能
- 01命名队列并为任务添加标签
- 02配置 Worker 并发与重试
- 03处理失败并确保幂等
- 04队列指标与健康状态
- 05派发断言和集成测试建议
适用场景
- 01按领域标识追踪任务
- 02监控积压和队列性能
- 03确保失败任务可安全重试
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jpcaparas/ superpowers-laravel --skill laravel:horizon:metrics-and-dashboards安装后在 Claude Code 中输入/laravel:horizon:metrics-and-dashboards确认已加载。
详细介绍
Horizon:指标和仪表板
通过 Horizon 让队列可观测、可操作。
命名和标签
- 使用命名队列(例如
high、default、low);有意路由任务 - 为任务添加领域标识符(用户 ID、聚合 ID)作为标签,以便追踪
工作进程和并发
- 合理设置
--max-time、--tries、--backoff - 将关键队列分离到专用监控器中
失败
- 使用
failed()方法/日志记录结构化上下文 - 幂等性——确保重试安全(唯一键、upsert、保护条件)
指标和仪表板
- 跟踪:吞吐量、运行时长分布、重试次数、失败率、处理耗时
- 添加积压和 SLA 阈值的健康指标
- 尽可能与 APM 集成
测试
- 使用
Bus::fake()断言任务派发 - 编写集成测试,以验证副作用和标签
评论
支持 Markdown