R
Solo R base (readLines sobre la URL). Ante un error envía el mensaje; pon en tb_log el archivo de log del script (p. ej. Rscript job.R > job.log 2>&1) y sus últimas líneas también van con el fallo (acortadas, porque viajan en la dirección).
El código
Este es el código que genera la pestaña Code (código) (con inicio, errores y filas marcado). En la app ya contiene la dirección propia de tu 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))))Cómo funciona
El código envía un ping a /start cuando el script empieza, a la dirección simple con el número de filas cuando termina bien, y a /fail cuando falla, con el mensaje de error y, si tb_log está definido, las últimas líneas del log.
Desmarca opciones en la pestaña Code para dejar partes fuera; desmarca Send output lines (enviar líneas de salida) para no enviar ninguna salida, solo el error o el código de salida. Consulta qué se puede informar.
Ejecutar un script de R según un horario
Los scripts de R programados se ejecutan con Rscript, que viene con R. En Windows indica la ruta completa, porque Task Scheduler no conoce tu 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\""
En Linux o en una Mac, una línea de crontab (crontab -e):
30 5 * * * /usr/bin/Rscript /home/me/jobs/crm_import.R
Revisa la carpeta de la versión de R: después de actualizar R, la ruta antigua ya no existe y la tarea falla antes de que tu script siquiera empiece. TaskBeacon muestra entonces el job como Missed (no ejecutado).
Por qué el código de salida no basta
Un error que detiene el script hace que Rscript termine con un código distinto de cero, así que el programador de tareas puede verlo. No ve los fallos silenciosos: una consulta que no devuelve filas, un archivo que no se actualizó, un tryCatch que se traga el error y sigue adelante, o un warning que convirtió el resultado en NA.
El código de arriba envía /fail con el mensaje de error (y las últimas líneas de tb_log, si está definido) y luego vuelve a llamar a stop(e) para que el código de salida siga siendo fiel.
Reportar el número de filas
La última línea envía nrow(df). Reemplaza df por el data frame que produce tu script. Para enviar más números, añádelos a la dirección con tb_num(), que escribe 100000 como 100000, no como 1e+05:
tb_ping(paste0("?rows=", tb_num(nrow(df)), "&total=", tb_num(sum(df$amount))))
Problemas frecuentes
- No se encuentran los paquetes. Task Scheduler puede ejecutar la tarea como otro usuario con otra biblioteca. Instala los paquetes para todos los usuarios, o define
.libPaths()al principio del script. - Directorio de trabajo. Las rutas relativas son relativas a la carpeta Start in (Iniciar en) de la tarea (en cron: tu carpeta personal). Usa rutas completas o
setwd(). - No llega el ping detrás de un proxy.
readLines()sobre una URL usa el método de descarga de R; si tu empresa necesita un proxy, definehttp_proxy/https_proxypara la tarea. - Unidades de red. Una tarea que se ejecuta mientras no has iniciado sesión no ve las letras de unidades asignadas; usa rutas UNC.
Casos de uso: Entérate cuando falla un script de R programado. Más preguntas: preguntas frecuentes.