Python
標準ライブラリ(urllib)だけです。どの Python 3 でも動きます。エラー時にはエラーとトレースバックの最後の 20 行を送り、Failed(失敗)のアラートとジョブページに表示されます。例の行(df = ...)は貼り付けたままでも動きます。ご自分のコードに置き換えてください。
コード
これは Code(コード)タブが生成するコードです(開始、エラー、行数 にチェックを入れた状態)。アプリでは、あなたのジョブ専用のアドレスがすでに入っています。
# --- 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)})仕組み
コードはスクリプトの開始時に /start、正常に終わったときに行数付きでそのままのアドレス、失敗したときに /fail を ping し、エラーとトレースバックの最後の 20 行を送ります。
一部を省きたい場合は、Code タブでオプションのチェックを外してください。出力を送らず、エラーか終了コードだけを送るには Send output lines(出力行を送信)のチェックを外します。報告できる内容もご覧ください。
Python スクリプトをスケジュールで実行する
Windows では、コマンド プロンプトからタスクを作成します。パッケージをインストールした Python(where python で確認できます)または仮想環境のフルパスを使ってください。
schtasks /Create /TN "Sales report" /SC DAILY /ST 06:00 /TR "C:\jobs\venv\Scripts\python.exe C:\jobs\sales.py"
Linux や Mac では crontab に 1 行(crontab -e)。
0 6 * * * /home/me/jobs/venv/bin/python /home/me/jobs/sales.py
タスクを手動で起動したときに出力を見たい場合は、pythonw.exe ではなく python.exe を使ってください。
終了コードだけでは足りない理由
捕捉されない例外があると Python は終了コード 1 で終わるので、その種の失敗はスケジューラーにも見えます。見えないのは静かな失敗です。空のクエリ結果、データなしで応答した API、ログに書いてそのまま続行する try/except、マシンの電源が切れていて始まらなかった実行などです。
上のコードはエラーメッセージとトレースバックの最後の 20 行を付けて /fail を送り、その後で例外を再送出するので、終了コードは正しいままです。始まらなかった実行は Missed(未実行)と表示されます。
行数を報告する
最後の行は len(df) を送ります。df を自分の結果(pandas の DataFrame、行のリスト、insert が返した数値)に置き換えてください。数値を増やす場合は同じ JSON に入れます。
tb_ping("", {"rows": len(df), "total": float(df["amount"].sum())})
このコードは標準ライブラリ(urllib)だけを使うので、requests がなくても動きます。
よくある問題
- スケジューラーで実行したときだけ ModuleNotFoundError になる。 タスクが別の Python を実行しています。タスクの実行先を venv の
python.exeにしてください。 - 相対パス。 相対パスはスクリプトのフォルダーではなく、タスクの Start in(開始)フォルダーが基準になります。パスは
pathlib.Path(__file__).parentから組み立ててください。 - SSL: CERTIFICATE_VERIFY_FAILED。 HTTPS を検査する社内プロキシは独自の証明書を使います。IT 部門にその証明書をもらうか、IT 部門が用意した Python でスクリプトを実行してください。
- ネットワーク ドライブ。 ログアウト中に実行されるタスクからは、割り当てたドライブ文字が見えません。UNC パスを使ってください。
ユースケース: Python の cron ジョブや定期スクリプトが失敗したときにアラートを受け取る · SPSS Statistics の本番ジョブが失敗したときにアラートを受け取る · 定期実行の AI エージェントや LLM ジョブを監視する · AI ジョブが空の回答や短すぎる回答を返したときにアラートを受け取る · ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る · 日次のテーブルやファイルが新しいことを確認する · 昨夜のバックアップが存在し、空でないことを確認する。その他のご質問: FAQ