# 让 Datadog 监控告警 直达你的手机 。

> 把 Datadog 监控告警变成推送通知。将 Pocket Alert 注册为 Webhook，一秒内在手机上收到阈值触发提醒。

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

最后更新：2026-08-11

Datadog 监控触发时，告警及其严重程度会在一秒内到达你的手机。在事件升级为呼叫之前及时发现。

## 三步让 Datadog 告警推送到你的手机

1. **创建 Webhook** — 使用 GJSON message 模板创建一个 Pocket Alert Webhook，并复制它的接收 URL。
2. **配置 Webhook** — 在 Datadog 的 Webhooks 集成中注册该 URL，配置自定义 $EVENT_TITLE / $TEXT_ONLY_MSG 载荷，然后在监控中调用它。
3. **映射并推送** — GJSON 将事件标题、消息和状态变化映射到你的推送中。下一次触发时，你的手机就会震动。

## 从监控越界到锁屏通知

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 告警发送到你的手机

### 1. 创建 Pocket Alert Webhook

在 [Webhooks](https://pocketalert.app/zh/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](https://docs.datadoghq.com/integrations/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 设置文档](https://info.pocketalert.app/api/webhooks/settings.html)介绍了所有 GJSON 路径和 Webhook 选项。

## 常见问题

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

创建一个 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。生产和预发布环境会进入不同的通道，你可以分别静音。

### 还需要另外安装 agent 吗？

无需在主机上安装任何东西。Pocket Alert 接收的是 Datadog 监控引擎发出的 Webhook，因此除了你已在运行的 Datadog Agent，不需要额外的 agent。

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

可以。由于 Webhook 载荷由你自行定义，可以在 $EVENT_TITLE 旁边添加一个 "level" 字段，取值为 silent、low、default、high 或 critical，Pocket Alert 会将其映射为通知优先级。对触发呼叫的监控使用 critical，可以突破勿扰模式；或者在 Webhook 上设置 default_level 并省略该字段。显式设置的 level 始终优先。无效值会回退为 default，而不会被拒绝。
