Python
Nur die Standardbibliothek (urllib). Funktioniert mit jedem Python 3. Bei einem Fehler sendet es den Fehler und die letzten 20 Zeilen des Tracebacks; die „Failed“-Benachrichtigung und die Job-Seite zeigen sie an. Die Beispielzeile (df = ...) läuft so, wie sie eingefügt ist: Ersetzen Sie sie durch Ihren eigenen Code.
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 (standard library only) ---
import json, traceback, urllib.request
TB = "https://taskbeacon.io/ping/your-job-id"
def tb_ping(path="", data=None):
body = json.dumps(data).encode() if data else None
req = urllib.request.Request(TB + path, data=body, headers={"Content-Type": "application/json"})
try:
urllib.request.urlopen(req, timeout=10)
except Exception as e:
print("TaskBeacon ping failed:", e)
tb_ping("/start")
try:
# --- your code here ---
df = [1, 2, 3] # example data: replace with your own (e.g. pandas.read_csv)
except Exception as e:
# the error and the last 20 lines of the traceback go with the failure
tb_ping("/fail", {"error": f"{type(e).__name__}: {e}"[:200],
"log": "\n".join(traceback.format_exc().splitlines()[-20:])[-4000:]})
raise
# --- TaskBeacon: end of the script ---
tb_ping("", {"rows": len(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 dem Fehler und den letzten 20 Zeilen des Tracebacks.
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 Python-Skript nach Zeitplan ausführen
Unter Windows legen Sie eine Aufgabe aus einer Eingabeaufforderung an. Verwenden Sie den vollständigen Pfad des Python, in das Sie die Pakete installiert haben (where python zeigt ihn), oder den Ihrer virtuellen Umgebung:
schtasks /Create /TN "Sales report" /SC DAILY /ST 06:00 /TR "C:\jobs\venv\Scripts\python.exe C:\jobs\sales.py"
Unter Linux oder auf einem Mac genügt eine crontab-Zeile (crontab -e):
0 6 * * * /home/me/jobs/venv/bin/python /home/me/jobs/sales.py
Verwenden Sie python.exe, nicht pythonw.exe, wenn Sie die Ausgabe sehen möchten, wenn Sie die Aufgabe von Hand starten.
Warum der Exit-Code nicht reicht
Eine nicht abgefangene Ausnahme lässt Python mit Code 1 enden, also sieht der Planer diese Art von Fehler. Die stillen sieht er nicht: ein leeres Abfrageergebnis, eine API, die ohne Daten antwortete, ein try/except, das protokolliert und weitermacht, oder ein Lauf, der nie begann, weil der Rechner aus war.
Der Code oben sendet /fail mit der Fehlermeldung und den letzten 20 Zeilen des Tracebacks und löst die Ausnahme dann erneut aus, sodass der Exit-Code ehrlich bleibt; ein Lauf, der nie beginnt, erscheint als „Missed“ (verpasst).
Die Zeilenzahl melden
Die letzte Zeile sendet len(df). Ersetzen Sie df durch Ihr Ergebnis (einen pandas-DataFrame, eine Liste von Zeilen, die Zahl, die Ihr Insert zurückgab). Weitere Zahlen kommen in dasselbe JSON:
tb_ping("", {"rows": len(df), "total": float(df["amount"].sum())})
Der Code verwendet nur die Standardbibliothek (urllib), funktioniert also ohne requests.
Häufige Probleme
- ModuleNotFoundError nur unter dem Planer. Die Aufgabe startet ein anderes Python. Lassen Sie die Aufgabe auf die
python.exeder venv zeigen. - Relative Pfade. Sie beziehen sich auf den Ordner unter Start in (Starten in) der Aufgabe, nicht auf den des Skripts. Bilden Sie Pfade aus
pathlib.Path(__file__).parent. - SSL: CERTIFICATE_VERIFY_FAILED. Ein Firmen-Proxy, der HTTPS untersucht, verwendet ein eigenes Zertifikat; fragen Sie die IT danach, oder führen Sie das Skript mit dem Python aus, das Ihre IT bereitstellt.
- Netzlaufwerke. Eine Aufgabe, die läuft, während Sie abgemeldet sind, sieht keine verbundenen Laufwerksbuchstaben; verwenden Sie UNC-Pfade.
Anwendungsfälle: Benachrichtigung, wenn ein Python-cron-Job oder ein geplantes Skript fehlschlägt · Benachrichtigung, wenn ein Produktionsjob in SPSS Statistics fehlschlägt · Einen geplanten KI-Agenten oder LLM-Job überwachen · Benachrichtigung, wenn ein KI-Job eine leere oder zu kurze Antwort liefert · Benachrichtigung, wenn ein Job 0 Zeilen oder viel weniger als üblich lädt · Prüfen, ob eine tägliche Tabelle oder Datei aktuell ist · Prüfen, ob das Backup der letzten Nacht existiert und nicht leer ist. Weitere Fragen: FAQ.