从触发的面板到锁屏
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 告警到达你的手机
创建 Webhook
创建带有 GJSON 消息模板的 Pocket Alert Webhook,并复制其接收 URL。
配置联系点
在 Grafana Alerting 中将该 URL 添加为 Webhook 联系点,并将其关联到通知策略。
映射并推送
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,而不会被拒绝。