Python の cron ジョブや定期スクリプトが失敗したときにアラートを受け取る
Python スクリプトが毎晩 cron または Windows の Task Scheduler から実行されています。例外が発生すると、トレースバックは誰も読まないログやメールボックスに行き、データがないことで初めて気づきます。スクリプトに数行加えれば、そのトレースバックがあなたに届くようになり、スケジュールによって止まった実行や始まらなかった実行も捕まえられます。
Python は失敗を報告するが、スケジューラーがそれを抱え込む
捕まえられなかった例外があると、Python はステータス 1 で終了します(sys.exit とインタープリタのメインループについての Python のドキュメントに書かれているとおり、0 は成功、それ以外は異常終了です)。つまりスケジューラーは知っています。それをどう扱うかというと:
- cron は終了ステータスをまったく見ません。マシンに動作するメールプログラムがあれば、ジョブの出力を crontab の所有者か
MAILTOにメールで送ります。メールプログラムがなければ、cronie は出力を syslog に書きます。出力をファイルにリダイレクトしたまま失敗したスクリプトは、どこにも何も送りません。 - Task Scheduler は Last Run Result(前回の実行結果)列に
0x1と表示するだけです。「How to fix (0x1) error in task scheduler that runs a python script」(Microsoft Q&A、2023年)のようなフォーラムのスレッドは、何日も経ってから誰かが気づいたところから始まります。
例外にならない失敗もあります。ログを書いて処理を続ける try/except、空のリストを返す API、新しい行を見つけないクエリ。Python は 0 で終了し、スケジューラーは満足します。そして一度も始まらなかった実行(マシンの電源が切れていた、cron デーモンが止まっていた、crontab のパスが間違っていた)は、どんなステータスも残しません。
スクリプトから報告する
下のコードは標準ライブラリ(urllib)だけを使うので、どの Python 3 でも、どの仮想環境でも動きます。開始時に TaskBeacon に ping を送り、例外が起きるとエラーとトレースバックの最後の 20 行付きで /fail を送ってから例外を再送出するので、終了ステータスは 1 のままです。最後に行数を送ります。
# --- TaskBeacon: top of the script (standard library only) ---
import json, traceback, urllib.request
TB = "https://taskbeacon.io/ping/your-job-id"
def tb_ping(path="", data=None):
body = json.dumps(data).encode() if data else None
req = urllib.request.Request(TB + path, data=body, headers={"Content-Type": "application/json"})
try:
urllib.request.urlopen(req, timeout=10)
except Exception as e:
print("TaskBeacon ping failed:", e)
tb_ping("/start")
try:
# --- your code here ---
df = [1, 2, 3] # example data: replace with your own (e.g. pandas.read_csv)
except Exception as e:
# the error and the last 20 lines of the traceback go with the failure
tb_ping("/fail", {"error": f"{type(e).__name__}: {e}"[:200],
"log": "\n".join(traceback.format_exc().splitlines()[-20:])[-4000:]})
raise
# --- TaskBeacon: end of the script ---
tb_ping("", {"rows": len(df)})アプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
例の行をあなたのコードに置き換え、結果を df(pandas の DataFrame または行のリスト)に入れておくか、別の数値を送ってください。ping が失敗した場合はメッセージを表示し、スクリプトはそのまま続行します。監視がジョブを壊すことはありません。
cron ジョブの場合、crontab の行はそのままです。
0 6 * * * /home/me/jobs/venv/bin/python /home/me/jobs/sales.py >> /home/me/jobs/sales.log 2>&1
スクリプトに手を入れたくなければ、cron の行で代わりに終了コードを報告できます(トレースバックと行数はなし)。
得られるもの
- Failed(失敗):例外とトレースバックの末尾付き。たとえば
KeyError: 'amount'が、メール、Slack、Teams に届きます。 - Missed(未実行):予定時刻と猶予時間までに ping が届かなかった場合。マシンの電源が切れていた、cron が動いていなかった、crontab の打ち間違いなど。
- Late(遅延):スクリプトが始まったものの、いつもよりずっと時間がかかっている場合。たとえばタイムアウトのないリクエストが永遠に待っているときです。
- Odd data(異常データ):行数が 40% 以上減った場合、または 0 の場合。
TaskBeacon を使わない場合
Linux では、メールプログラムをインストールして設定し、MAILTO を設定し、スクリプトがエラーのときだけ出力するようにすれば、cron はまさにそのときにメールを送ってくれます。Windows では、最上位に try/except を追加し、例外を再送出する前に smtplib でメールを送ります。どちらも例外はカバーします。どちらも一度も始まらなかった実行はカバーしません。それには、ジョブからのシグナルを待つ仕組み、つまりハートビートチェックか、毎朝最初のジョブの出力を確認する 2 つ目のジョブが必要です。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
ドキュメント:Python · Linux cron · ステータス
- 定期スクリプトのハートビート監視(デッドマンスイッチ)ジョブは実行のたびに報告します。沈黙こそがアラートです。
- 定期実行の R スクリプトが失敗したことを知るtaskscheduleR も cron もログを書きますが、何か問題が起きるまで誰も読みません。
- ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る終了コード 0 は、何行届いたかについて何も語りません。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- Python docs: Py_RunMain(未処理の例外で 1 を返す) (Python 3.15 のドキュメント、日付なし、2026年11月9日に確認)
- Python docs: sys.exit(0 は成功、0 以外は異常終了) (Python 3.15 のドキュメント、日付なし、2026年11月9日に確認)
- man7.org: crontab(5), cronie (MAILTO) (ページは2012年、2026年の upstream の cronie と一致)
- man7.org:cron(8)、cronie(出力はメールで送られ、sendmail がなければ syslog へ) (ページは2013年、2026年の upstream の cronie と一致)
- Microsoft Q&A:Python スクリプトを実行する Task Scheduler の (0x1) エラーを直す方法 (2023年8月28日、古い:需要の表れ)
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。