# Kubernetes 告警 直达手机 。

> 把 Kubernetes 告警发送到你的手机。将 Alertmanager 的 webhook_config 指向 Pocket Alert，CrashLoopBackOff 或 OOMKilled 会在一秒内以推送通知的形式送达。

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

最后更新：2026-08-11

CrashLoopBackOff 的 Pod、OOMKilled 的容器、发布失败或 NotReady 的节点，都会变成你手机上的一条推送，命名空间和 Pod 名称直接显示在屏幕上。无需一直盯着 kubectl，也能及时发现集群问题。

## 从 Alertmanager 到手机，三步搞定

1. **获取接收 URL** — 创建一个带 GJSON 消息模板的 Pocket Alert Webhook，并复制它的接收 URL。
2. **配置 Alertmanager** — 在 Alertmanager 中添加一个 webhook_configs 接收器，并将关键告警路由到它。
3. **上线运行** — 下一条触发的告警会在一秒内推送到你的手机。调整路由时，可以继续优化 GJSON 模板。

## 从触发告警到手机

保留你已在运行的 Alertmanager，Pocket Alert 会将其 Webhook 输出转为手机上的推送通知。

- **原生 webhook_config** — Alertmanager 原生支持 webhook_config 接收器。将其指向你的应用 URL 即可完成配置。
- **GJSON 字段映射** — GJSON 从 JSON 中提取 alertname、namespace、pod 和 severity，生成易读的标题和消息。
- **内联显示状态与严重程度** — 直接显示状态和严重程度，使触发的严重告警与已恢复通知的显示有所区别。
- **Pod 与节点事件** — 捕获 CrashLoopBackOff、OOMKilled、发布失败、NotReady 节点以及 PVC 已满等事件。
- **按集群划分渠道** — 独立应用让 prod 和 staging 各自拥有独立的通知渠道，每个渠道都有自己的 Webhook URL。
- **亚秒级送达** — Alertmanager 触发后，推送可在一秒内送达。集群内无需额外代理。

## 将 Kubernetes 告警发送到你的手机

### 1. 创建 Pocket Alert Webhook

在 [Webhooks](https://pocketalert.app/zh/webhooks) 页面创建一个 Webhook，其 GJSON `message` 模板用于读取 Alertmanager 载荷（顶层的 `status` 和 `commonLabels`，以及 `alerts` 数组）：

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

你会获得一个入站 URL，例如 `https://p4a.me/wh/1234abcd`。每个集群使用一个 Webhook，以便将 prod 和 staging 分开。

### 2. 将 Alertmanager 指向它

添加一个 `webhook_configs` 接收器，并将关键告警路由到该接收器（[Alertmanager 文档](https://prometheus.io/docs/alerting/latest/configuration/#webhook_config)）：

```
receivers:
  - name: 'pocketalert'
    webhook_configs:
      - url: 'https://p4a.me/wh/1234abcd'

route:
  receiver: 'pocketalert'
  group_by: ['alertname', 'namespace']
```

Alertmanager 会 POST 其标准 JSON；上面的 GJSON 路径会把 status、alertname、severity、namespace 和 pod 提取到推送内容中。告警解除后，`status` 会变为 `resolved`。

### 3. 或从控制器 / kubectl 发送 POST 请求

控制器或一次性脚本可以直接调用消息 API，并附带 Token 请求头：

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"CrashLoopBackOff","level":"critical","message":"api-7c9 in prod, 12 restarts","application_id":"qm47b9pzxzxg"}'
```

所有 GJSON 路径和 Webhook 选项详见 [Webhook 设置文档](https://info.pocketalert.app/api/webhooks/settings.html)。

## 常见问题

### 如何将 Kubernetes 告警发送到 Pocket Alert？

在 Alertmanager 中添加一个 webhook_configs 接收器，指向你的 Pocket Alert 接收 URL https://p4a.me/wh/1234abcd。触发的 CrashLoopBackOff 或 OOMKilled 告警就会变成一条推送通知。

### Pocket Alert 如何解析 Alertmanager 载荷？

GJSON 字段映射会读取 Alertmanager 的 JSON。将 commonLabels.alertname 提取到标题中，将 alerts.0.labels.namespace 和 alerts.0.labels.pod 提取到正文中，这样命名空间和 Pod 会直接显示在屏幕上，而不是原始载荷。

### 能否区分触发告警和已恢复告警？

载荷中包含 status（firing 或 resolved）和 commonLabels.severity。在 GJSON 消息模板中同时引用两者，这样触发的严重告警和恢复通知的显示就会不同。

### 如何区分 prod 和 staging 集群？

为 prod 和 staging 分别创建独立的 Pocket Alert 应用，每个应用都有自己的 Webhook URL。将不同的 Alertmanager 路由分别指向它们，这样 staging 中的 NotReady 节点就不会和 prod 混淆。

### 集群中是否需要运行代理？

不需要。你已经在运行 Alertmanager，Pocket Alert 在集群内不需要任何额外组件。控制器或脚本也可以直接向 https://api.pocketalert.app/v1/messages 发送 POST 请求，并附带 Token 请求头。

### 能否将告警严重程度映射为通知优先级？

可以。每条消息都支持一个级别：silent、low、default、high 或 critical。在 Webhook 载荷中加入 "level" 字段，或在 Webhook 本身设置 default_level；载荷中明确指定的级别始终优先。常见的做法是 firing=critical，resolved=silent：触发的告警会在 Android 上突破勿扰模式，并在 iPhone 上以时效性通知送达，而恢复通知则安静地保存在历史记录中。无效值会回退为 default，而不会被拒绝。
