在 Flashduty On-call
您可通过以下两种方式获取集成推送地址,任选其一即可。
使用专属集成
- 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
- 选择 配置 → 集成数据 → 专属集成,点击 新增一个集成
- 选择 OpenStatus,点击 保存
- 打开生成的集成卡片,复制 推送地址
使用共享集成
- 进入 Flashduty 控制台,选择 集成中心 → 告警事件
- 选择 OpenStatus,填写集成名称
- 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
- 点击 保存,复制生成的 推送地址
在 OpenStatus 中配置
1
创建 Webhook 通知渠道
- 登录 OpenStatus 控制台,在左侧栏打开 Notifications
- 在 Create a new notifier 下点击 Webhook
- Name 可填写
Flashduty - 将 Flashduty 集成的完整推送地址粘贴到 Webhook URL
- Request Headers 留空即可,OpenStatus 固定以
application/json发送 - 在 Monitors 中勾选需要告警的监控,点击 Submit。也可以之后在监控的 Settings → Notifications 中关联该通知渠道
2
发送测试
在同一个表单中点击 Send Test。测试消息使用固定的示例监控(
monitor.id 为 1、名称为 test、地址为 http://openstat.us),Flashduty 返回成功,不会生成告警。3
验证告警生命周期
- 新建一个监控,URL 填写
https://openstat.us/500(始终返回 500),并关联上一步的通知渠道。OpenStatus 保存前会先检测该 URL,因返回 500 弹出 Still save?,点击 Save 即可 - 等待至少一半探测区域报错后,确认 Flashduty 收到 Critical 告警
- 将监控 URL 改回正常地址,等待探测区域恢复,确认原告警恢复
- 验证完成后删除该测试监控
Alert Key
Flashduty 用
monitor.id(OpenStatus 监控 ID)计算 Alert Key。同一个监控的 error、degraded 和 recovered 通知携带相同的 monitor.id,因此会落在同一条告警上:监控从报错变为降级时,原告警更新为 Warning,监控恢复后告警关闭。
监控名称、URL、状态码、响应时间、错误信息和检查时间的变化都不会改变 Alert Key。请求缺少 monitor.id 时 Flashduty 会拒绝,因为无法关联后续恢复。
monitor.id 在一个 OpenStatus 实例内唯一。如果您同时使用 OpenStatus 云服务和自托管实例,请为每个实例分别创建 Flashduty 集成,避免不同实例的监控 ID 重复。状态和告警等级
空值或其他
status 会被拒绝,避免把无法判断状态的请求写入错误的告警生命周期。
告警内容
- 标题:监控名称
monitor.name,为空时使用OpenStatus monitor <monitor.id> - 描述:
errorMessage - 标签:
check(监控名称)、resource(监控地址monitor.url)、source(固定为openstatus)、monitor_id、status、status_code、latency_ms
排查问题
- Send Test 失败:确认 Webhook URL 是完整推送地址且包含
integration_key - Flashduty 返回参数错误:确认请求中有
monitor.id和status;本集成只接收 OpenStatus Webhook 渠道的 JSON 格式 - 没有收到告警:确认该通知渠道的 Monitors 中勾选了对应监控,且监控已在一半以上的探测区域报错
- 告警没有恢复:确认监控已在一半以上的探测区域恢复,且恢复时该监控仍关联该通知渠道