跳转到主要内容
Flashduty 实现了 PagerDuty Events API,输入和响应完全兼容。因此您可以通过 PagerDuty 协议推送告警事件到 Flashduty On-call。 同样的,对于已经支持推送事件到 PagerDuty 的告警系统(如 ElastAlert),您仅需要修改目的推送地址,即可利用 PagerDuty 协议推送事件到 Flashduty 。

在 Flashduty On-call

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

使用专属集成

如果您只需将告警发往一个协作空间,选择此方式,配置更简单。
  1. 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增集成
  3. 选择 PagerDuty 兼容 集成,点击 保存,生成卡片。
  4. 打开生成的集成卡片,复制 推送地址

使用共享集成

如果您需要根据告警事件的 Payload 将告警路由到不同协作空间,选择此方式。
  1. 进入 Flashduty 控制台,选择 集成中心 → 告警事件
  2. 选择 PagerDuty 兼容 集成:
    • 集成名称:为当前集成定义一个名称。
  3. 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
  4. 点击 保存,复制生成的 推送地址

在告警系统中配置

请求地址

该地址同时支持 PagerDuty V1 和 V2 Events API。您必须修改 PagerDuty 地址为该地址。

Pagerduty V2 Events

参考文档

PagerDuty V2 Events

鉴权方式

两种方式任选其一:
  • 方式 1:在 QueryString 中包含参数 integration_key
  • 方式 2:将 integration_key 作为 routing_key 参数传入 Payload

Pagerduty V1 Events

参考文档

PagerDuty V1 Events

鉴权方式

两种方式任选其一:
  • 方式 1:在 QueryString 中包含参数 integration_key
  • 方式 2:将 integration_key 作为 service_key 参数传入 Payload

状态和告警等级

V2 的 severity 取其他值时请求会被拒绝。非 trigger 事件必须带 dedup_key(V1 为 incident_key),否则请求会被拒绝。

配置示例

以 ElastAlert2 为例:
1

在 ElastAlert2 中修改推送地址

操作路径:ElastAlert2 源码 › elastalert/alerters/pagerduty.py在当前页面填写集成名称并保存,重新打开集成详情,复制推送地址。修改已经部署好的 ElastAlert 实例对应源码,把该文件中 V2 和 V1 两处 PagerDuty 地址(https://events.pagerduty.com/v2/enqueue、https://events.pagerduty.com/generic/2010-04-15/create_event.json)都替换为:
查看 diff:drawing
2

在 ElastAlert2 规则文件中配置告警

操作路径:ElastAlert2 规则文件 › alert遵循 ElastAlert PagerDuty 推送配置文档 步骤,配置告警。Flashduty 相关的配置项如下:完整规则示例:
3

重启 ElastAlert 并验证

操作路径:ElastAlert2 所在主机的终端重启 ElastAlert,等待规则触发(pagerduty_event_type 默认为 trigger)。ElastAlert 没有 Flashduty 的测试按钮,需要一次真实触发的告警来验证。