Flashduty Docs
中文EnglishRoadmapAPI官网控制台
中文EnglishRoadmapAPI官网控制台
  1. 告警集成
  • 简介
  • On-call
    • 快速开始
      • 快速开始
      • 常见问题
      • 产品对比
    • 故障管理
      • 什么是故障
      • 检索与查看故障
      • 处理与更新故障
      • 升级与分派故障
      • 自定义字段
      • 自定义操作
      • 了解降噪过程
      • 了解历史故障
      • 了解新奇故障
    • 配置On-call
      • 协作空间管理
      • 多种方式接入告警
      • 配置路由规则
      • 配置标签增强
      • 配置告警降噪
      • 配置分派策略
      • 故障静默与抑制
      • 配置值班规则
      • 配置通知模板
      • 配置服务日历
      • 配置个人信息
      • 配置过滤条件
      • 通知机器人
      • 告警处理 pipeline
    • 高级功能
      • 引用变量
      • 动态分派
      • 分析数据
    • 集成引导
      • 告警集成
        • 邮件 Email 集成指引
        • 夜莺 Flashcat 集成指引
        • Prometheus 集成指引
        • 标准告警事件集成指引
        • Grafana 集成指引
        • Zabbix 集成指引
        • Uptime Kuma 集成指引
        • 阿里云 ARMS 集成指引
        • 阿里云监控 CM 事件集成指引
        • 阿里云监控 CM 指标集成指引
        • 阿里云 SLS 集成指引
        • AWS CloudWatch 集成指引
        • Azure Monitor 集成指引
        • 百度云监控 BCM 集成指引
        • 华为云监控 CES 集成指引
        • 腾讯云 CLS 集成指引
        • 腾讯云监控 CM 集成指引
        • 腾讯云 Event Bridge 集成指引
        • Influxdata 集成指引
        • Open Falcon 集成指引
        • Pagerduty 集成指引
        • 蓝鲸智云集成指引
        • OceanBase 集成指引
        • Graylog 集成指引
        • Skywalking 集成指引
        • Sentry 集成指引
        • 监控宝告警集成指引
        • AWS EventBridge 集成指引
        • Dynatrace 集成指引
        • 华为云 LTS 集成指引
        • GoogleCloud 集成指引
        • Splunk 集成指引
        • AppDynamics 集成指引
        • SolarWinds 集成指引
        • 火山引擎CM 指标集成指引
        • 火山引擎CM 事件集成指引
        • 火山引擎日志服务 TLS 集成指引
        • Opmanager 告警事件
        • Meraki 告警事件
        • 天翼云告警集成
        • 观测云告警事件
        • zilliz 告警事件
        • 华为云 APM 告警事件
        • zstack 告警事件
        • Keep 告警集成指引
        • ElastAlert2 告警集成
      • 即时消息
        • 飞书 Lark 集成指引
        • 钉钉 Dingtalk 集成指引
        • 企业微信 Wecom 集成指引
        • Slack 集成指引
        • Microsoft Teams 集成指引
      • 单点登录
        • Authing 集成指引
        • Keycloak 集成指引
        • OpenLDAP 集成指引
      • Webhooks
        • 告警 webhook
        • 故障 webhook
        • 自定义操作
      • 变更集成
        • 标准变更事件集成指引
  • RUM
    • 快速开始
      • 入门介绍
      • 快速开始
      • 常见问题
    • 应用管理
      • 应用管理
      • SDK接入
      • 高级配置
      • 分析看板
    • 性能监控
      • 概览
      • 指标上报
      • 性能分析
      • 诊断优化
    • 异常追踪
      • 概览
      • 异常上报
      • 异常查看
      • 源码映射
      • 异常聚合
      • Issue状态
      • Issue告警
    • 其他
      • 术语说明
      • 数据收集
      • 数据安全
  • 平台功能
    • 团队和成员
    • 了解权限设计
    • 配置单点登录
  • 服务协议
    • 服务条款
    • 用户协议/隐私政策
    • SLA承诺
    • 数据安全
  1. 告警集成

夜莺 Flashcat 集成指引

通过 webhook 的方式将夜莺(Nightingale / n9e)或 Flashcat 告警事件推送到 Flashduty。当告警触发时,向 Flashduty 发送触发事件,当告警恢复时,向 Flashduty 发送恢复事件。
在夜莺/Flashcat 的 v8.0.0-beta.7 版本之后(含 beta.7),可以直接在告警通知规则中配置协作空间,不再需要使用路由规则。
v8.0.0-beta.7 +
v5~v8.0.0-beta.6

使用限制#


在夜莺#

您必须拥有修改 系统配置=>全局通知 或 告警管理=>告警规则 的权限。
您的夜莺 server 必须能够访问域名 api.flascat.cloud,将告警推送到外网。

支持版本#


本文适配 夜莺 V5 和 V6 版本。

操作步骤#


在 Flashduty#

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

使用专属集成#

当您不需要将告警事件路由到不同的协作空间,优先选择此方式,更简单。
展开
1.
进入 Flashduty 控制台,选择 协作空间,进入某个空间的详情页面
2.
选择 集成数据 tab,点击 添加一个集成,进入添加集成页面
3.
选择 夜莺/Flashcat 集成,点击 保存,生成卡片。
4.
点击生成的卡片,可以查看到 推送地址,复制备用,完成。
5.
(可选)点击生成的卡片,点击 编辑 按钮,选择 控制台地址,输入夜莺控制台地址(仅域名部分),Flashduty 会为新告警生成一个夜莺详情跳转链接。

使用共享集成#

当您需要根据告警事件的 Payload 信息,将告警路由到不同的协作空间,优先选择此方式。
展开
1.
进入 Flashduty 控制台,选择 集成中心=>告警事件,进入集成选择页面。
2.
选择 夜莺/Flashcat 集成:
集成名称:为当前集成定义一个名称。
控制台地址:(可选)输入夜莺控制台地址(仅域名部分),Flashduty 会为新告警生成一个夜莺详情跳转链接。
3.
配置默认路由,并选择对应的协作空间(集成创建后可以前往 路由 进行更多路由规则的配置)。
4.
点击 保存 后,复制当前页面的新生成的 推送地址 备用。
5.
完成。

在夜莺/Flashcat#

在夜莺/Flashcat v8.0.0-beta.7 + 版本中配置 #

在新版本中,虽然您可以直接在告警通知规则中配置协作空间,但您仍然需要在 Flashduty 中创建协作空间并配置分派策略等。

步骤 1:添加通知媒介#

1.
登录您的 n9e 控制台,选择 告警管理 > 通知媒介,并点击新增。
2.
填写媒介名称和标识,选择 FlashDuty 类型,URL 填写 Flashduty 的 推送地址。
3.
点击 保存 后,完成。
drawing

步骤 2:配置通知规则#

1.
登录您的 n9e 控制台,选择 告警管理 > 通知规则,并点击新增或编辑已有的告警规则。
2.
基础信息部分按需配置即可。
3.
在通知配置中选择上一步添加的 FlashDuty 通知媒介。
4.
选择通过此规则生成的告警应发送到的协作空间(协作空间需提前在 Flashduty 中创建),其他按需选择。
5.
点击 保存 后,完成。
drawing

步骤 3:告警规则中选择通知规则#

1.
登录您的 n9e 控制台,选择 告警管理 > 告警规则,并点击新增或编辑已有的告警规则。
2.
在通知配置中选择上一步添加的 FlashDuty 通知规则,其他按需选择。
3.
点击 保存 后,完成。
drawing

在夜莺/Flashcat v5.5~v8.0.0-beta.6 版本中配置 #

两种配置方式任选其一

方式 1:按策略配置#

批量选择告警规则并配置 webhook。
1.
登录您的 n9e 控制台,选择 告警管理 > 告警规则,进入告警规则列表页面
2.
批量选中您期望导入的告警规则,右上角选择批量更新告警规则
3.
在弹窗中选择“回调地址”字段,新增输入框中填写集成的推送地址,如下图所示:
drawing
4.
回到集成列表,如果展示了最新事件时间,说明配置成功且收到事件
5.
完成

方式 2:全局配置#

夜莺支持在页面和配置文件中配置全局 webhook 地址,推送所有的告警事件。以下两种方式二选一即可。
V6 及以上版本#
1.
登录您的 n9e 控制台
2.
进入系统配置-通知设置-回调地址页面
3.
如下图所示,启用一个新的 webhook,URL 部分填写集成的推送地址
drawing
4.
完成
V5.4~5.15 版本#
1.
登录您的 n9e server 实例
2.
找到并打开配置文件,一般为 etc/server.conf
3.
更改 Alerting 配置部分,写入 Webhook 配置,如下
[Alerting.Webhook]
Enable = true
Url = "{api_host}/event/push/alert/n9e?integration_key=$integration_key"
BasicAuthUser = ""
BasicAuthPass = ""
Timeout = "5s"
Headers = ["Content-Type", "application/json", "X-From", "N9E"]
您需要替换 Url 对应的参数值为集成的推送地址。
4.
保存配置文件
5.
重启 n9e server,使配置生效
6.
回到集成列表,如果展示了最新事件时间,说明配置成功且收到事件
7.
完成

严重程度映射关系#


夜莺/Flashcat 到 Flashduty 告警等级映射关系:
n9eFlashduty状态
1Critical严重
2Warning警告
3Info提醒

常见问题#


为什么在Flashduty没有收到告警?

在 Flashduty#

1.
查看集成是否展示了 最新事件时间?如果没有,代表Flashduty没有收到推送,直接优先排查夜莺部分。
2.
如果您使用的是 共享集成,优先确认您是否配置了 路由规则。不设置路由规则,系统会直接拒绝新的推送,因为没有协作空间可以承接您的告警。这种情况下,直接配置路由规则到您期望的空间即可。

在夜莺/Flashcat#

1.
首先确认夜莺测是否产生了新的告警:前往 告警管理=>历史告警,查看配置完 webhook 之后,是否产生了新的告警,注意新的告警状态必须是 Triggered。如没有产生新告警,请继续等待新告警触发后重新验证。
2.
找到告警之后,进到告警详情,查看 回调地址 部分。验证真实回调地址是否和集成推送地址完全匹配。如果不匹配,请修改 告警规则后重新验证。
3.
如果匹配,则需要登录到夜莺 server 并确认其可以访问外网 api.flashcat.cloud 域名。如果不可以,您首先需要为 server 开通外网,或单独针对 Flashduty 的域名开通外网访问。
4.
如果网络无问题,您需要继续排查server,查找是否存在相关的错误日志。
如果以上步骤执行之后,仍然没有查询到问题根因,请直接联系我们。

添加官方技术支持微信

在这里,获得使用上的任何帮助,快速上手FlashDuty

微信扫码交流
修改于 2025-05-19 11:48:57
上一页
邮件 Email 集成指引
下一页
Prometheus 集成指引
Built with