跳转到主要内容
通过 IBM SevOne NPM 8.x 的 Webhook Definition Manager，把策略（Policy）告警的触发和清除同步到 Flashduty On-call。SevOne 的 Webhook 请求体由您在模板里自己编写，本页给出需要粘贴的 JSON 模板，Flashduty 按该模板解析。每条 SevOne 告警对应一条 Flashduty 告警：策略触发时创建，再次触发合并到同一条告警，策略清除时关闭。

在 Flashduty On-call

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

使用专属集成

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

使用共享集成

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

在 SevOne NPM 中配置

需要创建两个 Webhook Definition：一个在告警触发时发送，一个在告警清除时发送。
1

在 SevOne NMS 中创建触发 Webhook

操作路径：SevOne NMS › Events › Configuration › Webhook Definition Manager
点击 Test Definition 检查请求能否发出，然后点击 Save。Test Definition 发送的请求体没有文档说明，通常不含有效的 alert_id 和 event，只能证明网络可达，不能证明告警能创建；请以真实告警验证（见最后一步）。
2

在 SevOne NMS 中创建清除 Webhook

操作路径：SevOne NMS › Events › Configuration › Webhook Definition Manager按上一步再创建一个 Definition，字段与上一步相同，仅以下两项不同：
3

把 Webhook 分配给策略

操作路径：SevOne NMS › Events › Configuration › Policy Browser › Assign Webhooks清除 Webhook 必须分配给同一策略，否则 Flashduty 告警不会自动恢复。
4

触发真实告警并确认

操作路径：SevOne NMS › Events › Alerts让一条策略真正触发，确认 Flashduty 收到活动告警；再让它清除（条件恢复，或在 Events → Alerts 手动确认），确认原告警恢复。回到 Flashduty，集成显示 最新事件时间，说明配置成功。
  • Content Type 必须选 application/json。SevOne 会按 Content Type 对变量做转义，选其他类型可能生成无法解析的 JSON。
  • 触发和清除的模板中 event 取值必须分别是 trigger 和 clear，其他值会被 Flashduty 拒绝。
  • 推送地址包含 integration_key，不需要额外的认证头。

推送内容

模板中的每个字段都是一个 SevOne 变量的替换结果（变量说明见 IBM 文档 Webhook Definition Manager）： SevOne 对不支持的变量输出 n/a（例如流量策略的 $pluginName），Flashduty 会忽略 n/a。

Alert Key

Flashduty 使用 alert_id（$alertId，IBM 文档描述为 “The id of the triggered alert”）作为 Alert Key。同一条 SevOne 告警的多次触发和清除携带相同的 alert_id，会落在同一条 Flashduty 告警上；修改策略名称、等级或消息不会改变 Alert Key。 请求中 alert_id 为空、为 n/a 或仍是未替换的 $alertId 时，Flashduty 返回参数错误。

状态和告警等级

$alertState 是策略的等级。清除事件沿用该告警的等级，状态变为恢复。

常见问题

IBM 文档只说明 Test Definition 会返回状态码、响应头和响应体，没有给出测试请求体的格式。如果测试请求带有有效的 alert_id 和 event，会像真实通知一样创建或关闭告警；不带时 Flashduty 返回参数错误。测试产生的告警请手动关闭。
可以接收告警，但 Flashduty 告警不会自动恢复。建议在集成或协作空间中开启超时自动关闭，或补配清除 Webhook。
不会。同一条 SevOne 告警每次触发的 alert_id 相同，合并到同一条 Flashduty 告警。
本页模板按 Policy 类型设计。Trap 类型的 Definition 使用另一组变量，不在本集成范围内。

排查问题

  • SevOne 推送失败：确认 Destination URL 是完整的推送地址；自签名 TLS 证书需要勾选 Allow insecure webhook connection，且证书需使用 SAN 而不是仅 Common Name
  • Flashduty 返回参数错误：确认 Content Type 为 application/json，event 为 trigger 或 clear，且 alert_id 有值
  • 告警没有恢复：确认清除 Webhook 已分配给同一策略并勾选 Clear