報告できる内容
スクリプトは「実行した」という知らせのほかに、数値も送れます。TaskBeacon はその数値を、ジョブページで変更できるルール(Alert me when(アラートを出す条件))と照らし合わせます。
終了時と開始時
終了時の ping は、Code タブのコードに常に含まれています。これによって TaskBeacon はジョブが実行されたことを知り、この ping が時間内に届かなければ、ジョブは Missed(未実行)とみなされます。
開始時の ping(/start)は初期状態でオンです。各実行にかかった時間を計測し、止まったままの実行を Late(遅延)にします。
終了だけでよい場合は、Code タブでチェックを外してください。
行数
?rows=15234。ジョブが初めて行数を送ると、2 つのルールが追加されます。行数が直近の平均より 40% を超えて減ったとき、または 1 未満のときにアラートを出します。数値を送らないジョブにはルールがありません。
最新の日付
?last_date=2026-11-05。データ内でいちばん新しい日付です。ジョブページの Alert me when で、名前 last_date、Is a date older than X days(X 日より古い日付)のルールを追加します。それより古い日付が届くと、Odd data(異常データ)のアラートが送られます。
バックアップのサイズ
?bytes=…。バックアップファイルのサイズです。空のとき、または通常よりかなり小さいときにアラートを出します。ping はダンプの後ではなく、コピーの後に送ってください。
独自の数値
任意の名前と値を送れます(例: ?total_sales=81234.5)。ジョブページの Alert me when でルールを追加します。名前、Is below X(X 未満)、Is above X(X 超)または Drops more than X%(X% を超えて減少)、そして X を指定します。
終了コード
アドレスの最後に終了コードを付けます。/ping/<id>/0 は正常に終わった実行、それ以外の数値
(/ping/<id>/1)はその終了コードによる失敗で、/fail?exit_code=1 と同じです。シェルなら
if を使わずに、そのまま送れます。
/path/to/your-job.sh
curl -fsS -m 10 "https://taskbeacon.io/ping/<id>/$?"
Code タブの PowerShell、Batch、cron のコードはこの方法を使っています: /$code、/%TB_RC%、/$?。
出力に含まれる語句
プログラムによっては、エラーを出力しても終了コード 0 で終わることがあります。出力(またはその最後の数行)を
終了時の ping のボディとして送り、ジョブページの Alert me when で出力のルールを追加します。
Fail if the output contains(出力に含まれていたら失敗)または OK only if the output contains(出力に含まれているときだけ OK)を選び、X に語句をカンマ区切りで入力します(例:
ERROR, Traceback)。大文字と小文字は区別しません。
- Fail if the output contains: 出力にいずれかの語句を含む実行は Failed(失敗)になり、理由は Output contains 'ERROR' と表示されます。
- OK only if the output contains: 出力にどの語句も含まない実行は Failed になります(出力を送らなかった場合も同じです)。
/path/to/your-job.sh > job.log 2>&1
tail -n 20 job.log | curl -fsS -m 10 --data-binary @- "https://taskbeacon.io/ping/<id>/$?"
ルールがチェックするのは終了時の ping(終了コードなしのアドレス、または終了コード 0)です。テキストのボディ、JSON ボディの log フィールド、
または ?log= が対象です。/fail はいずれにしても失敗です。Code タブの PowerShell と Batch のコードは、失敗時にしか最後の数行を送りません。出力のルールを使う場合は、上の例のように終了時の ping で出力をご自身で送ってください。
Code タブで報告する項目にチェックを入れると、それに合わせてコードが変わります。TaskBeacon が受け取るのは、その行が送るものだけです。つまり、これらの数値と、失敗時の出力の最後の 20 行(またはエラーメッセージ)です。Send output lines(出力行を送信)のチェックを外すと、エラーメッセージか終了コードだけが送られます(プライバシー(英語)をご覧ください)。データそのものは、あなたのマシンから出ません。
ユースケース: バッチモードで Stata の do ファイルが失敗したときにアラートを受け取る · Task Scheduler の Last Run Result は 0x0 なのに、スクリプトは失敗した · PowerShell スクリプトのエラーと Task Scheduler の終了コード · 定期実行の R スクリプトが失敗したことを知る · SAS のバッチジョブがエラーで終了したときにアラートを受け取る · 定期実行の AI エージェントや LLM ジョブを監視する · 昨夜何が失敗したかを Claude や ChatGPT に質問する · AI ジョブが空の回答や短すぎる回答を返したときにアラートを受け取る · ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る · 日次のテーブルやファイルが新しいことを確認する · 昨夜のバックアップが存在し、空でないことを確認する。その他のご質問: FAQ