cron とスケジュールジョブ

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

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

終了コードで通知1 行追加 · 常駐不要cron · systemd · K8s 更新
機能

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

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

crontab に 1 行追加

どの cron 行にも && や || でプッシュ通知を連結できます。curl を 1 回呼び出すだけで、常駐プロセスの管理は不要です。

失敗時のみ通知

|| を使うと、コマンドが 0 以外で終了したときだけ通知されます。

エラー内容を含める

stderr や終了コードをメッセージに渡すと、エラー内容が添付された状態で通知が届きます。

あらゆるスケジューラーに対応

crontab、systemd タイマー、Laravel スケジューラー、Sidekiq、K8s CronJob のすべてに対応します。いずれもコマンドを実行するため、同じ方法で連携できます。

成功時のハートビート

成功時にハートビートを送信します。通知が届かなくなったら、ジョブが静かに止まったと分かり、原因を調べられます。

終了と同時に即時通知

ジョブが終了した瞬間にプッシュ通知が届きます。ログを確認するよりずっと早く分かります。

はじめ方

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

1

URL または CLI を取得

アプリケーションの受信 Webhook URL をコピーするか、Pocket Alert CLI をインストールします。

2

1 行追加

cron の行に curl または pocketalert send を連結します。失敗時は || を、成功時は && を使います。

3

通知を受け取る

ジョブを実行します。失敗すると、設定したタイトルとエラー出力を添えてスマホが通知で知らせます。

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"}'

宛先の指定やアプリケーションごとのチャンネルについては、ドキュメントをご覧ください。

FAQ

よくある質問

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

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

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

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

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

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

静かに壊れていた cron ジョブを見逃さないために。

crontab に 1 行追加するだけで、ジョブが異常終了した時点でスマホに通知が届きます。