IBM Instana 告警集成

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

在 Instana 中配置

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

在 Instana 中创建 Generic webhook 告警通道

操作路径：Instana › Settings › Global settings › Events & alerts › Alert channels › Add alert channel（部分版本为 Settings › Team settings › Alert channels）在弹窗中选择 Generic webhook，再点击弹窗底部的 Add alert channel，填写：

字段	填写
Name（必填）	自定义名称，例如 `Flashduty`
Webhook URLs（必填）	`{integration_url}`，地址中需包含 `integration_key`
HTTP request headers（可选）	留空，Flashduty 通过地址中的 `integration_key` 鉴权
OAuth（可选）	保持为空

填写后点击 Test channel 检查 Instana 能否访问 Flashduty，Instana 显示 Test Successful 即连通。该按钮只证明连通性：测试通知不会在 Flashduty 中生成告警。确认后点击 Create。

在 Instana 告警配置中选择该通道

操作路径：Instana › Settings › Alerts › New alert需要 Instana 中配置告警通道和告警的权限。

填写告警名称

在 Events 下拉框中选择 Alert on event type(s)，再打开需要推送的事件类型：

Instana 事件类型	推送内容	在 Flashduty 中的效果
Incidents	`type` 为 `incident`，带 `OPEN` / `CLOSED` 状态	打开时触发，关闭时恢复
Critical issues / Warning issues	`type` 为 `issue`，带 `OPEN` / `CLOSED` 状态	打开时触发，关闭时恢复
Monitoring issues	`type` 为 `monitoringIssue`，带 `OPEN` / `CLOSED` 状态	打开时触发，关闭时恢复
Changes	`type` 为 `change`，没有状态	每次推送生成一条 Info 告警，不会自动恢复
Online / Offline	`type` 为 `presence`，没有状态	每次推送生成一条 Info 告警，不会自动恢复

变更和上下线事件数量较多且不会自动恢复，一般只打开 Incidents、Critical issues 和 Warning issues。

在 Scope 的 Apply on（必填）中选择范围：应用视图（Application perspective）、Dynamic Focus 查询（Selected entities only），或全部实体（All available entities）
在 Alerting 中点击 Add alert channels，选择上一步创建的通道
（可选）在 Custom payloads 中添加键值对，它们会作为标签带到 Flashduty
点击 Create 保存

应用、网站、合成监控等 Smart Alert 在各自的告警配置中选择告警通道，同样选择上一步创建的通道即可。

触发一个 Instana 问题并确认

操作路径：装有 Instana agent 的主机的终端

触发一个 Instana 问题，确认 Flashduty 收到活动告警。可以通过 agent 的 Event SDK 发送一个带持续时间的严重事件：

curl -X POST http://localhost:42699/com.instana.plugin.generic.event \
  -H 'Content-Type: application/json' \
  -d '{"title":"Flashduty test","text":"Flashduty test","severity":10,"duration":300000}'

等问题在 Instana 中关闭（上例为 5 分钟后），确认原告警恢复

刚保存告警配置后立即产生的问题可能不会推送，保存后等几分钟再触发。

Alert Key

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

状态和告警等级

Flashduty 按问题的严重程度（issue.severity）确定告警等级：

Instana 严重程度	Flashduty 等级
`10`（Critical）	Critical
`5`（Warning）	Warning
`-1`、其他或为空（变更、上下线事件）	Info

状态由 issue.state 决定：

`issue.state`	状态
`OPEN`	触发
`CLOSED`	恢复，告警等级保持打开时的等级
为空（变更、上下线事件）	触发，不会自动恢复，需要手动关闭

其他状态值会被拒绝并返回参数错误。

标签	来源
`issue_id`	问题 ID，即 Alert Key
`issue_type`	事件类型：`issue`、`incident`、`monitoringIssue`、`change`、`presence`
`state`	`OPEN` 或 `CLOSED`
`instana_severity`	Instana 原始严重程度
`resource` / `entity_label`	受影响实体的名称
`entity` / `entity_type`	受影响实体的类型，如 `jvm`、`Host`
`host`	受影响主机的 FQDN
`service`	受影响的服务
`zone` / `custom_zone` / `availability_zone`	实体所在的区域
`tags`	实体的标签
`container`	受影响的容器
`link`	Instana 中该问题的链接
`custom_*`	告警配置中的 Custom payloads，例如 `custom:team` 对应 `custom_team`，多个值用逗号连接

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

排查问题

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

更多字段含义请参阅 Instana Webhook 告警通道。

快速开始

产品对比

协作空间

故障管理

故障复盘

状态页

分析看板

集成配置

配置中心

高级功能

集成中心

最佳实践

在 Flashduty On-call

使用专属集成

使用共享集成

在 Instana 中配置

Alert Key

状态和告警等级

标签

排查问题

​在 Flashduty On-call

​使用专属集成

​使用共享集成

​在 Instana 中配置

​Alert Key

​状态和告警等级

​标签

​排查问题

在 Flashduty On-call

使用专属集成

使用共享集成

在 Instana 中配置

Alert Key

状态和告警等级

标签

排查问题