在 Flashduty On-call
您可通过以下两种方式获取集成推送地址,任选其一即可。使用专属集成
- 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
- 选择 配置 → 集成数据 → 专属集成,点击 新增集成
- 选择 Coroot,点击 保存
- 打开生成的集成卡片,复制 推送地址
使用共享集成
- 进入 Flashduty 控制台,选择 集成中心 → 告警事件
- 选择 Coroot,填写集成名称
- 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
- 点击 保存,复制生成的 推送地址
在 Coroot 中配置
1
在 Coroot 中创建 Webhook 集成
操作路径:Coroot › Project Settings › Integrations › Webhook
2
填写通知模板
操作路径:Coroot › Project Settings › Integrations › WebhookIncident template 和 Alert template 两个模板都填写 Coroot 内置的 如果希望把环境、团队等固定信息带到 Flashduty,可在集成的 Custom fields 中添加键值对(例如
json 函数:environment = production)。Coroot 会把它们放在 JSON 顶层,Flashduty 将其作为标签。3
开启通知路由
操作路径:Coroot › Project Settings › Applications选择一个应用类别(category),为 Incidents 和 Alerts 开启 Webhook;需要覆盖的每个类别都要设置。Coroot 只对已开启通知的类别发送 Webhook。
4
验证
操作路径:Coroot › Project Settings › Integrations › Webhook
- 回到 Webhook 集成表单,点击 Send test alert。它只验证推送地址可达:Flashduty 返回成功,并创建一条等级为 Info 的测试告警(标题为
Coroot test notification),需要手动关闭。每点击一次,都会创建一条新的测试告警 - 让一条告警规则或 SLO 真正命中,确认 Flashduty 收到活动告警;再让它恢复,确认原告警自动关闭。恢复由 Coroot 在告警或事件恢复时再发送一次通知完成,无需单独配置
Alert Key
Flashduty 使用 Coroot 通知中url 字段携带的 ID 作为 Alert Key:
每个 Coroot 告警和事件在创建时生成唯一 ID,打开和恢复通知使用同一个 ID。同一条规则在同一个应用上再次触发会生成新的 ID,因此是一条新的 Flashduty 告警。严重程度、规则名称、摘要和
url 的域名变化都不会改变 Alert Key。
状态和告警等级
Coroot 只在告警或事件打开、恢复时发送通知;打开后严重程度变化不会再通知。- Alert 恢复时,原等级取通知中的
severity(warning或critical) - Incident 的通知只有
status,恢复事件的等级记为 Info - 无法识别的
status按 Warning 处理,避免 Flashduty 返回错误后 Coroot 暂停后续通知
标签
排查问题
Coroot 日志出现 failed to send alert ... 400
Coroot 日志出现 failed to send alert ... 400
确认两个模板都是
{{ json . }},且推送地址完整并包含 integration_key。Flashduty 在无法从 url 取得 ID 时返回 400,Coroot 会在一小时内持续重试,并暂停同一目的地的后续通知。告警没有恢复
告警没有恢复
确认 Alert template 或 Incident template 没有被改成自定义文本,并且该应用类别的 Alerts 和 Incidents 都开启了 Webhook。恢复通知只靠
url 中的 ID 与触发通知关联。没有收到 Alert 通知
没有收到 Alert 通知
Coroot 的 Alert template 为空时不会发送 Alert 通知,请确认已填写。另外在 Project Settings → Applications 中,对应类别的 Alerts 需要开启 Webhook。
Send test alert 成功但真实告警没收到
Send test alert 成功但真实告警没收到
Send test alert 按钮只发送一条固定的测试 Incident,不经过应用类别路由。请检查应用所属类别的通知设置,以及告警规则是否真正命中。
部署通知会变成告警吗
部署通知会变成告警吗
不会。部署通知(
url 指向应用的 Deployments 页面)会被 Flashduty 接收并忽略,与 status 取值无关。