跳转到主要内容
SigNoz 的 Webhook 通知渠道向您填写的 URL 发送 Prometheus Alertmanager 格式的 JSON(status、alerts、fingerprint、labels、annotations、startsAt、endsAt)。Flashduty 的 Prometheus 集成 与该格式兼容,因此不需要单独的 SigNoz 集成:在 Flashduty 创建 Prometheus 集成,把它的推送地址填进 SigNoz 即可。

在 Flashduty On-call

您可通过以下两种方式获取集成推送地址,任选其一即可。集成类型都选择 Prometheus,不是 SigNoz。

使用专属集成

  1. 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增集成
  3. 选择 Prometheus,点击 保存
  4. 打开生成的集成卡片,复制 推送地址,形如 https://api.flashcat.cloud/event/push/alert/prometheus?integration_key=<集成密钥>

使用共享集成

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

在 SigNoz 中配置

1

在 SigNoz 中添加 Webhook 通知渠道

操作路径:SigNoz › Settings › Notification Channels › New Channel也可从 Alerts 页的 Notification Channels 标签进入。填写后点击 Save。
2

在告警规则中选择该渠道

操作路径:SigNoz › Alerts在 SigNoz 告警规则的阈值行(send to)中选择上一步创建的渠道,保存规则。
3

发送测试并用真实告警确认

操作路径:SigNoz › Settings › Notification Channels › New Channel › Test渠道的 Test 按钮会发送一条 status 为 firing 的测试告警,标题为 Test Alert (<渠道名称>),severity 为 critical。它会在 Flashduty 产生一条 Critical 告警,且不会有对应的恢复通知,请手动关闭该告警。该测试只能证明推送地址可达;触发与恢复是否都生效,请再用一条真实告警验证。几秒后回到 Flashduty,集成显示 最新事件时间,说明配置成功。

字段映射

SigNoz 按规则(ruleId)分组发送通知,一次通知可包含多条告警;Flashduty 逐条处理(单次最多 100 条)。规则触发通常在 1 分钟内送达。

恢复与去重

  • SigNoz 发送 status 为 resolved 的通知时,Flashduty 按相同的 fingerprint 关闭对应告警。
  • 新版 SigNoz 规则的 severity 标签取自阈值行的名称(例如阈值名 critical、warning),同时写入 threshold.name 标签。如果使用了 error 等未内置的取值,该值无法识别,按 Warning 处理;需要调整等级时使用告警处理 Pipeline。
  • 恢复通知在规则回到正常后延迟数分钟到达(实测触发后约 30 秒、恢复约 6 至 10 分钟),属正常现象。
  • 渠道的 Test 按钮会发送一条 status 为 firing 的测试告警,标题为 Test Alert (<渠道名称>),severity 为 critical。它会在 Flashduty 产生一条 Critical 告警,且不会有对应的恢复通知,请手动关闭该告警。

排查问题

  • Flashduty 返回 Invalid parameters:推送地址不完整,缺少 integration_key,或集成类型不是 Prometheus
  • 告警没有恢复:确认 SigNoz 渠道的 Send resolved alerts 已开启,且恢复通知的 fingerprint 与触发时一致
  • 恢复通知延迟:SigNoz 在规则回到正常后延迟数分钟才发送恢复通知,这是 SigNoz 的默认行为