队列管理面板

Bull Board 是一个工具,允许你检查调度和内部工作流运行的问题。

BullBoard 概览

设置 BullBoard

要在自托管安装中启用 Bull Board 界面:

  1. 定义以下环境变量:

    • AP_QUEUE_UI_ENABLED:设置为 true
    • AP_QUEUE_UI_USERNAME:设置你想要的用户名
    • AP_QUEUE_UI_PASSWORD:设置你想要的密码
  2. /api/ui 路径访问界面

对于云安装,请向你的团队请求访问内部文档,以了解如何访问 BullBoard。

队列概览

我们有一个名为 workerJobs 的主队列,处理所有作业类型。每个作业都有一个 jobType 字段,指示其功能:

低优先级作业

RENEW_WEBHOOK

为具有过期 webhook 通道的 Piece(如 Google Sheets)续约 webhook。

EXECUTE_POLLING

定期检查外部服务是否有新数据。

中优先级作业

EXECUTE_FLOW

在触发器触发时运行工作流。

EXECUTE_WEBHOOK

处理启动工作流运行的传入 webhook 请求。

DELAYED_FLOW

运行计划稍后执行的工作流,如暂停的工作流或延迟执行。

高优先级作业

EXECUTE_PROPERTY

为需要在运行时加载动态属性的 Piece 加载动态属性。

EXECUTE_EXTRACT_PIECE_INFORMATION

在安装或设置 Piece 时获取有关 Piece 的信息。

EXECUTE_VALIDATION

在运行前检查工作流设置、输入或数据是否正确。

EXECUTE_TRIGGER_HOOK

在触发器触发前后运行特殊逻辑。

失败的作业是不正常的,需要立即检查以找到并修复导致问题的原因。 它们需要立即调查,因为它们代表了因未知原因而失败的执行,可能表明系统存在问题。 延迟的作业代表计划将来执行的暂停工作流、即将到来的轮询作业迭代,或因临时失败而正在重试的作业。它们表明发生了内部系统错误,作业将根据退避策略自动重试。