定期スクリプトのハートビート監視(デッドマンスイッチ)
ハートビート監視は、デッドマンスイッチやプッシュ型監視とも呼ばれ、いつもの問いを逆にします。ジョブが失敗したかどうかを確認するのではなく、実行のたびにジョブから連絡が来ることを期待し、連絡がないことをアラームにします。以下では、cron ジョブや定期スクリプトでの仕組み、開始と失敗の ping で何が加わるか、猶予時間の選び方を説明します。
ジョブのデッドマンスイッチの仕組み
従来の監視はプル型です。サーバーが毎分ウェブサイトを確認し、応答がなければアラートを出します。定期スクリプトはこの方法では確認できません。実行と実行の間には、問い合わせる相手がいないからです。そこでジョブの側からプッシュします。
- 監視側にスケジュールを伝えます。「毎日 06:00」「15 分ごと」。
- 実行が終わるたびに、固有の URL を呼び出します。そのリクエストがハートビートです。
- 予定時刻と猶予時間を過ぎてもハートビートが届かなければ、監視側がアラートを出します。
これで、何も痕跡を残さない失敗を捕まえられます。電源が切れていたマシン、変更後にマッチしなくなった crontab の行、永遠に止まったままのジョブ、再起動後に起動しなかった cron サービス。しかもマシンには、HTTPS リクエストを 1 回送れること以外、何も必要ありません。Healthchecks.io や TaskBeacon のようなサービスはこの方式で動いています。OnlineOrNot の cron 監視ガイド(2026年)も同じパターンを説明しています。
開始、失敗、データ:「実行された」以上のこと
ハートビートだけでは「実行が終わった」としかわかりません。3 つを加えると、ずっと役に立つようになります。
- 開始の ping(
/start)があると、監視側が各実行の時間を測れます。始まったものの、いつもよりずっと長くかかっている実行は、1 時間後に Missed(未実行)になるのではなく、止まっているうちに Late(遅延)になります。 - 失敗の ping(
/fail、または URL の末尾に付ける終了コード)があると、猶予時間が切れるのを待たずに、エラーをメッセージ付きですぐに報告できます。 - 数値(
?rows=48210など)があると、「成功」したのにデータがなかった実行を捕まえられます。行数が最近の実行より 40% 以上減るか 0 になると、TaskBeacon は Odd data(異常データ)でアラートを出します。
cron ジョブのハートビート
cron なら、スクリプトに手を入れる必要はありません。この crontab の行は、開始の ping を送り、ジョブを実行し、アドレスの末尾に終了コードを付けて報告します(/0 は OK、それ以外の数値は失敗)。
# crontab -e (this example runs every day at 06:00)
0 6 * * * curl -fsS -m 10 https://taskbeacon.io/ping/your-job-id/start >/dev/null; /path/to/your-job.sh; curl -fsS -m 10 "https://taskbeacon.io/ping/your-job-id/$?" >/dev/nullアプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
最後の curl が成功するので、この行自体は常に 0 で終了しますが、TaskBeacon には失敗が記録されます。-m 10 で各 ping を 10 秒までに制限しているので、ネットワークの問題でジョブが止まることはありません。Windows では PowerShell ラッパーを、スクリプトにはその言語用のコード、たとえばエラーメッセージも送る Python のコードを使ってください。
猶予時間の選び方
猶予時間とは、予定時刻のあと、実行が未実行とみなされるまでに報告できる時間です。短すぎると、遅い夜に誤報が出ます。長すぎると、本当の問題を知るのが遅れます。ジョブのいつもの所要時間に余裕を足したものから始めるのがよいでしょう。何回か実行すると、TaskBeacon が実際の実行をカバーできたはずの猶予時間を提案します。猶予時間をご覧ください。
サービスを使わない場合
小さなデッドマンスイッチは自分で作れます。各ジョブがファイルに触れるか、タイムスタンプ付きの行を書き込み、別のチェッカー(もう一つの cron ジョブ)がタイムスタンプが想定より古ければアラートを出します。これで動きますが、チェッカーはジョブのマシンが止まっても動き続ける場所で動かす必要があり、独自のアラートの仕組みが必要で、そのチェッカーを見張る人はいません。ホスト型のハートビートサービスは、誰かが代わりに動かしてくれるそのチェッカーです。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
ドキュメント:はじめに · 猶予時間 · Linux cron
- 定期ジョブがまったく実行されなかったことを知る行われなかった実行にはエラーがないため、アラートのきっかけがありません。
- Python の cron ジョブや定期スクリプトが失敗したときにアラートを受け取るcron が知らせるのは出力で、成功か失敗かではありません。Task Scheduler の 0x1 は誰も見ていません。
- 昨夜のバックアップが存在し、空でないことを確認するバックアップは実行されましたが、作られたファイルは 0 KB です。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- OnlineOrNot: Cron job monitoring guide(ハートビート ping の解説) (2026年3月3日更新)
- Healthchecks.io docs: ping URLs, period and grace time (日付なし、© 2015–2026、2026年11月9日に確認)
- man7.org: cron(8), cronie (ページは2013年、2026年の upstream の cronie と一致)
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。