Flashduty Docs
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，如下图所示：
- 保存，回到集成列表，等待产生告警后，如果展示了最新事件时间，说明配置成功且收到事件
- 完成
Grafana Alerting
- 打开您的 Grafana 控制台，选择 Alerting > Contact points 页面
- 点击 New contact point，打开配置弹窗页面
- 配置名称，Type 选择 webhook，Url 填写集成的推送地址， Method 选择 POST，如下图所示：
- 打开 Notification policies 页面，根据情况编辑或新增 policy，选择上一步创建的 contact point 作为发送渠道，如下图所示：
- 保存，回到集成列表，等待产生告警后，如果展示了最新事件时间，说明配置成功且收到事件
- 默认告警等级为 warning，如果需要自定义，可以在告警详情页面配置 severity 标签（枚举参考下文状态对照），具体操作如下图所示：
- 完成
状态对照
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 | 恢复 |
最后修改时间： 8 个月前