跳转到主要内容
Kapacitor 的 post 事件处理器 把每个告警事件以 JSON 的形式 POST 到一个 HTTP 地址。请求体是 Kapacitor 的告警数据(id、message、details、time、duration、level、data、previousLevel、recoverable),Flashduty 的 InfluxData 集成 按这个格式解析,因此不需要单独的 Kapacitor 集成:在 Flashduty 创建 InfluxData 集成,把它的推送地址填进 Kapacitor 即可。

在 Flashduty On-call

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

使用专属集成

  1. 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增集成
  3. 选择 InfluxData,点击 保存
  4. 打开生成的集成卡片,复制 推送地址,形如 https://api.flashcat.cloud/event/push/alert/influxdata?integration_key=<集成密钥>

使用共享集成

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

在 Kapacitor 中配置

以下三种方式任选其一,推送地址都要填写完整(包含 ?integration_key=...)。
1

在 Kapacitor 中添加 post 事件处理器

操作路径:TICKscript 文件 › alert() 节点 › .post()
修改脚本后,用 kapacitor define 重新定义任务。
2

让 Kapacitor 发出一次真实告警并确认

操作路径:Kapacitor 所在主机的终端请让任务的告警条件真正满足一次(例如临时调高 .crit() 的阈值),再恢复正常:
  1. 确认 Flashduty 收到一条告警,集成显示 最新事件时间
  2. 条件回到 OK 后,确认原告警恢复(Kapacitor 发送 level 为 OK 的事件,Flashduty 按相同的 id 关闭告警)
  3. 没有收到告警时,在 .post() 上加 .captureResponse() 查看 Flashduty 的返回
通过 Chronograf 1.x 的 Alert Rule Builder 添加 post 处理器,实际使用的就是同一个 Kapacitor 处理器,配置方法见 InfluxData 集成。

字段映射

level 不是以上取值时,Flashduty 返回 level ... is not supported 并拒绝该事件。

恢复与去重

  • Kapacitor 在级别回到 OK 时发送 level 为 OK 的事件,Flashduty 按相同的 id 关闭告警。不要在 alert() 上使用 .noRecoveries(),否则 Kapacitor 不发送恢复事件。
  • id 默认是 {{ .Name }}:{{ .Group }}(测量名称和分组)。用 .id() 自定义时,请保证同一个对象的触发和恢复使用相同的值。
  • 需要在 Kapacitor 日志中看到 Flashduty 返回的错误时,给 .post() 加 .captureResponse()(topic 处理器为 capture-response: true),响应状态码不是 2xx 时会记录响应内容。

排查问题

  • Flashduty 返回 Invalid parameters:推送地址不完整,缺少 integration_key,或集成类型不是 InfluxData
  • 返回 level ... is not supported:请求体的 level 不是 CRITICAL、WARNING、INFO、OK;请确认发送的是 Kapacitor 原始的告警数据,而不是经过转发或改写的内容
  • 告警没有恢复:确认恢复事件的 id 与触发时一致,且任务会在恢复时发出 OK 事件
  • 收不到任何告警:确认 Kapacitor 所在主机能访问 api.flashcat.cloud