Skip to main content
通过 IBM Instana 的 Generic webhook 告警通道,将 Instana 的问题(Issue)、事件(Incident)和变更同步到 Flashduty On-call。Instana 中的每个问题或事件对应一条 Flashduty 告警:问题打开时触发,问题关闭时自动恢复。

在 Flashduty On-call


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

使用专属集成

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

使用共享集成

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

在 Instana 中配置


需要 Instana 中配置告警通道和告警的权限。先创建指向 Flashduty 的告警通道,再在告警配置中选择这个通道。
1

创建 Generic webhook 告警通道

  1. 在 Instana 中点击 Settings → Global settings,在 Events & alerts 下选择 Alert channels。部分版本的入口是 Settings → Team settings → Alert channels
  2. 点击 Add alert channel,在弹窗中选择 Generic webhook,再点击弹窗底部的 Add alert channel
  3. 填写 Name,例如 Flashduty
  4. 将 Flashduty 集成的完整推送地址粘贴到 Webhook URLs,地址中需包含 integration_key
  5. HTTP request headers 和 OAuth 保持为空,Flashduty 通过地址中的 integration_key 鉴权
  6. 点击 Test channel 检查 Instana 能否访问 Flashduty,Instana 显示 Test Successful 即连通。测试通知不会在 Flashduty 中生成告警
  7. 点击 Create
2

在告警配置中选择通道

  1. 点击 Settings → Alerts → New alert,填写告警名称
  2. 在 Events 下拉框中选择 Alert on event type(s),再打开需要推送的事件类型:
变更和上下线事件数量较多且不会自动恢复,一般只打开 Incidents、Critical issues 和 Warning issues。
  1. 在 Scope 的 Apply on(必填)中选择范围:应用视图(Application perspective)、Dynamic Focus 查询(Selected entities only),或全部实体(All available entities)
  2. 在 Alerting 中点击 Add alert channels,选择上一步创建的通道
  3. (可选)在 Custom payloads 中添加键值对,它们会作为标签带到 Flashduty
  4. 点击 Create 保存
应用、网站、合成监控等 Smart Alert 在各自的告警配置中选择告警通道,同样选择上一步创建的通道即可。
3

验证

  1. 触发一个 Instana 问题,确认 Flashduty 收到活动告警。可以在装有 Instana agent 的主机上通过 agent 的 Event SDK 发送一个带持续时间的严重事件:
  1. 等问题在 Instana 中关闭(上例为 5 分钟后),确认原告警恢复
刚保存告警配置后立即产生的问题可能不会推送,保存后等几分钟再触发。

Alert Key


Flashduty 使用 Instana 的问题 ID(issue.id)作为 Alert Key。同一个问题或事件打开和关闭时推送的 issue.id 相同,因此关闭通知会恢复打开时创建的告警。 问题标题、严重程度、开始时间、标签的变化不会改变 Alert Key。缺少 issue.id 的请求会被拒绝。

状态和告警等级


Flashduty 按问题的严重程度(issue.severity)确定告警等级: 状态由 issue.state 决定: 其他状态值会被拒绝并返回参数错误。

标签


Instana 在不适用的字段中填写 not available,这些字段不会生成标签。

排查问题


  • Test channel 提示域名不被允许:Instana SaaS 可能限制告警通道的外发域名,请联系 IBM Instana 支持将 Flashduty 推送地址的域名加入允许列表
  • Flashduty 返回参数错误:确认 URL 完整且包含 integration_key
  • 告警没有恢复:确认推送的是带状态的问题或事件;变更和上下线事件不会自动恢复
  • 真实问题没有推送:检查告警配置的事件类型和 Scope,确认告警已关联该通道
更多字段含义请参阅 Instana Webhook 告警通道。