# 让 Grafana 告警 直达手机 。

> 把 Grafana 告警变成推送通知。将 Pocket Alert 添加为 Webhook 联络点，一秒内在手机上收到触发的告警规则。

<!-- source: https://pocketalert.app/zh/use-cases/grafana-alerts -->

最后更新：2026-08-11

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

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

1. **创建 Webhook** — 创建带有 GJSON 消息模板的 Pocket Alert Webhook，并复制其接收 URL。
2. **配置联系点** — 在 Grafana Alerting 中将该 URL 添加为 Webhook 联系点，并将其关联到通知策略。
3. **映射并推送** — GJSON 会将 status、alertname、severity 和 summary 映射到你的推送中。下一条触发的告警就会让你的手机震动。

## 从触发的面板到锁屏

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. 创建 Pocket Alert Webhook

在 [Webhooks](https://pocketalert.app/zh/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](https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/)，选择 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 设置文档](https://info.pocketalert.app/api/webhooks/settings.html)。

## 常见问题

### 如何将 Grafana 告警发送到手机？

在 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，而不会被拒绝。
