跳转到主要内容
通过 webhook 的方式将夜莺(Nightingale / n9e)或 Flashcat 告警事件推送到 Flashduty。当告警触发时,向 Flashduty 发送触发事件;当告警恢复时,向 Flashduty 发送恢复事件。 在夜莺/Flashcat v8.0.0-beta.7 版本之后(含 beta.7),可以直接在告警通知规则中配置协作空间,不再需要使用路由规则;更早的版本通过 Webhook 回调地址推送,需要在 Flashduty 中设置路由规则。

前置条件

  • 您必须拥有修改 系统配置 → 全局通知 或 告警管理 → 告警规则 的权限
  • 您的夜莺 Server 必须能够访问域名 api.flashcat.cloud

在 Flashduty 获取推送地址

您可以通过以下两种方式获取推送地址,请根据您的需求选择。

使用专属集成(推荐)

如果您只需将告警发往一个协作空间,选择此方式,配置更简单。
  1. 登录 Flashduty 控制台,选择 协作空间,进入目标空间的详情页面
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增集成,选择 夜莺/Flashcat 集成类型,点击 保存
  3. 点击生成的集成卡片,复制 推送地址 备用
  4. (可选)点击 编辑 按钮,在 控制台地址 中输入夜莺控制台域名,Flashduty 将为新告警自动生成夜莺详情跳转链接

使用共享集成

当您需要根据告警事件的 Payload 信息将告警路由到不同的协作空间时,选择此方式。
  1. 登录 Flashduty 控制台,选择 集成中心 → 告警事件
  2. 选择 夜莺/Flashcat 集成,填写以下信息:
    • 集成名称:为当前集成定义一个名称
    • 控制台地址:(可选)输入夜莺控制台域名
  3. 配置默认路由并选择对应的协作空间。您可以稍后在 路由 页面配置更多路由规则
  4. 点击 保存 后,复制生成的 推送地址 备用

在夜莺/Flashcat 中配置

1

在夜莺中添加 Flashduty 推送地址

操作路径:夜莺 › 通知 › 通知媒介 › FlashDuty部分 v8 版本的 通知媒介 位于 告警管理 菜单下。点击 保存。添加通知媒介
2

在夜莺中创建发往 Flashduty 的通知规则

操作路径:夜莺 › 通知 › 通知规则 › 新增仅 v8.0.0-beta.7 及以上版本需要此步,更早的版本跳过。协作空间需提前在 Flashduty 中创建,并配置分派策略。点击 保存。配置通知规则
3

在夜莺中为告警规则关联 Flashduty

操作路径:夜莺 › 告警管理 › 告警规则 › 新增或编辑 › 通知配置选择上一步创建的通知规则,点击 保存。关联告警规则
4

在夜莺中发送测试通知并确认

操作路径:夜莺 › 通知 › 通知规则 › 目标规则 › 通知测试v8.0.0-beta.7 及以上版本:点击 通知测试,选择一条历史告警事件发送。更早的版本没有该入口,请等待新告警触发。几秒后回到 Flashduty,集成显示 最新事件时间,说明配置成功。

无事件检测

无事件检测 卡片在指定时间内未收到有效事件时,生成一条 Warning 告警。开关位于卡片标题行右侧,默认关闭;关闭时卡片只有一行,不显示其他选项。 开启后显示以下选项:

状态和告警等级

夜莺/Flashcat 与 Flashduty 的告警等级映射关系如下:

常见问题

在 Flashduty 排查
  1. 检查最新事件时间:查看集成是否显示了 最新事件时间。如果没有,说明 Flashduty 未收到推送,请优先排查夜莺配置。
  2. 检查路由规则:如果您使用的是 共享集成,请确认是否配置了 路由规则。未配置路由规则时,系统会拒绝新的推送。
在夜莺/Flashcat 排查
  1. 确认告警已生成:前往 告警管理 → 历史告警,确认配置 Webhook 后是否产生了新告警(状态必须为 Triggered)。
  2. 验证回调地址:进入告警详情,检查 回调地址 是否与 Flashduty 推送地址完全匹配。
  3. 检查网络连通性:登录夜莺 Server,确认可以访问 api.flashcat.cloud 域名。
  1. 查看错误日志:如果网络正常,请检查 Server 日志中是否存在相关错误信息。
如果以上步骤仍无法解决问题,请联系 Flashduty 技术支持。
请确认以下几点:
  1. 夜莺告警规则配置了恢复通知
  2. 恢复事件的 Webhook 回调地址与触发事件一致
  3. 告警的唯一标识(fingerprint)在触发和恢复时保持一致
您可以通过以下方式测试:
  1. 在夜莺中手动触发一条测试告警
  2. 等待几秒后,检查 Flashduty 集成列表中的 最新事件时间 是否更新
  3. 进入协作空间,确认是否生成了对应的故障