定期実行の R スクリプトが失敗したことを知る
R スクリプトを taskscheduleR、Windows のタスク スケジューラ(Task Scheduler)または cron でスケジュールしたのに、ある朝ダッシュボードに先週の数字が表示されている。スクリプトは何日も前から失敗していたのに、誰も知らせてくれませんでした。エラーは記録されていましたが、ふだん見ない場所にあっただけです。tryCatch を使えば、エラーが起きたその瞬間に通知を受け取れます。
エラーはどこへ行くのか
R 自体はきちんと失敗を報告します。Rscript で実行したスクリプトがエラーで止まると、R は終了ステータス 1 で終了します(R のドキュメントの quit の項に、非対話モードでの動作として記載されています)。問題は、それを誰も受け取っていないことです。
- taskscheduleR(CRAN のバージョン 1.8、2023年)は、
Rscriptを実行する Windows タスクを作成し、その出力をスクリプトと同じフォルダーの.logファイルに書き出します。エラーはこのログに残り、Task Scheduler には0x1が表示されますが、パッケージ自体には通知機能がありません。 - Task Scheduler は結果を「Last Run Result」(前回の実行結果)列に残しますが、何かがおかしいと気づかない限り、誰もそこを開きません。
- cron(cronR パッケージ経由でも同じ)はジョブの出力を crontab の所有者にメールで送りますが、それはマシンがメールを送信できる場合だけです。メールプログラムがなければ、出力はシステムログに入ります。
よくある失敗のうち 2 つは、R のエラー処理にすら届きません。タスクが Rscript.exe や作業フォルダーを見つけられない場合(相対パスや、誰もログオンしていないときには存在しないネットワークドライブ)と、PC の電源が切れていたりスリープしていたりしてタスクがまったく起動しない場合です。また、エラーなく動いたものの空のファイルを読み込んだスクリプトは、0 で終了します。
スクリプトの中でエラーを捕まえる
以下のコードは base R だけを使います。開始時に TaskBeacon へ ping を送り、あなたのコードを tryCatch で囲み、エラーが起きたらメッセージ(tb_log を設定していればログの最後の数行も)を /fail に送ったうえで、同じエラーで停止します。そのため終了ステータスは 1 のままです。スクリプトが正常に終わると、df の行数を送ります。
# --- TaskBeacon: top of the script (base R only) ---
tb <- "https://taskbeacon.io/ping/your-job-id"
tb_log <- "" # optional: this script's log file (e.g. Rscript job.R > job.log 2>&1); its last 20 lines go with a failure
tb_ping <- function(path = "") {
old <- options(timeout = 10) # wait at most 10 seconds (R's default is 60)
on.exit(options(old))
invisible(try(suppressWarnings(readLines(paste0(tb, path), warn = FALSE)), silent = TRUE))
}
tb_num <- function(x) utils::URLencode(format(x, scientific = FALSE, digits = 15, trim = TRUE), reserved = TRUE)
tb_tail <- function() {
if (!nzchar(tb_log) || !file.exists(tb_log)) return("")
text <- paste(utils::tail(readLines(tb_log, warn = FALSE), 20), collapse = "\n")
if (nchar(text) > 700) text <- sub("^[^\n]*\n", "", substr(text, nchar(text) - 700, nchar(text)))
paste0("&log=", utils::URLencode(text, reserved = TRUE))
}
tb_ping("/start")
tryCatch({
# --- your code here ---
df <- data.frame(x = 1:3) # example data: replace with your own
}, error = function(e) {
tb_ping(paste0("/fail?error=", utils::URLencode(substr(conditionMessage(e), 1, 200), reserved = TRUE), tb_tail()))
stop(e)
})
# --- TaskBeacon: end of the script ---
tb_ping(paste0("?", "rows=", tb_num(nrow(df))))アプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
例の行をあなたのコードに置き換え、確認したい結果が df に入るようにしてください。または nrow(df) を、数えたいものに変更してください。taskscheduleR を使う場合は、tb_log にそれが書き出すログファイル(スクリプト名に .log を付けたもの)を設定すると、アラートに R 自身の出力が表示されます。
得られるもの
- Failed(失敗): すぐに、エラーメッセージ付きで届きます。例:
cannot open file 'S:/data/sales.csv': No such file or directory。 - Missed(未実行): 予定時刻に猶予時間を加えた時刻までにスクリプトから報告がなかったとき。R がそもそも起動しなかった実行を捕まえます。
- Late(遅延): 開始の ping は届いたのに、実行がいつもよりずっと長くかかっているとき。
- Odd data(異常データ): 行数が最近の実行より 40% 以上少ないか、0 のとき。0 行、またはいつもよりずっと少ない場合を参照してください。
Docs の R のページでは、schtasks や crontab の行で Rscript をスケジュールする方法と、スケジューラ下でのパスやパッケージに関するよくある問題を説明しています。
TaskBeacon を使わない場合
スクリプトを自分で tryCatch で囲み、エラーハンドラーからメールを送ります。たとえば blastula や emayili パッケージと、お使いの SMTP サーバーを使います。これで R の中で起きたエラーは報告できます。そもそも起動しなかった実行については、毎朝ログファイルの日付を確認するか、ログが 1 日より古いときに警告を出す別のジョブを用意します。どちらも機能しますが、後者は 1 台の PC に一度設定すると忘れられがちです。ハートビートチェックなら、その部分をマシンの外から行います。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
- Python の cron ジョブや定期スクリプトが失敗したときにアラートを受け取るcron が知らせるのは出力で、成功か失敗かではありません。Task Scheduler の 0x1 は誰も見ていません。
- ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る終了コード 0 は、何行届いたかについて何も語りません。
- 定期ジョブがまったく実行されなかったことを知る行われなかった実行にはエラーがないため、アラートのきっかけがありません。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- R documentation: quit(非対話モードのエラーでは R はステータス 1 で終了) (R 4.6 のドキュメント、日付なし、2026年11月9日に確認)
- CRAN:taskscheduleR 1.8(schtasks で R スクリプトをスケジュールし、.log ファイルを書き出す) (2023年7月2日、現在も最新版、2026年11月9日に確認)
- taskscheduleR README: the log is in the same folder as the R script (日付なし、2026年11月9日に確認)
- Posit Forum: how to schedule an R script using cronR or other methods (2023年7月25日、古い:需要の表れ)
- Microsoft Q&A:タスクは正常に完了したと表示されるが、何も起きていない(R スクリプト) (2021年6月16日、古い:需要の表れ)
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。