Grafana

让 Grafana 告警 直达手机。

Grafana 告警规则触发时,告警名称、严重级别和状态会在一秒内到达你的手机。无需一直盯着屏幕,就能在控制台变红之前发现问题。

<1s 内推送无需安装 插件支持云端 & 自托管更新于
功能

从触发的面板到锁屏

Grafana 在告警规则触发时已经会发送 Webhook。Pocket Alert 将其变成你不会错过的推送通知。

标准联系点

在 Grafana Alerting 中将 Pocket Alert 添加为 Webhook 联系点。无需插件,无需代理,云端和自托管均可使用。

使用 GJSON 映射字段

GJSON 路径可直接从 Grafana 负载中提取 alertname、status 和 summary 注释,并写入你的通知。

内联显示严重级别和状态

在推送中直接显示严重级别标签和 firing/resolved 状态,使严重告警与恢复通知的内容一目了然。

每个团队一个渠道

每个应用都有独立的 Webhook URL,因此基础设施、应用和各团队的告警都保持在各自的渠道中。

亚秒级送达

触发的告警在一秒内到达你的手机,远早于有人打开控制台。

保密的 Webhook URL

Webhook URL 是你应用的密钥,通过 HTTPS 传输。需要新的端点时,可随时轮换。

快速开始

三步让 Grafana 告警到达你的手机

1

创建 Webhook

创建带有 GJSON 消息模板的 Pocket Alert Webhook,并复制其接收 URL。

2

配置联系点

在 Grafana Alerting 中将该 URL 添加为 Webhook 联系点,并将其关联到通知策略。

3

映射并推送

GJSON 会将 status、alertname、severity 和 summary 映射到你的推送中。下一条触发的告警就会让你的手机震动。

将 Grafana 告警发送到手机

1. 创建 Pocket Alert Webhook

在 Webhooks 页面创建一个 Webhook,其 GJSON message 模板用于读取 Grafana 负载。Grafana 会发送 status、commonLabels 对象和 alerts 数组,因此一个可用的模板如下:

curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Grafana","default_level":"critical","message":"[%status%] %commonLabels.alertname% (%commonLabels.severity%)\n%alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'

你会得到类似 https://p4a.me/wh/1234abcd 的入站 URL。

2. 将其添加为 Webhook 联系点

在 Grafana 中进入 Alerting → Contact points → Add contact point,选择 Webhook 集成,然后粘贴接收 URL:

Integration: Webhook
URL:    https://p4a.me/wh/1234abcd
Method: POST

将联系点关联到通知策略,使匹配的告警路由到该联系点。Grafana 会发送其标准 JSON;上面的 GJSON 路径会将 status、commonLabels.alertname、commonLabels.severity 和 alerts.0.annotations.summary 提取到推送中。

3. 发送测试

使用联系点的 Test 按钮。触发的告警会显示为 [firing] HighCPU (critical);告警清除后,status 会变为 resolved。

有关每个 GJSON 路径和 Webhook 选项,请参阅 Webhook 设置文档。

常见问题

常见问题解答

在 Grafana 中进入 Alerting → Contact points,添加一个 Webhook 联系点,然后粘贴你的 Pocket Alert 应用 URL。将其关联到通知策略后,下一条触发的告警会在一秒内到达你的手机。

Grafana 会发送一个 JSON 负载,包含 status、commonLabels 对象和 alerts 数组。Pocket Alert 使用 GJSON 路径读取它,因此你可以将 commonLabels.alertname 映射为标题,将 alerts.0.annotations.summary 映射为正文,并用 status 显示触发或已恢复。

可以。负载中的严重级别标签位于 commonLabels.severity,状态为 firing 或 resolved。在 GJSON 消息模板中同时引用两者,这样严重的触发告警与已恢复的告警显示内容就会不同。

为每个 Grafana 文件夹或团队分配一个独立的应用。基础设施告警和应用告警会进入不同的渠道,你可以单独静音其中一个,而不影响另一个。

不需要额外操作。Pocket Alert 接收的是 Grafana 告警引擎本身已发送的 Webhook,因此无需安装插件或代理。Grafana Cloud 和自托管版本均可使用。

可以。每条消息都支持一个级别:silent、low、default、high 或 critical。在负载中加入 "level" 字段,或在 Webhook 上设置 default_level,使所有路由到该 Webhook 的消息都以该优先级送达;负载中显式指定的级别优先。一种常见做法是 firing=critical、resolved=silent:触发的告警可突破勿扰模式,恢复通知则在历史记录中保持安静。无效值会回退为 default,而不会被拒绝。

在控制台变红之前,先在手机上看到告警。

创建一个应用,复制它的 Webhook URL,然后将其添加为 Grafana 联系点。