id、message、details、time、duration、level、data、previousLevel、recoverable),Flashduty 的 InfluxData 集成 按这个格式解析,因此不需要单独的 Kapacitor 集成:在 Flashduty 创建 InfluxData 集成,把它的推送地址填进 Kapacitor 即可。
在 Flashduty On-call
您可通过以下两种方式获取集成推送地址,任选其一即可。集成类型都选择 InfluxData。使用专属集成
- 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
- 选择 配置 → 集成数据 → 专属集成,点击 新增集成
- 选择 InfluxData,点击 保存
- 打开生成的集成卡片,复制 推送地址,形如
https://api.flashcat.cloud/event/push/alert/influxdata?integration_key=<集成密钥>
使用共享集成
- 进入 Flashduty 控制台,选择 集成中心 → 告警事件
- 选择 InfluxData,填写集成名称
- 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
- 点击 保存,复制生成的 推送地址
在 Kapacitor 中配置
以下三种方式任选其一,推送地址都要填写完整(包含?integration_key=...)。
1
在 Kapacitor 中添加 post 事件处理器
- TICKscript 直接写地址
- kapacitor.conf 中的 endpoint
- topic 处理器
操作路径:TICKscript 文件 › 修改脚本后,用
alert() 节点 › .post()kapacitor define 重新定义任务。2
让 Kapacitor 发出一次真实告警并确认
操作路径:Kapacitor 所在主机的终端请让任务的告警条件真正满足一次(例如临时调高
.crit() 的阈值),再恢复正常:- 确认 Flashduty 收到一条告警,集成显示 最新事件时间
- 条件回到
OK后,确认原告警恢复(Kapacitor 发送level为OK的事件,Flashduty 按相同的id关闭告警) - 没有收到告警时,在
.post()上加.captureResponse()查看 Flashduty 的返回
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