Apache HertzBeat 告警集成

通过 Apache HertzBeat 的 告警 → 消息通知 → 通知媒介 中的 WebHook 通知方式，把告警规则的触发（firing）和恢复（resolved）同步到 Flashduty On-call。每条告警规则在每个监控实例上对应一条 Flashduty 告警：触发时创建，恢复时自动关闭。

​

在 HertzBeat 中配置

---

​

推送内容

---

HertzBeat 以 JSON 格式 POST 默认模板，一次请求可包含多条告警（alerts），Flashduty 逐条处理： commonLabels 和 commonAnnotations 不被读取。

​

Alert Key

---

HertzBeat 的推送内容不含告警 ID。Flashduty 使用 alerts[].labels 中的 alertname、instance 和 defineid 三项组合生成 Alert Key。在 HertzBeat 1.9.0 的实际推送中，这三项在告警触发、持续告警重复通知和恢复时完全一致，因此三类通知落在同一条 Flashduty 告警上。修改等级、内容或监控名称不会改变 Alert Key。 请求中缺少 labels.alertname 时，Flashduty 返回参数错误，因为无法可靠地把恢复通知关联到原告警。instance 或 defineid 缺失时按空值参与计算。

​

状态和告警等级

---

status 为其他值或 alerts 为空的请求会被拒绝。commonLabels.severity 在默认模板中被改写成带图标的文字（如 “Critical”），不用于判断等级。

​

常见问题

---

​

排查问题

---

• Flashduty 没有收到告警：确认 URL 是完整的推送地址（含 integration_key），并确认已配置通知策略且告警命中该策略
• Flashduty 返回参数错误：确认请求体为 HertzBeat 默认模板的 JSON，status 为 firing 或 resolved，且每条告警含 labels.alertname
• 告警没有恢复：确认 HertzBeat 已发送 resolved 通知，且其 alertname、instance、defineid 与触发通知相同

HertzBeat 通知配置请参阅官方文档 Webhook 通知。