# その瞬間 cron ジョブが失敗した ら、すぐに通知。

> cron ジョブや定期タスクが失敗したら、プッシュ通知でお知らせ。crontab や systemd timer に 1 行追加するだけで、失敗の通知が 1 秒足らずでスマホに届きます。

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

最終更新日:2026-10-17

Pocket Alert は、cron ジョブが失敗した瞬間にスマホへプッシュ通知を送ります。任意のスケジュールコマンドに && または || で 1 行を連結するだけで、失敗時・成功時・その両方に通知を設定できます。ジョブが終了した時点で、エラー出力を含めて通知が届きます。

## cron の失敗通知は 3 ステップで設定

1. **URL または CLI を取得** — アプリケーションの受信 Webhook URL をコピーするか、Pocket Alert CLI をインストールします。
2. **1 行追加** — cron の行に curl または pocketalert send を連結します。失敗時は || を、成功時は && を使います。
3. **通知を受け取る** — ジョブを実行します。失敗すると、設定したタイトルとエラー出力を添えてスマホが通知で知らせます。

## 失敗したジョブを二度と見逃さない

インポートの失敗は、ログを開くより何時間も前に、すぐ通知で知らせます。

- **crontab に 1 行追加** — どの cron 行にも && や || でプッシュ通知を連結できます。curl を 1 回呼び出すだけで、常駐プロセスの管理は不要です。
- **失敗時のみ通知** — || を使うと、コマンドが 0 以外で終了したときだけ通知されます。
- **エラー内容を含める** — 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 以外のときだけ送信されます。

```
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 ジョブのプッシュ通知はどう設定しますか？

シェルで cron コマンドに通知を連結します。`&&` は成功時、`||` は失敗時に実行され、ジョブが終了した時点で Pocket Alert がプッシュ通知を送信します。

### 失敗したときだけ通知を送ることはできますか？

`||` を使うと、コマンドが 0 以外で終了したときだけ通知されます。例: `mybackup.sh || curl ...`。失敗したジョブだけが知らせてくれ、それ以外は静かなままです。

### エラー出力も通知に含められますか？

はい。終了コードや出力を取得して、メッセージ本文に入れられます。Pocket Alert CLI は stderr をそのまま通知に送ることができます。

### crontab 以外でも使えますか？

どのスケジューラーでも使えます。crontab、systemd タイマー、Laravel スケジューラー、Rails や Sidekiq の cron、Windows タスクスケジューラー、Kubernetes CronJob に対応しています。コマンドを実行するものであれば、通知を連結できます。

### 一度も実行されなかったジョブを検知できますか？

成功するたびに `&&` で完了通知を送ってください。通知が届かなくなったら、ジョブが実行されなくなったと分かります。追加のツールは必要ありません。

### 夜間ジョブが失敗したら起こしてほしい。成功の通知は静かにしたい場合はどうしますか？

失敗時の通知に level=critical を追加すると、Android ではおやすみモードを、iPhone では集中モードを突破して届きます。ハートビート通知には level=silent を使ってください。音を鳴らさず履歴に残るので、記録は残りつつスマホは静かなままです。
