跳转到主要内容
通过 AlertSite 的 JSON 告警(POST JSON request to web server)将监控的可用性告警和性能告警同步到 Flashduty On-call。每个 AlertSite 监控的可用性问题和性能问题各对应一条 Flashduty 告警:出错时触发,恢复正常(clear)时自动恢复。

在 Flashduty On-call

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

使用专属集成

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

使用共享集成

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

在 AlertSite 中配置

1

在 AlertSite 中创建 JSON 告警接收人

操作路径:AlertSite UXM › Alerts › Alert Recipients
新增接收人,按下表填写后保存:只有 Admin、Co-Admin 和 Power User 可以编辑接收人。默认情况下,接收人会收到所有监控的告警;如只需部分监控,请使用 AlertSite 的接收人分组(Recipient Groups)。
2

选择告警类型并开启恢复通知

操作路径:AlertSite UXM › Alerts › Alert Recipients(编辑刚创建的接收人)持续出错期间重复发送的告警会合并到同一条 Flashduty 告警。性能告警默认关闭,需在监控的 Alerts 标签页中启用并设置阈值。
3

触发一次真实告警并验证

让一个被监控的目标真正出错(例如让被监控的 URL 返回错误),等待 AlertSite 发送告警。回到 Flashduty,集成显示 最新事件时间,说明配置成功。目标恢复后,确认 Flashduty 中的告警自动恢复。在接收人设置中还可以使用 Send test notification,选择一个监控节点发送,它只能证明推送地址可达。测试告警的 notify_type 为 test,Flashduty 会为每次测试新建一条独立的 Info 告警,不会合并到真实告警中,也不会自动恢复,请手动关闭。
请使用 JSON 告警的默认模板。本集成按默认模板的字段名解析;如果为 JSON 接收人配置了自定义模板(Custom Alert Templates)或在接收人分组中指定了自定义模板,字段可能无法识别,Flashduty 会拒绝缺少 notify_type 或 device_id 的请求。

Alert Key

Flashduty 用告警类型(可用性或性能)加 device_id 计算 Alert Key。AlertSite 文档说明监控名称可能被修改,应以 device_id 作为标识;同一监控的出错和恢复告警携带相同的 device_id,因此会落在同一条告警上。 可用性告警(error / clear)和性能告警(perf_warning / perf_error / perf_clear)分开计算:性能恢复不会关闭仍在出错的可用性告警。监控名称、出错节点、出错步骤、状态码、时间和响应时间的变化都不会改变 Alert Key。请求缺少 device_id 时 Flashduty 会拒绝,因为无法关联后续恢复。

状态和告警等级

空值或其他 notify_type 会被拒绝,避免把无法判断状态的请求写入错误的告警生命周期。

告警内容

  • 标题:监控名称 device_name
  • 描述:状态说明、出错节点、URL、HTTP 状态、出错步骤、检测时间;轮换节点(rotated_locations)各节点的状态;性能告警中各节点的响应时间和阈值(locations)
  • 标签:device_id、device_type、custid、notify_type、alert_type(availability 或 performance)、status_code(AlertSite 状态码,0 表示正常)、status_text、location、location_num、http_status、check(监控名称)、resource(被监控的 URL)、source(固定为 alertsite)

排查问题

  • AlertSite 投递失败:确认 Recipient 填写的是完整推送地址,包含 https:// 和 integration_key
  • Flashduty 返回参数错误:确认使用默认模板,请求中有 notify_type 和 device_id
  • 告警没有恢复:确认接收人勾选了 Alert whenever an error clears,且监控已真正恢复正常
  • 性能告警没有收到:确认监控的性能告警已启用,且接收人的 Performance alerts 为 Enabled
  • 使用私有节点:私有节点从 2.1.2 版本起支持 JSON 告警,推送地址需能从私有节点访问
字段含义请参阅 AlertSite JSON Alerts 和 Alert Data Fields。