R
base R のみ(URL に readLines)。エラー時にはメッセージを送ります。tb_log にスクリプトのログファイルを指定すると(例:Rscript job.R > job.log 2>&1)、その最後の数行も失敗と一緒に送られます(アドレスに載せて送るため短縮されます)。
コード
これは Code(コード)タブが生成するコードです(開始、エラー、行数 にチェックを入れた状態)。アプリでは、あなたのジョブ専用のアドレスがすでに入っています。
# --- 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))))仕組み
コードはスクリプトの開始時に /start、正常に終わったときに行数付きでそのままのアドレス、失敗したときに /fail を ping し、エラーメッセージと、tb_log が設定されていればログの最後の数行を送ります。
一部を省きたい場合は、Code タブでオプションのチェックを外してください。出力を送らず、エラーか終了コードだけを送るには Send output lines(出力行を送信)のチェックを外します。報告できる内容もご覧ください。
R スクリプトをスケジュールで実行する
スケジュール実行する R スクリプトは、R に付属する Rscript で動かします。Windows では Task Scheduler があなたの PATH を知らないので、フルパスを指定してください。
schtasks /Create /TN "CRM import" /SC DAILY /ST 05:30 /TR "\"C:\Program Files\R\R-4.4.1\bin\Rscript.exe\" \"C:\jobs\crm_import.R\""
Linux や Mac では crontab に 1 行(crontab -e)。
30 5 * * * /usr/bin/Rscript /home/me/jobs/crm_import.R
R のバージョンのフォルダーを確認してください。R を更新すると古いパスはなくなり、スクリプトが始まる前にタスクが失敗します。そのとき TaskBeacon はジョブを Missed(未実行)と表示します。
終了コードだけでは足りない理由
スクリプトを止めるエラーが起きると Rscript は 0 以外のコードで終了するので、スケジューラーにも見えます。見えないのは静かな失敗です。行を返さないクエリ、更新されなかったファイル、エラーを握りつぶして続行する tryCatch、結果を NA にしてしまった警告などです。
上のコードはエラーメッセージ(設定していれば tb_log の最後の行も)を付けて /fail を送り、その後でもう一度 stop(e) を呼ぶので、終了コードは正しいままです。
行数を報告する
最後の行は nrow(df) を送ります。df をスクリプトが作るデータフレームに置き換えてください。数値を増やす場合は tb_num() でアドレスに追加します。tb_num() は 100000 を 1e+05 ではなく 100000 と書きます。
tb_ping(paste0("?rows=", tb_num(nrow(df)), "&total=", tb_num(sum(df$amount))))
よくある問題
- パッケージが見つからない。 Task Scheduler は、別のライブラリを持つ別のユーザーとして実行することがあります。パッケージを全ユーザー向けにインストールするか、スクリプトの先頭で
.libPaths()を設定してください。 - 作業ディレクトリ。 相対パスはタスクの Start in(開始)フォルダー(cron ではホーム)が基準になります。フルパスか
setwd()を使ってください。 - プロキシの内側で ping が届かない。 URL に対する
readLines()は R のダウンロード方式を使います。会社でプロキシが必要な場合は、タスクにhttp_proxy/https_proxyを設定してください。 - ネットワーク ドライブ。 ログアウト中に実行されるタスクからは、割り当てたドライブ文字が見えません。UNC パスを使ってください。
ユースケース: 定期実行の R スクリプトが失敗したことを知る。その他のご質問: FAQ