Agent Skills
返回列表
💻

Bull Board 队列排障面板

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/inspect-bullmq-agent-job-queues-with-bull-board。

技能介绍

要解决的问题

BullMQ / Bull 作业队列跑在 Redis 上,作业失败、卡死或堆积时,常见做法是翻日志、猜 jobId、写一次性脚本调 queue.retryJob。过程不可视、步骤重复且容易误操作。运维真正需要的是一块能直接看到队列状态、并对单个作业执行重试、暂停与清理的面板,而不是更多的命令行工具。

技能如何工作

该技能将 Bull Board 挂载到现有队列上:

  • 接入现有队列:面向 Redis 的 Bull / BullMQ 队列无需迁移,直接读取队列状态。
  • 选择框架适配器:提供 Express、Fastify、Koa、Hapi、NestJS、Hono、H3、Elysia、Bun 等适配器,把 API/UI 挂到已有 HTTP 服务上。
  • 受保护的路由:挂载后用应用自身的认证与授权机制保护该路由,再暴露给运维人员。
  • 作业操作:支持检查、重试、暂停、清理与调试后台代理作业。

适用边界与注意点

  • 必须有 Bull / BullMQ 队列和 Redis,纯内存队列不适用。
  • 仪表盘路由暴露到公网前必须先接入应用鉴权,避免无保护的管理界面留在生产环境。
  • 该技能不改变队列逻辑,只提供可视化操作入口;高并发下批量操作仍需评估对 Redis 的压力。
  • 适配器需与服务框架版本匹配,接入前确认框架在支持列表内。

使用场景

  • 当 BullMQ 后台代理作业因外部 API 超时失败时,运维工程师需要通过面板查看失败原因并批量重试这些卡住的作业。
  • 节假日促销活动导致 Redis 队列中的邮件发送作业严重堆积,后端开发者需在仪表盘上暂停新任务并清理过期的失败作业。
  • 后台数据分析代理任务突然停摆,研发人员需要接入 Express 适配器挂载仪表盘,直接检查队列状态并定位阻塞的特定任务。

适合人员

  • 后端开发工程师:需要在不重启服务的情况下,通过可视化面板快速定位并修复生产环境中失败的 BullMQ 队列作业。
  • 运维工程师:负责保障后台代理任务的高可用性,需要借助受保护的仪表盘路由来监控队列健康度并执行紧急清理操作。
  • SRE 工程师:关注系统稳定性,希望在 NestJS 或 Fastify 等框架中无缝集成队列管理界面,以缩短线上任务故障的恢复时间。