跳转到主要内容
通过 Cisco ThousandEyes 的 Classic Webhook（在告警规则里配置的 Webhook），将告警事件同步到 Flashduty On-call。ThousandEyes 每生成一个告警，对应一条 Flashduty 告警：告警触发时推送 ALERT_NOTIFICATION_TRIGGER，告警清除时推送 ALERT_NOTIFICATION_CLEAR 并恢复该告警。测试告警（Cloud Agent、Enterprise Agent 测试）和代理通知（Agent 离线、时钟偏差等）都支持。

在 Flashduty On-call

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

使用专属集成

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

使用共享集成

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

在 ThousandEyes 中配置

编辑告警规则和 Webhook 需要 ThousandEyes 中管理告警规则的权限。ThousandEyes for Government 实例不支持 Webhook 告警通知。
1

在 ThousandEyes 中添加 Webhook

操作路径：ThousandEyes › Manage › Alert Rules › Notifications › Webhooks › Configure Webhooks › Add New Webhook编辑告警规则和 Webhook 需要 ThousandEyes 中管理告警规则的权限。ThousandEyes for Government 实例不支持 Webhook 告警通知。展开一条告警规则，切换到 Notifications 标签页，在 Webhooks 区域点击 Configure Webhooks（已有 Webhook 时为 Edit webhooks），然后点击 Add New Webhook。点击 Test，看到 Webhook test completed successfully 即表示地址可达，然后保存该 Webhook。
请使用告警规则里的这种 Webhook（ThousandEyes 称为 Classic Webhook），不要使用 Manage → Integrations → Integrations 2.0 中的 Custom Webhook 操作。Flashduty 解析的是 Classic Webhook 的固定格式。
2

在 ThousandEyes 告警规则中选择该 Webhook

操作路径：ThousandEyes › Manage › Alert Rules › Notifications › Webhooks保存告警规则。需要推送的每条告警规则都要选择该 Webhook，代理通知（Agent Notifications）的规则也一样。
3

在 ThousandEyes 中触发告警并验证

操作路径：ThousandEyes › Manage › Alert Rules › Notifications › Webhooks › Configure Webhooks › Test
  1. 点击 Test 时 ThousandEyes 会发送 WEBHOOK_TEST 事件，Flashduty 返回成功，但不会创建告警，因此 Test 只能证明地址可达
  2. 让一条选择了该 Webhook 的告警规则触发（例如临时把阈值调低），确认 Flashduty 收到活动告警
  3. 等待告警清除（或把阈值改回），确认原告警变为已恢复

Alert Key

Flashduty 使用 ThousandEyes 的告警 ID（alert.alertId）作为 Alert Key。ThousandEyes 为每个生成的告警分配唯一的 alertId，同一个告警的触发通知和清除通知携带相同的 alertId，因此清除通知会恢复对应的 Flashduty 告警。
  • 再次触发：告警清除后再次触发时，ThousandEyes 生成新的告警和新的 alertId，Flashduty 会创建一条新告警
  • 多个代理：一个告警涉及多个代理（Agent）时仍然只是一个 alertId，在 Flashduty 中是一条告警，各代理的指标写在告警描述里
  • 每次推送的 eventId 都不同，不参与 Alert Key。规则名称、严重程度、指标值和时间的变化也不会改变 Alert Key。缺少 alert.alertId 的请求会被拒绝

状态和告警等级

状态由 eventType 决定： 告警等级由告警规则的严重程度（alert.severity）决定： 在 ThousandEyes 中用 Add New Alert Rule 新建的告警规则默认严重程度是 Info，这类告警在 Flashduty 中是 Info 等级；内置的默认告警规则（Default Alert Rules）默认是 Minor。需要更高等级时，请在 ThousandEyes 中修改告警规则的 Severity。告警恢复时保留触发时的等级。

标签

告警标题为「告警规则名称：测试名称」，代理通知为「告警规则名称：代理名称」。告警描述包含告警条件和各代理触发时的指标。

排查问题

  • Flashduty 返回参数错误：确认 URL 完整、未经编码且包含 integration_key，并且使用的是告警规则里的 Classic Webhook，而不是 Custom Webhook
  • 点击 Test 后没有告警：这是预期行为，测试事件不会创建告警；请用真实告警验证
  • 告警没有恢复：确认告警在 ThousandEyes 中已经清除。全局告警要等所有代理都不再满足条件才会清除，只要还有一个代理处于告警状态，就不会推送清除通知
  • 某条告警规则没有推送：Webhook 是按告警规则选择的，确认该规则的 Notifications 里选择了 Flashduty 的 Webhook
更多字段含义请参阅 ThousandEyes Classic Webhooks for Alert Notifications。