mcuadros/ofelia 没有 Webhook 功能,无法使用本集成。
在 Flashduty On-call
您可通过以下两种方式获取集成推送地址,任选其一即可。使用专属集成
- 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
- 选择 配置 → 集成数据 → 专属集成,点击 新增集成
- 选择 Ofelia,点击 保存
- 打开生成的集成卡片,复制 推送地址
使用共享集成
- 进入 Flashduty 控制台,选择 集成中心 → 告警事件
- 选择 Ofelia,填写集成名称
- 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
- 点击 保存,复制生成的 推送地址
在 Ofelia 中配置
Ofelia 通过 Docker API 工作,即使只运行job-local 任务也是如此,所以运行 Ofelia 的容器必须挂载 /var/run/docker.sock;缺少它时,Ofelia 启动即退出。使用 docker run 时加 -v /var/run/docker.sock:/var/run/docker.sock:ro。
1
在 Ofelia 中定义 Webhook
- INI 配置文件
- Docker 标签
操作路径:如果您在
/etc/ofelia/config.ini › [webhook "flashduty"]/etc/ofelia/config.ini 是 Ofelia 的默认配置文件(官方镜像也读取该路径);如果用 --config 指定了其他文件,请改在该文件中配置。[global] 中设置了 webhook-allowed-hosts,需要把 api.flashcat.cloud 加入列表。2
在 Ofelia 中把 Webhook 挂到任务上
操作路径:
/etc/ofelia/config.ini › [job-exec "backup-database"] › webhooks在需要监控的任务段落中,用 webhooks 填写上一步定义的 Webhook 名称(多个名称用逗号分隔):- Docker 标签写法:在任务所属容器上设置
ofelia.job-exec.backup-database.webhooks: "flashduty" - 让所有任务都发送:在
[global]中设置webhook-webhooks = flashduty(标签为ofelia.webhook-webhooks)
3
在 Ofelia 中固定主机名
操作路径:
docker-compose.yml › services.ofelia › hostname(docker run 使用 --hostname)Flashduty 用主机名区分不同机器上的同名任务。Ofelia 运行在容器里时,主机名默认是容器 ID,重建容器后会变,已打开的告警就无法被新的成功执行恢复。请设置一个固定值,例如 hostname: ofelia-prod-01。4
验证生命周期
操作路径:Ofelia 所在主机上被监控任务的
commandOfelia 没有测试发送功能,只能用真实执行验证:- 让一个任务真正失败一次(例如临时把
command改成false),确认 Flashduty 收到 Critical 告警,检查清单中的「收到第一个事件」变绿 - 把命令改回去,等下一次执行成功,确认原告警恢复
Alert Key
Flashduty 用host.hostname 与 job.name 组合出 Alert Key,两者之间用不可见分隔符连接后取 MD5。在我们的真实验证中,同一任务的失败与成功执行携带相同的主机名和任务名;而 execution.id 每次执行都不同,因此只作为排查参考,不参与 Alert Key。
- 同一台主机上的两个不同任务是两条告警;同名任务在两台主机上也是两条告警
- 任务的命令、调度表达式、耗时和错误内容的变化不会改变 Alert Key
- 同一个 Ofelia 里不同类型的任务(
job-exec、job-run等)如果重名,会被当成同一条告警,请保持任务名唯一 job.name缺失时 Flashduty 返回 400,避免把失败和恢复写进错误的告警
状态和告警等级
任务因
no-overlap 被跳过时,上一次执行还没有结束,任务的健康状态没有变化,所以跳过的执行不会影响已打开的告警。
任务失败后重复失败,会更新同一条告警,不会新建。若同一任务长期不再执行(任务被删除或停用),告警不会自动恢复,需要手动关闭,或开启协作空间的超时自动关闭。
告警内容
- 标题:
Ofelia job "<任务名>" failed,恢复时为Ofelia job "<任务名>" succeeded - 描述:
execution.error,换行后追加execution.stderr - 标签:
check、job_name、job_type、job_schedule、execution_status、duration、resource/host(主机名)、ofelia_version、source=ofelia
排查问题
- Flashduty 没有收到任何请求:确认任务上写了
webhooks = flashduty,查看 Ofelia 日志里的Webhook error;Ofelia 对失败的 Webhook 默认重试 3 次,间隔 5 秒 - 只收到失败,没有恢复:确认 Webhook 设置了
trigger = always,并确认主机名在两次执行之间没有变化 - Flashduty 返回参数错误:确认没有给该 Webhook 设置其他
preset,请求体必须是json-post预设的 JSON - Docker 标签不生效:Webhook 标签只在带有
ofelia.service: "true"的容器上处理;INI 与标签同名时以 INI 为准 - 提示 host not in allowed hosts list:把
api.flashcat.cloud加入[global] webhook-allowed-hosts