R
Nur Basis-R (readLines auf die URL). Bei einem Fehler sendet es die Meldung; setzen Sie tb_log auf die Log-Datei des Skripts (z. B. Rscript job.R > job.log 2>&1), dann gehen auch dessen letzte Zeilen mit dem Fehler mit (gekürzt, da sie in der Adresse übertragen werden).
Der Code
Das ist der Code, den der Tab Code erzeugt (mit Start, Fehler und Zeilen angehakt). In der App enthält er bereits die eigene Adresse Ihres Jobs.
# --- 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))))So funktioniert es
Der Code pingt /start, wenn das Skript beginnt, die einfache Adresse mit der Zeilenzahl, wenn es gut endet, und /fail, wenn es fehlschlägt, mit der Fehlermeldung und, wenn tb_log gesetzt ist, den letzten Zeilen des Logs.
Entfernen Sie auf dem Tab Code Haken bei Optionen, um Teile wegzulassen; entfernen Sie den Haken bei Send output lines (Ausgabezeilen senden), um keine Ausgabe zu senden, nur den Fehler oder Exit-Code. Siehe was gemeldet werden kann.
Ein R-Skript nach Zeitplan ausführen
Geplante R-Skripte laufen mit Rscript, das mit R mitkommt. Unter Windows geben Sie den vollständigen Pfad an, denn die Aufgabenplanung (Task Scheduler) kennt Ihren PATH nicht:
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\""
Unter Linux oder auf einem Mac genügt eine crontab-Zeile (crontab -e):
30 5 * * * /usr/bin/Rscript /home/me/jobs/crm_import.R
Achten Sie auf den Ordner der R-Version: Nach einem R-Update gibt es den alten Pfad nicht mehr, und die Aufgabe scheitert, bevor Ihr Skript überhaupt startet. TaskBeacon zeigt den Job dann als „Missed“ (verpasst).
Warum der Exit-Code nicht reicht
Ein Fehler, der das Skript stoppt, lässt Rscript mit einem Code ungleich null enden, also kann der Planer ihn sehen. Die stillen Fehler sieht er nicht: eine Abfrage, die keine Zeilen liefert, eine Datei, die nicht aktualisiert wurde, ein tryCatch, das den Fehler schluckt und weitermacht, oder eine Warnung, die das Ergebnis zu NA machte.
Der Code oben sendet /fail mit der Fehlermeldung (und den letzten Zeilen von tb_log, falls gesetzt) und ruft dann erneut stop(e) auf, sodass der Exit-Code ehrlich bleibt.
Die Zeilenzahl melden
Die letzte Zeile sendet nrow(df). Ersetzen Sie df durch den Data Frame, den Ihr Skript erzeugt. Um weitere Zahlen zu senden, hängen Sie sie mit tb_num() an die Adresse an; es schreibt 100000 als 100000, nicht als 1e+05:
tb_ping(paste0("?rows=", tb_num(nrow(df)), "&total=", tb_num(sum(df$amount))))
Häufige Probleme
- Pakete werden nicht gefunden. Die Aufgabenplanung läuft womöglich als anderer Benutzer mit einer anderen Bibliothek. Installieren Sie Pakete für alle Benutzer oder setzen Sie
.libPaths()am Anfang des Skripts. - Arbeitsverzeichnis. Relative Pfade beziehen sich auf den Ordner unter Start in (Starten in) der Aufgabe (bei cron: Ihr Home-Verzeichnis). Verwenden Sie vollständige Pfade oder
setwd(). - Kein Ping hinter einem Proxy.
readLines()auf eine URL nutzt die Download-Methode von R; braucht Ihre Firma einen Proxy, setzen Siehttp_proxy/https_proxyfür die Aufgabe. - Netzlaufwerke. Eine Aufgabe, die läuft, während Sie abgemeldet sind, sieht keine verbundenen Laufwerksbuchstaben; verwenden Sie UNC-Pfade.
Anwendungsfälle: Erfahren, wenn ein geplantes R-Skript fehlschlägt. Weitere Fragen: FAQ.