Powered by Apifox

Grafana 集成指引

title: "Grafana集成"
description: "通过 webhook 的方式同步 Grafana 告警事件到快猫星云，实现告警事件自动化降噪处理。"
date: "2024-05-11T10:00:00+08:00"
url: "https://docs.flashcat.cloud/zh/flashduty/grafana-integration-guide"

通过 webhook 的方式同步 Grafana 告警事件到 Flashduty，实现告警事件自动化降噪处理。

在 Flashduty

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

使用专属集成

当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。

展开

进入 Flashduty 控制台，选择 协作空间，进入某个空间的详情页面
选择 集成数据 tab，点击 添加一个集成，进入添加集成页面
选择 Grafana 集成，点击保存，生成卡片。
点击生成的卡片，可以查看到 推送地址，复制备用，完成。

使用共享集成

当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。

展开

进入 Flashduty 控制台，选择 集成中心=>告警事件，进入集成选择页面。
选择 Grafana 集成：
- 集成名称：为当前集成定义一个名称。
点击保存后，复制当前页面的新生成的 推送地址 备用。
点击 创建路由，为集成配置路由规则。您可以按条件匹配不同的告警到不同的协作空间，也可以直接设置默认协作空间作为兜底，后续再按需调整。
完成。

在 Grafana

Grafana V4~V8 版本默认开启 Legacy Alerting 功能，在 V9 之后默认开启 Grafana Alerting 功能，功能区分以及启用方式请参考官方文档，请您根据您部署的版本进行集成，步骤如下。

Legacy Alerting

打开您的 Grafana 控制台，选择 Alerting > Notification channels 页面
点击 Add Channel，打开配置 Channel 弹窗页面
配置名称，Type 选择 webhook，Url 填写集成的推送地址， Method 选择 POST，如下图所示：

drawing

保存，回到集成列表，等待产生告警后，如果展示了最新事件时间，说明配置成功且收到事件
完成

Grafana Alerting

打开您的 Grafana 控制台，选择 Alerting > Contact points 页面
点击 New contact point，打开配置弹窗页面
配置名称，Type 选择 webhook，Url 填写集成的推送地址， Method 选择 POST，如下图所示：

drawing

打开 Notification policies 页面，根据情况编辑或新增 policy，选择上一步创建的 contact point 作为发送渠道，如下图所示：

drawing

保存，回到集成列表，等待产生告警后，如果展示了最新事件时间，说明配置成功且收到事件
默认告警等级为 warning，如果需要自定义，可以在告警详情页面配置 severity 标签（枚举参考下文状态对照），具体操作如下图所示：

drawing

完成

状态对照

Legacy Alerting 到 Flashduty 告警等级映射关系：

Legacy Alerting	Flashduty	状态
alerting	Warning	警告
no_data	Critical	严重
ok	Ok	恢复

Grafana Alerting 到 Flashduty 告警等级映射关系：

系统依次提取告警事件标签中的 severity、priority和 level，对应值将作为 Prometheus 自身的告警等级，如果没有提取到，系统自动设置 Prometheus 告警等级为 warning。

Grafana Alerting	Flashduty	状态
critical	Critical	严重
warning	Warning	警告
warn	Warning	警告
info	Info	提醒
acknowledged	Info	提醒
unknown	Info	提醒
unk	Info	提醒
ok	Ok	恢复

最后修改时间： 7 个月前