# 第一时间知道 服务器何时宕机 。

> 服务器宕机时立即收到推送通知。通过 Webhook 接入 Grafana、Prometheus 或 UptimeRobot，不到一秒就能在手机上收到告警。

<!-- source: https://pocketalert.app/zh/use-cases/server-monitoring -->

最后更新：2026-08-11

Pocket Alert 将服务器监控告警转化为 iPhone 或 Android 上的推送通知。把 Grafana、Prometheus、UptimeRobot 或普通的 cron 健康检查接入一个 Webhook URL，告警就能在一秒内送达手机，无需在服务器上安装代理，也不必翻找邮件摘要。

## 三步收到你的第一条服务器告警

1. **设置 Pocket Alert** — 安装 pocketalert CLI 并运行 pocketalert auth YOUR_API_KEY，或创建一个用于转发的 Webhook。
2. **接入监控** — 添加 cron 健康检查、Netdata custom_sender，或将 Alertmanager 的 webhook_config 指向接收 URL。
3. **接收告警** — 触发一条测试告警，稍后你的手机就会震动。通过字段映射微调通知内容。

## 从指标飙升到你的手机

将监控指向一个 Webhook URL，每条告警都会在一秒内送达你的手机。

- **兼容你现有的技术栈** — Grafana、Prometheus、UptimeRobot、Datadog 和 Zabbix 一旦触发 Webhook，就能送达你的手机。
- **亚秒级送达** — 推送在一秒内到达，比第一个用户投诉还快。
- **字段映射（GJSON）** — 将 JSON 负载字段映射到标题和内容。告警名称和严重级别会一并体现在通知中。
- **脚本或 Webhook** — 无论是 cron 健康检查，还是转发过来的 Alertmanager 告警，都以相同的方式送达你的手机。
- **按应用划分通道** — 为 prod、staging 和 homelab 分别设置独立的通道。
- **无需代理** — Pocket Alert 直接接收你的监控系统已经发出的 Webhook，被监控的机器无需运行任何额外程序。

## 配置你的监控

### 1. 通过 cron 运行的 bash 健康检查

安装 CLI，登录一次，然后请求服务。如果服务没有响应，就发送推送。

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

```
#!/usr/bin/env bash
URL=https://api.example.com/health
if ! curl -fsS --max-time 10 "$URL" >/dev/null; then
  pocketalert send -t "API DOWN on $(hostname)" -m "$URL did not respond"
fi
```

通过 cron 每分钟运行一次。

```
* * * * * /usr/local/bin/check-health.sh
```

### 2. 或使用 Netdata 告警钩子

在 `custom_sender()` 中添加 `health_alarm_notify.conf`（通过 `sudo ./edit-config health_alarm_notify.conf` 编辑），让每条 Netdata 告警都发送到消息 API。

```
custom_sender() {
  curl -X POST 'https://api.pocketalert.app/v1/messages' \
    -H 'Token: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d "{\"title\":\"${name} is ${status} on ${host}\",\"message\":\"${chart}.${family}: ${value_string}\",\"level\":\"critical\"}"
}
```

### 3. 或通过 Webhook 转发 Alertmanager

在 [Webhook](https://pocketalert.app/zh/webhooks) 页面创建一个带 GJSON 模板的 Webhook，然后将接收 URL 添加到 Prometheus Alertmanager 的 `webhook_config` 中。

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Alertmanager","application_id":"qm47b9pzxzxg","message":"%status%: %alerts.0.labels.alertname% — %alerts.0.annotations.summary%"}'
```

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

GJSON 路径列在[文档](https://info.pocketalert.app/api/webhooks/settings.html)中。

## 常见问题

### 服务器监控告警是如何工作的？

Pocket Alert 为每个应用提供一个接收 Webhook 的 URL。把 Grafana、Prometheus Alertmanager、UptimeRobot、Datadog 或 Zabbix 等监控工具指向这个 URL，它触发的告警会在一秒内变成你手机上的推送通知。

### 我可以自定义告警内容吗？

可以。用 GJSON 路径映射传入 JSON 中的字段，即可设置通知的标题和内容。Alertmanager 告警的名称、状态和严重级别会完整保留。

### 支持哪些监控工具？

只要工具会在告警时发出 HTTP 请求就可以使用，包括 Grafana、Prometheus Alertmanager、UptimeRobot、Datadog、Zabbix、Netdata、Uptime Kuma，以及自定义的健康检查脚本。

### 如何避免告警疲劳？

服务器宕机时发一条推送，恢复时再发一条。按应用划分的通道可以把 prod、staging 和个人基础设施分开，让紧急告警不被大量普通消息淹没。

### 我需要在服务器上安装代理吗？

无需安装任何代理。Pocket Alert 接收你的监控系统本来就会发出的 Webhook，被监控的服务器上不需要额外运行任何程序。

### 服务器宕机告警能在夜间穿透勿扰模式吗？

可以。发送告警时设置 level: critical，Android 上它会绕过勿扰模式，iPhone 上则会以时效性通知的形式穿透专注模式。恢复消息保持默认或静默，这样只有故障本身会发出提醒。级别从静默（-2）到关键（2），可在 API、Webhook 负载中使用，也可以作为每个 Webhook 的默认设置。
