跳转到主要内容
Kener 是开源的状态页和监控系统。通过 Kener 的 Webhook 触发器(Trigger),可以把告警配置(Alert)产生的告警同步到 Flashduty On-call:监控达到失败阈值时在 Flashduty 触发告警,达到成功阈值时自动恢复。 Kener 的 Webhook 请求体由您在触发器的模板里编写,本页提供了一份可直接使用的模板,Flashduty 按这份模板的字段解析。

在 Flashduty On-call

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

使用专属集成

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

使用共享集成

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

在 Kener 中配置

需要 Kener 4.x,并使用有权限管理触发器和告警配置的账号登录管理后台。Kener 所在的服务器需要能访问 Flashduty 的推送地址。
1

在 Kener 中创建 Webhook 触发器

操作路径:Kener 管理后台 › Triggers
填写后保存触发器。Kener 渲染模板时不做 JSON 转义。内置默认模板包含 alert_message(告警配置里的 Details 文本)和站点名称,其中的双引号或换行会让请求体不再是合法 JSON,Flashduty 将拒绝这类请求,告警和恢复都会丢失,因此请使用上面不含这些字段的模板。
2

在 Kener 中创建告警配置并关联触发器

操作路径:Kener 管理后台 › Alerts填写后保存。
3

验证

操作路径:Kener 管理后台 › Triggers
  1. 点击触发器的测试按钮,确认 Kener 显示发送成功。测试只能证明 Kener 能连通 Flashduty,不代表真实监控已接通。测试请求是 Kener 内置的固定内容(告警 ID 为 1,严重程度 WARNING,状态随机为 TRIGGERED 或 RESOLVED),Flashduty 按普通告警处理:TRIGGERED 时会创建或更新 Alert Key 为 1 的 Warning 告警,RESOLVED 时会恢复这条告警,没有打开的告警时不产生新告警。验证后若该告警仍未恢复,请在 Flashduty 中手动关闭
  2. 让被监控的服务真正失败,达到失败阈值后确认 Flashduty 出现活动告警,集成显示 最新事件时间
  3. 服务恢复并达到成功阈值后,确认该告警自动恢复

Alert Key

Flashduty 使用 Kener 的 alert_id 作为 Alert Key。Kener 在监控达到失败阈值时创建一条告警记录,恢复时更新同一条记录的状态,因此触发和恢复的 alert_id 相同;同一个监控再次宕机会生成新的 alert_id,对应 Flashduty 的新告警。 监控名称、等级、状态、取值等字段变化不会改变 Alert Key。请求中缺少 alert_id 会被拒绝。alert_id 只在同一个 Kener 实例内唯一,一个 Flashduty 集成请只接收一个 Kener 实例的推送。

状态和告警等级

告警标题由监控标识、告警类型和取值拼成,例如 my-api STATUS: DOWN。

标签

排查问题

  • Flashduty 返回参数错误:确认 URL 完整且包含 integration_key,并确认触发器使用了本页的模板;响应信息会指出缺少的字段
  • Kener 触发器测试失败:测试结果里会显示 HTTP 状态码或网络错误,确认 Kener 所在服务器能访问 Flashduty 推送地址
  • 告警没有恢复:确认告警配置的 Success Threshold 已满足,并确认触发器没有被禁用;同一监控在满足成功阈值前不会发送恢复
  • 没有收到告警:确认告警配置处于启用状态,并且已关联这个触发器
更多变量说明请参阅 Kener 告警模板 和 Kener 触发器。