从监控越界到锁屏通知
Datadog 在监控越界时已经会发出 Webhook。Pocket Alert 将它变成你无法错过的手机推送。
无缝接入 Datadog Webhook
在 Datadog 的 Webhooks 集成中注册 Pocket Alert,然后在任意监控中使用 @webhook-pocketalert 调用它。
模板变量输入,GJSON 输出
Datadog 模板变量填充 JSON 正文,Pocket Alert 中的 GJSON 路径将事件标题、消息和状态变化提取到你的通知中。
触发与恢复,一目了然
映射 $ALERT_TRANSITION,让触发和恢复的监控在锁屏上就显示不同内容。
每个环境一个通道
每个应用都有独立的 Webhook URL,因此基础设施、APM 和各团队的监控会保持在不同通道中。
亚秒级送达
越界告警在一秒内到达你的手机,远早于升级策略启动。
Webhook URL 即密钥
Webhook URL 本身就是你的应用密钥,通过 HTTPS 传输。需要新的端点时,随时轮换即可。
三步让 Datadog 告警推送到你的手机
创建 Webhook
使用 GJSON message 模板创建一个 Pocket Alert Webhook,并复制它的接收 URL。
配置 Webhook
在 Datadog 的 Webhooks 集成中注册该 URL,配置自定义 $EVENT_TITLE / $TEXT_ONLY_MSG 载荷,然后在监控中调用它。
映射并推送
GJSON 将事件标题、消息和状态变化映射到你的推送中。下一次触发时,你的手机就会震动。
将 Datadog 告警发送到你的手机
1. 创建 Pocket Alert Webhook
在 Webhooks 页面创建一个 Webhook,并使用 GJSON message 模板映射你将发送的 Datadog 载荷。你也可以通过 API 创建:
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Datadog","message":"%event_title% — %alert_transition%\n%body%\n%link%","application_id":"qm47b9pzxzxg"}'
你会得到一个类似 https://p4a.me/wh/1234abcd 的入站 URL。上面的 GJSON 路径(%event_title%、%alert_transition%、%body%、%link%)会读取 Datadog 在下一步 POST 的 JSON 键。
2. 在 Datadog 中注册 Webhook
前往 集成 → Webhooks,添加一个新 Webhook。粘贴接收 URL,并使用 Datadog 模板变量定义自定义载荷:
Name: pocketalert
URL: https://p4a.me/wh/1234abcd
Payload: {
"event_title": "$EVENT_TITLE",
"body": "$TEXT_ONLY_MSG",
"alert_transition": "$ALERT_TRANSITION",
"level": "critical",
"link": "$LINK"
}
3. 在监控中调用
在监控消息中添加 @webhook-pocketalert。监控触发时,Datadog 会 POST 上面的载荷;Pocket Alert 渲染 GJSON 模板并推送。恢复时会发送 $ALERT_TRANSITION = Recovered,因此同一告警在恢复后会显示 "Recovered"。
Webhook 设置文档介绍了所有 GJSON 路径和 Webhook 选项。
常见问题解答
创建一个 Pocket Alert Webhook,复制它的接收 URL,然后在 Datadog 的“集成 → Webhooks”中注册。在任意监控消息中调用 @webhook-pocketalert,告警会在一秒内到达你的手机。
在 Datadog Webhook 中,你可以用 $EVENT_TITLE、$TEXT_ONLY_MSG、$ALERT_TRANSITION 和 $LINK 等模板变量定义 JSON 正文。Pocket Alert 使用 GJSON 路径读取该 JSON,因此你的消息模板可以把这些字段映射到推送通知的标题和正文中。
可以。在载荷中包含 $ALERT_TRANSITION(Triggered / Recovered)或 $ALERT_TYPE,并在消息模板中引用它,这样触发和恢复的监控会显示不同内容。如果你想在文本中显示,Datadog 还提供 $PRIORITY 和 $ALERT_STATUS。
为每个环境或团队注册一个 Webhook,并在各个监控中引用对应的 Webhook。生产和预发布环境会进入不同的通道,你可以分别静音。
无需在主机上安装任何东西。Pocket Alert 接收的是 Datadog 监控引擎发出的 Webhook,因此除了你已在运行的 Datadog Agent,不需要额外的 agent。
可以。由于 Webhook 载荷由你自行定义,可以在 $EVENT_TITLE 旁边添加一个 "level" 字段,取值为 silent、low、default、high 或 critical,Pocket Alert 会将其映射为通知优先级。对触发呼叫的监控使用 critical,可以突破勿扰模式;或者在 Webhook 上设置 default_level 并省略该字段。显式设置的 level 始终优先。无效值会回退为 default,而不会被拒绝。