ユースケース
定期ジョブが派手に失敗することはめったにありません。以下の各ページでは、よくある問題を一つずつ取り上げ、なぜ起きるのかを説明し、TaskBeacon を使う場合と使わない場合の両方で、その問題のアラートを受け取る方法を紹介します。
未実行と、何も報告しない実行
定期ジョブがまったく実行されなかったことを知る行われなかった実行にはエラーがないため、アラートのきっかけがありません。定期スクリプトのハートビート監視(デッドマンスイッチ)ジョブは実行のたびに報告します。沈黙こそがアラートです。
スクリプトとスケジューラー
バッチモードで Stata の do ファイルが失敗したときにアラートを受け取るStata の /e や -b は、do ファイルの失敗をスケジューラーに伝えません。Task Scheduler の Last Run Result は 0x0 なのに、スクリプトは失敗したLast Run Result 0x0 は、起動したプログラムが 0 を返したことしか意味しません。Task Scheduler はもうメールを送れません:タスクが失敗したときにアラートを受け取る標準のメール送信操作はなくなり、イベントで起動するタスクは、起きなかった実行を見逃します。PowerShell スクリプトのエラーと Task Scheduler の終了コード終了しないエラーでは終了コードが 0 のまま。-Command はコードを 0 か 1 にまとめてしまいます。定期実行の R スクリプトが失敗したことを知るtaskscheduleR も cron もログを書きますが、何か問題が起きるまで誰も読みません。Python の cron ジョブや定期スクリプトが失敗したときにアラートを受け取るcron が知らせるのは出力で、成功か失敗かではありません。Task Scheduler の 0x1 は誰も見ていません。SAS のバッチジョブがエラーで終了したときにアラートを受け取るSAS は警告で 1、エラーで 2 を返しますが、それも誰かが見ていればの話です。SPSS Statistics の本番ジョブが失敗したときにアラートを受け取るプロダクションジョブはエラーの後も続行することがあり、証拠はログだけです。Database Mail なしで SQL Server Agent ジョブの失敗アラートを受け取るAgent のメール通知には Database Mail、オペレーター、再起動が必要で、実行されなかったジョブについては何も知らせてくれません。Task Scheduler で実行する Excel VBA マクロを監視する無人で動く Excel は、失敗するより、ダイアログで止まったままになりがちです。
データ品質
ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る終了コード 0 は、何行届いたかについて何も語りません。日次のテーブルやファイルが新しいことを確認する「成功」したのに、昨日のデータをもう一度読み込んだだけの処理。昨夜のバックアップが存在し、空でないことを確認するバックアップは実行されましたが、作られたファイルは 0 KB です。
BI とパイプライン
チーム全員への Power BI 更新失敗の通知失敗のメールだけ、スケジュール更新だけ、テナント内だけ。SharePoint にファイルが 8:00 までに届かないときにアラートを受け取るトリガーはファイルが届いたときに動きます。届かなければ何も動きません。dbt Cloud ジョブの失敗アラートと、開始されなかった実行dbt は実行について通知しますが、開始されなかった実行は何も送りません。
ウェブサイト
SSL 証明書やドメインの期限が切れる前にアラートを受け取る証明書の有効期間は短くなり、Let's Encrypt からのリマインダーメールもなくなりました。ウェブサイトがダウンしたり遅くなったりしたときにアラートを受け取るダウン、想定外のステータス、テキストの欠落、通常よりかなり遅い応答。
AI ジョブとエージェント
定期実行の AI エージェントや LLM ジョブを監視するAI ジョブは「成功」しても何もしていないことがあります。昨夜何が失敗したかを Claude や ChatGPT に質問する1 つの質問で、すべてのマシンのすべてのジョブがわかります。AI ジョブが空の回答や短すぎる回答を返したときにアラートを受け取る終了コード 0 でも回答が空なら、それは壊れた実行です。
その他
料金、プライバシー、ping の仕組みについての質問はよくある質問にあります。各言語のセットアップはドキュメントにあり、まずは Python からどうぞ。