前置条件
- 在夜莺/Flashcat
- 在 Flashduty
- 您必须拥有修改 系统配置 → 全局通知 或 告警管理 → 告警规则 的权限
- 您的夜莺 Server 必须能够访问域名
api.flashcat.cloud
在 Flashduty 获取推送地址
您可以通过以下两种方式获取推送地址,请根据您的需求选择。使用专属集成(推荐)
如果您只需将告警发往一个协作空间,选择此方式,配置更简单。查看专属集成的配置步骤
查看专属集成的配置步骤
- 登录 Flashduty 控制台,选择 协作空间,进入目标空间的详情页面
- 选择 配置 → 集成数据 → 专属集成,点击 新增集成,选择 夜莺/Flashcat 集成类型,点击 保存
- 点击生成的集成卡片,复制 推送地址 备用
- (可选)点击 编辑 按钮,在 控制台地址 中输入夜莺控制台域名,Flashduty 将为新告警自动生成夜莺详情跳转链接
使用共享集成
当您需要根据告警事件的 Payload 信息将告警路由到不同的协作空间时,选择此方式。查看共享集成的配置步骤
查看共享集成的配置步骤
- 登录 Flashduty 控制台,选择 集成中心 → 告警事件
- 选择 夜莺/Flashcat 集成,填写以下信息:
- 集成名称:为当前集成定义一个名称
- 控制台地址:(可选)输入夜莺控制台域名
- 配置默认路由并选择对应的协作空间。您可以稍后在 路由 页面配置更多路由规则
- 点击 保存 后,复制生成的 推送地址 备用
在夜莺/Flashcat 中配置
1
在夜莺中添加 Flashduty 推送地址
- v8.0.0-beta.7 及以上
- v6–v8.0.0-beta.6
- v5.4–v5.15
操作路径:夜莺 › 通知 › 通知媒介 › FlashDuty部分 v8 版本的 通知媒介 位于 告警管理 菜单下。
点击 保存。

2
在夜莺中创建发往 Flashduty 的通知规则
3
在夜莺中为告警规则关联 Flashduty
- v8.0.0-beta.7 及以上
- v5–v8.0.0-beta.6
操作路径:夜莺 › 告警管理 › 告警规则 › 新增或编辑 › 通知配置选择上一步创建的通知规则,点击 保存。

4
在夜莺中发送测试通知并确认
操作路径:夜莺 › 通知 › 通知规则 › 目标规则 › 通知测试v8.0.0-beta.7 及以上版本:点击 通知测试,选择一条历史告警事件发送。更早的版本没有该入口,请等待新告警触发。几秒后回到 Flashduty,集成显示 最新事件时间,说明配置成功。
无事件检测
无事件检测 卡片在指定时间内未收到有效事件时,生成一条 Warning 告警。开关位于卡片标题行右侧,默认关闭;关闭时卡片只有一行,不显示其他选项。 开启后显示以下选项:状态和告警等级
夜莺/Flashcat 与 Flashduty 的告警等级映射关系如下:常见问题
为什么 Flashduty 没有收到告警?
为什么 Flashduty 没有收到告警?
在 Flashduty 排查
- 检查最新事件时间:查看集成是否显示了 最新事件时间。如果没有,说明 Flashduty 未收到推送,请优先排查夜莺配置。
- 检查路由规则:如果您使用的是 共享集成,请确认是否配置了 路由规则。未配置路由规则时,系统会拒绝新的推送。
- 确认告警已生成:前往 告警管理 → 历史告警,确认配置 Webhook 后是否产生了新告警(状态必须为 Triggered)。
- 验证回调地址:进入告警详情,检查 回调地址 是否与 Flashduty 推送地址完全匹配。
-
检查网络连通性:登录夜莺 Server,确认可以访问
api.flashcat.cloud域名。
- 查看错误日志:如果网络正常,请检查 Server 日志中是否存在相关错误信息。
告警恢复后 Flashduty 中的故障没有自动关闭?
告警恢复后 Flashduty 中的故障没有自动关闭?
请确认以下几点:
- 夜莺告警规则配置了恢复通知
- 恢复事件的 Webhook 回调地址与触发事件一致
- 告警的唯一标识(fingerprint)在触发和恢复时保持一致
如何测试集成是否配置成功?
如何测试集成是否配置成功?
您可以通过以下方式测试:
- 在夜莺中手动触发一条测试告警
- 等待几秒后,检查 Flashduty 集成列表中的 最新事件时间 是否更新
- 进入协作空间,确认是否生成了对应的故障


