Skip to main content
通过 updown.io 的 Webhook,把监控(Check)的宕机(check.down)、恢复(check.up)、SSL 证书无效或即将到期、性能下降(check.performance_drop)通知同步到 Flashduty On-call。宕机与恢复、证书无效与恢复、证书即将到期与续期都会落在同一条告警上并自动关闭;性能下降是一次性事件,不会恢复。

在 Flashduty On-call


您可通过以下两种方式获取集成推送地址,任选其一即可。

使用专属集成

  1. 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增一个集成
  3. 选择 updown.io,点击 保存
  4. 打开生成的集成卡片,复制 推送地址

使用共享集成

  1. 进入 Flashduty 控制台,选择 集成中心 → 告警事件
  2. 选择 updown.io,填写集成名称
  3. 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
  4. 点击 保存,复制生成的 推送地址

在 updown.io 中配置


1

添加 Webhook 地址

  1. 登录 updown.io,进入 Settings 页面,找到 Webhook 地址列表
  2. 将 Flashduty 集成的完整推送地址(含 integration_key)添加到列表中并保存
  3. 使用 Send a test webhook 链接发送一次测试 Webhook,确认 Flashduty 返回成功(见下方常见问题)
updown.io 对该地址的要求只有返回 2xx;非 2xx 会被重试最多 25 次,连续失败 1000 次后地址会被自动移除。
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,同一监控重复的通知合并到同一条告警。
各类事件的 Alert Key 互不相同,因此监控恢复不会关闭证书或性能告警。事件缺少 check.token 时无法可靠地把恢复通知关联到原告警,Flashduty 会跳过该事件,同一请求中的其他有效事件照常处理;请求里没有任何有效事件时才返回参数错误。

状态和告警等级


updown.io 的通知不区分告警等级。

一次性告警需要开启超时自动关闭


性能下降(check.performance_drop)没有对应的关闭通知,这类告警不会自动恢复。请开启协作空间的超时自动关闭,建议设置为 6 小时;也可以手动关闭。

常见问题


会创建一条独立的 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 必须相同
字段说明请参阅 updown.io 官方文档 API - Webhooks。