R
सिर्फ़ base R (URL पर readLines)। Error पर यह message भेजता है; tb_log को script की log फ़ाइल पर set करें (जैसे Rscript job.R > job.log 2>&1), तो उसकी आखिरी lines भी failure के साथ जाती हैं (छोटी करके, क्योंकि वे address में जाती हैं)।
Code
यह वह code है जो Code टैब बनाता है (start, errors और rows पर निशान लगाकर)। App में इसमें पहले से आपके job का अपना पता होता है।
# --- 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))))यह कैसे काम करता है
Script शुरू होने पर code /start ping करता है, ठीक से खत्म होने पर row count के साथ सादा address, और fail होने पर /fail, error message के साथ और, अगर tb_log set है, तो log की आखिरी lines के साथ।
किसी हिस्से को छोड़ने के लिए Code टैब पर विकल्पों का निशान हटाएँ; कोई output न भेजकर सिर्फ़ error या exit code भेजने के लिए Send output lines (output लाइनें भेजें) का निशान हटाएँ। देखें क्या रिपोर्ट किया जा सकता है।
R script को schedule पर चलाएँ
Scheduled R scripts Rscript से चलती हैं, जो R के साथ आता है। Windows पर पूरा path दें, क्योंकि 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 line (crontab -e):
30 5 * * * /usr/bin/Rscript /home/me/jobs/crm_import.R
R version वाला folder जाँचें: R update होने के बाद पुराना path मौजूद नहीं रहता और task आपकी script शुरू होने से पहले ही fail हो जाता है। तब TaskBeacon job को “Missed” (छूटा) दिखाता है।
Exit code काफ़ी क्यों नहीं है
Script को रोक देने वाली error होने पर Rscript non-zero code के साथ बंद होता है, इसलिए scheduler उसे देख सकता है। चुपचाप होने वाली failures वह नहीं देखता: ऐसी query जो कोई row नहीं लौटाती, ऐसी file जो update नहीं हुई, ऐसा tryCatch जो error को निगलकर आगे बढ़ जाता है, या ऐसी warning जिसने result को NA बना दिया।
ऊपर का code error message (और अगर सेट हो तो tb_log की आख़िरी lines) के साथ /fail भेजता है, फिर दोबारा stop(e) call करता है ताकि exit code सही बना रहे।
Row count भेजें
आख़िरी line nrow(df) भेजती है। df की जगह वह data frame रखें जो आपकी script बनाती है। और संख्याएँ भेजने के लिए उन्हें tb_num() से पते में जोड़ें, जो 100000 को 1e+05 नहीं, 100000 लिखता है:
tb_ping(paste0("?rows=", tb_num(nrow(df)), "&total=", tb_num(sum(df$amount))))
आम समस्याएँ
- Packages नहीं मिलते। Task Scheduler किसी दूसरे user के रूप में, अलग library के साथ चल सकता है। Packages सभी users के लिए install करें, या script की शुरुआत में
.libPaths()सेट करें। - Working directory. Relative paths task के Start in folder के हिसाब से होते हैं (cron में: आपका home)। पूरे paths या
setwd()इस्तेमाल करें। - Proxy के पीछे कोई ping नहीं। URL पर
readLines()R का download method इस्तेमाल करता है; अगर आपकी company में proxy ज़रूरी है, तो task के लिएhttp_proxy/https_proxyसेट करें। - Network drives. जो task आपके logged out रहते चलता है, उसे mapped drive letters नहीं दिखते; UNC paths इस्तेमाल करें।
उपयोग के उदाहरण: जानें कि scheduled R script कब fail होती है। और सवाल: FAQ.