Kubernetes

Kubernetes 告警 直达手机。

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

推送延迟 <1 秒原生支持 webhook_configsCrashLoopBackOff · OOMKilled · NotReady更新于
功能

从触发告警到手机

保留你已在运行的 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 到手机,三步搞定

1

获取接收 URL

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

2

配置 Alertmanager

在 Alertmanager 中添加一个 webhook_configs 接收器,并将关键告警路由到它。

3

上线运行

下一条触发的告警会在一秒内推送到你的手机。调整路由时,可以继续优化 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,而不会被拒绝。

让集群告警不再只留在电脑上。

在 webhook_config 中填入你的应用 URL,下一条触发的告警就会推送到你的手机。