从触发告警到手机
保留你已在运行的 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 触发后,推送可在一秒内送达。集群内无需额外代理。
从 Alertmanager 到手机,三步搞定
获取接收 URL
创建一个带 GJSON 消息模板的 Pocket Alert Webhook,并复制它的接收 URL。
配置 Alertmanager
在 Alertmanager 中添加一个 webhook_configs 接收器,并将关键告警路由到它。
上线运行
下一条触发的告警会在一秒内推送到你的手机。调整路由时,可以继续优化 GJSON 模板。
将 Kubernetes 告警发送到你的手机
1. 创建 Pocket Alert Webhook
在 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 文档):
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 设置文档。
常见问题解答
在 Alertmanager 中添加一个 webhook_configs 接收器,指向你的 Pocket Alert 接收 URL https://p4a.me/wh/1234abcd。触发的 CrashLoopBackOff 或 OOMKilled 告警就会变成一条推送通知。
GJSON 字段映射会读取 Alertmanager 的 JSON。将 commonLabels.alertname 提取到标题中,将 alerts.0.labels.namespace 和 alerts.0.labels.pod 提取到正文中,这样命名空间和 Pod 会直接显示在屏幕上,而不是原始载荷。
载荷中包含 status(firing 或 resolved)和 commonLabels.severity。在 GJSON 消息模板中同时引用两者,这样触发的严重告警和恢复通知的显示就会不同。
为 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,而不会被拒绝。