# 第一时间 cron 任务失败的那一刻 。

> cron 任务或定时任务失败时，立刻收到推送通知。只需在 crontab 或 systemd timer 中加一行，失败告警不到一秒就能送达你的手机。

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

最后更新：2026-10-17

Pocket Alert 会在 cron 任务失败的瞬间，向你的手机发送推送通知。在任意定时命令后用 && 或 || 接上一行代码：可在失败、成功时触发，或两者兼有，推送会在任务退出时到达，并附带错误输出。

## cron 失败告警的三个步骤

1. **获取 URL 或 CLI** — 复制应用的 Webhook URL，或安装 Pocket Alert CLI。
2. **添加一行** — 在 cron 行后接上 curl 调用或 pocketalert send，失败用 ||，成功用 &&。
3. **收到告警** — 运行任务。如果失败，你的手机会震动，显示你设置的标题和错误输出。

## 再也不错过失败的任务

导入失败时应立即通知你，早于你打开日志的几个小时。

- **crontab 中只需一行** — 在任意 cron 行后用 && 或 || 接上推送。只需一次 curl 调用，无需守护进程。
- **只在失败时告警** — 使用 ||，只有命令以非零状态码退出时才会触发告警。
- **包含错误信息** — 把 stderr 或退出码通过管道传入消息，推送到达时错误信息已经附在其中。
- **适用任何调度器** — crontab、systemd 定时器、Laravel 调度器、Sidekiq 和 K8s CronJob 都可以使用，因为它们都能运行命令。
- **成功时发送心跳** — 每次成功运行后发送心跳。心跳停止到达时，你就知道任务已悄悄停止，可以着手排查。
- **任务结束即时送达** — 推送会在任务退出时送达，早于任何人查看日志的时间，可能早好几个小时。

## 在 cron 任务中接入告警

### 安装并认证 CLI

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

### 仅在任务失败时告警

使用 `||` 串联告警，使其只在退出码非零时触发：

```
0 3 * * * /usr/local/bin/mybackup.sh || pocketalert send \
  -t "Cron failed: mybackup" -m "Exited non-zero at $(date)"
```

### 附带错误输出

```
0 3 * * * /usr/local/bin/mybackup.sh 2>/tmp/cron.err || pocketalert send \
  -t "Cron failed: mybackup" -m "$(tail -n 3 /tmp/cron.err)"
```

### 成功时发送心跳

成功运行后用 `&&` 添加一次心跳推送。心跳停止到达时，说明任务已悄悄停止：

```
0 3 * * * /usr/local/bin/mybackup.sh && pocketalert send "Cron OK: mybackup" "Finished cleanly"
```

### 没有 CLI？用 curl 调用 API

```
0 3 * * * /usr/local/bin/mybackup.sh || curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Cron failed: mybackup","message":"Exited non-zero","level":"high"}'
```

[文档](https://info.pocketalert.app/getting-started.html)介绍了目标设置和各应用的渠道配置。

## 常见问题

### 如何获取 cron 任务的告警？

在 shell 中把通知接在 cron 命令后面。`&&` 在成功运行后触发，`||` 在失败后触发，任务退出时 Pocket Alert 会发送推送通知。

### 能否只在失败时告警？

使用 `||`，这样只有命令以非零状态码退出时才会触发告警：`mybackup.sh || curl ...`。出错的任务会通知你，其余的保持安静。

### 能否附带错误输出？

可以。捕获退出码或输出，放进消息正文即可。Pocket Alert CLI 可以把 stderr 直接通过管道传入通知。

### 除了 crontab 还能用吗？

可以，任何调度器都行：crontab、systemd 定时器、Laravel 调度器、Rails 或 Sidekiq 的 cron、Windows 任务计划程序、Kubernetes CronJob。只要能运行命令，就能在后面接上告警。

### 能否发现从未运行的任务？

每次成功运行后用 `&&` 发送一次完成心跳。心跳一旦停止到达，你就知道任务已经不再运行，无需额外工具。

### 失败的夜间任务能否唤醒我，而成功心跳保持静音？

在失败告警中加上 level=critical，它会在 Android 上突破勿扰模式，在 iPhone 上穿透专注模式。心跳推送则使用 level=silent，它们会静音进入历史记录，记录有了，手机依旧安静。
