ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る
夜間のインポートは終わり、スケジューラーは成功と言っているのに、テーブルは 0 行です。あるいは、いつもの 48,000 行ではなく 2,140 行です。何も失敗していないので、アラートも出ません。終了コードではこれを捕まえられませんが、実行のたびに行数を送れば捕まえられます。
「成功」が行数について何も語らない理由
スケジューラーはジョブを終了コードで判断しますが、スクリプトの終了コードはクラッシュしたかどうかしか示しません。次のケースはどれも 0 で終わります。
- ソースファイルが空で届いた、または昨日のファイルがまた届いた。
- タイムゾーンや祝日のせいで、クエリの日付フィルタに何も一致しなかった。
- API がエラーではなく空のリストを返した。
- 上流で列名が変わったあと、スクリプトの結合やフィルタでほとんどの行が落ちた。
- 接続文字列にテスト用データベースが残ったままエクスポートが実行された。
ジョブは言われたとおりのことをしただけです。開発者も同じ問題にぶつかっていて(Reddit の「Your job succeeded but did nothing – how do you even catch that?」、2025年)、答えはいつも同じです。ジョブが自分のしたことを報告し、何かがそれをいつもの結果と比べる必要があります。
実行のたびに行数を送る
TaskBeacon では、終了時の ping が数値を運びます。?rows=48210、または JSON です。ジョブが初めてこの数値を送ると、そのジョブに 2 つのルールが付きます。ルールはジョブのページで変更できます。
- Rows below 1(行数が 1 未満):何も読み込まなかった実行は、すぐに Odd data(異常データ)になります。
- Rows drop more than 40% below the recent average(行数が最近の平均より 40% 以上減る):正常な実行が 3 回たまると、直近の正常な実行と比べます。ルールに引っかかった実行は平均に含めないので、一晩の不調が新しい「いつも」になることはありません。
Python では、デフォルトのコードがすでに len(df) を送ります。
# --- 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 の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
数えるのは大事なもの、つまり読み取った行ではなく、ターゲットテーブルに書き込んだ行です。複数のテーブルを読み込むなら、複数の数値を送り({"rows": 48210, "orders": 1830})、それぞれにルールを追加します。独自の数値に対するルールは Pro の機能で、現在は誰でも利用できます。行数のルールはすべてのプランで使えます。独自の数値をご覧ください。同じことは R(nrow(df))、Stata(_N)、SAS、SPSS でもでき、これらのデフォルトのコードも件数を送ります。
アラートの見え方
ジョブは Odd data になり、アラートには理由が 1 行で書かれます。たとえば rows = 2,140, 96% below the recent average of 48,215(rows = 2,140、最近の平均 48,215 より 96% 少ない)。ジョブのページには各実行の行数がいつもの水準と並べて表示されるので、一晩だけの不調か、じわじわ減っているのかがわかります。小さい数値が新しい「いつも」なら、ルールを変更するか、その実行を確認済みにしてください。
TaskBeacon を使わない場合
チェックをジョブに組み込みます。読み込んだあとで行数を数え、0 または決めた最小値未満ならエラーを出して(0 以外で終了して)、スケジューラーから失敗が見えるようにします。dbt プロジェクトなら、モデルに対するデータテストでこれができます。Great Expectations には expect_table_row_count_to_be_between があります。固定の最小値は簡単です。「いつもよりずっと少ない」を判断するには過去の件数の履歴が必要で、それをどこかに保存して平均を計算しなければならず、さらに知らせてもらう方法も必要です。関連:行はあるのに古いケースはデータの鮮度チェックで捕まえられます。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
- 日次のテーブルやファイルが新しいことを確認する「成功」したのに、昨日のデータをもう一度読み込んだだけの処理。
- 昨夜のバックアップが存在し、空でないことを確認するバックアップは実行されましたが、作られたファイルは 0 KB です。
- バッチモードで Stata の do ファイルが失敗したときにアラートを受け取るStata の /e や -b は、do ファイルの失敗をスケジューラーに伝えません。
- Database Mail なしで SQL Server Agent ジョブの失敗アラートを受け取るAgent のメール通知には Database Mail、オペレーター、再起動が必要で、実行されなかったジョブについては何も知らせてくれません。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- Great Expectations: expect_table_row_count_to_be_between (日付なし、© 2026、2026年11月9日に確認)
- dbt docs: data tests (日付なし、2026年11月9日に確認)
- Reddit r/laravel:ジョブは「成功」したのに何もしていない。どうやって気づけばいいのか (2025年ごろ(推定))
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。