check.down)、恢复(check.up)、SSL 证书无效或即将到期、性能下降(check.performance_drop)通知同步到 Flashduty On-call。宕机与恢复、证书无效与恢复、证书即将到期与续期都会落在同一条告警上并自动关闭;性能下降是一次性事件,不会恢复。
在 Flashduty On-call
您可通过以下两种方式获取集成推送地址,任选其一即可。
使用专属集成
- 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
- 选择 配置 → 集成数据 → 专属集成,点击 新增一个集成
- 选择 updown.io,点击 保存
- 打开生成的集成卡片,复制 推送地址
使用共享集成
- 进入 Flashduty 控制台,选择 集成中心 → 告警事件
- 选择 updown.io,填写集成名称
- 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
- 点击 保存,复制生成的 推送地址
在 updown.io 中配置
1
添加 Webhook 地址
- 登录 updown.io,进入 Settings 页面,找到 Webhook 地址列表
- 将 Flashduty 集成的完整推送地址(含
integration_key)添加到列表中并保存 - 使用 Send a test webhook 链接发送一次测试 Webhook,确认 Flashduty 返回成功(见下方常见问题)
2
验证生命周期
让一个监控真正宕机(例如新建一个指向不可访问地址的监控),确认 Flashduty 收到活动告警;再恢复监控目标,确认原告警恢复。
推送内容
updown.io 以 JSON 数组 POST 事件(同一请求可能包含多个事件),Flashduty 直接解析,无需配置模板:
updown.io 之后新增的事件类型会被忽略并返回成功,不会创建告警。
Alert Key
- 宕机和恢复:使用
check.token作为 Alert Key。同一个监控的check.down与check.up携带相同的check.token,落在同一条告警上;不同监控生成不同的告警。修改监控别名、状态码或错误信息不会改变 Alert Key。 - 证书无效:
check.token加:ssl_invalid,由check.ssl_valid恢复。 - 证书即将到期:
check.token加:ssl_expiration,由check.ssl_renewed恢复;1、7、14、30 天前的多次提醒合并到同一条告警。 - 性能下降:
check.token加:performance_drop,同一监控重复的通知合并到同一条告警。
check.token 时无法可靠地把恢复通知关联到原告警,Flashduty 会跳过该事件,同一请求中的其他有效事件照常处理;请求里没有任何有效事件时才返回参数错误。
状态和告警等级
updown.io 的通知不区分告警等级。
一次性告警需要开启超时自动关闭
性能下降(
check.performance_drop)没有对应的关闭通知,这类告警不会自动恢复。请开启协作空间的超时自动关闭,建议设置为 6 小时;也可以手动关闭。
常见问题
测试 Webhook 会创建告警吗?
测试 Webhook 会创建告警吗?
会创建一条独立的 Info 告警。updown.io 设置页的「Send a test notification」可选择接收方和事件类型,发出的是一个固定的示例监控(
check.token 为 xyz0、地址为 https://updown.io)的事件。Flashduty 识别这个固定示例后返回成功,并为每次点击创建一条新的 Info 告警,不会与真实监控的告警合并,也不会被后续通知恢复,请验证后手动关闭。重复的宕机通知会产生多条告警吗?
重复的宕机通知会产生多条告警吗?
不会。同一个监控的通知携带相同的
check.token,会合并到同一条告警中。排查问题
- updown.io 提示投递失败:确认 Webhook 地址是完整的推送地址,且包含
integration_key - Flashduty 返回参数错误:确认请求体是 updown.io 的 JSON 数组,且事件的
check.token非空(缺少check.token的事件会被跳过,全部无效时才返回错误) - 告警没有恢复:确认恢复通知使用同一个 Webhook 地址;恢复通知与宕机通知的
check.token必须相同