WhaTap 告警集成

通过 WhaTap 的第三方插件（3rd party plugin）中的 Webhook JSON 类型，把项目内的事件告警同步到 Flashduty On-call。事件触发时创建告警，WhaTap 发出恢复通知（Resolved notification）时关闭同一条告警。

​

在 WhaTap 中配置

---

以下界面名称为 WhaTap 英文界面。

​

推送内容

---

WhaTap 以 application/json 格式 POST 通知，所有字段均为字符串，Flashduty 直接解析，无需配置模板： 数值字段可能带有千位分隔符（例如 55,223.0），Flashduty 原样保存为文本标签，不做数值解析。

​

Alert Key

---

使用 uuid 作为 Alert Key。WhaTap 同一个事件的触发通知和恢复通知携带相同的 uuid，落在同一条 Flashduty 告警上。同一对象、同一规则的等级发生变化时（例如 Critical 恢复后又触发 Warning），WhaTap 会生成新的事件和新的 uuid，在 Flashduty 中是各自独立的告警。标题、等级、数值和时间的变化不会改变 Alert Key。 请求中缺少 uuid 时，Flashduty 会返回参数错误，因为无法可靠地把恢复通知关联到原告警。

​

状态和告警等级

---

先按 status 判断是否恢复，再读取 level：WhaTap 的恢复通知固定带 level 为 Info。 status 既不是 on 也不是 off 的请求会被拒绝，避免把无法判断状态的请求写入错误的告警生命周期。

​

常见问题

---

​

排查问题

---

• 测试通知产生了一条 Info 告警：点击 Test alert 发送的测试通知没有 uuid。Flashduty 按其全部固定内容识别（oid 为 123456789、oname 为 sample-name、标题为 [Test] Alert reception test、消息为 This is a test of WhaTap alert message、等级 Info、状态 on，指标与 okind、onode 字段为空），并产生一条独立的 Info 告警，不会自动恢复，请手动关闭。其他缺少 uuid 的请求仍会被拒绝
• WhaTap 推送失败：确认 Webhook URL 是完整的推送地址，且包含 integration_key
• 告警没有恢复：确认对应规则的 Resolved notification 已开启，且恢复通知使用同一个 Webhook 插件发送