Benachrichtigung, wenn ein Python-cron-Job oder ein geplantes Skript fehlschlägt
Ein Python-Skript läuft jede Nacht über cron oder die Windows-Aufgabenplanung (Task Scheduler). Wenn es eine Exception auslöst, landet der Traceback in einem Log oder einem Postfach, das niemand liest, und Sie merken es, wenn die Daten fehlen. Ein paar Zeilen im Skript schicken diesen Traceback stattdessen an Sie, und ein Zeitplan erkennt die Läufe, die hängen oder nie starten.
Python meldet den Fehler; der Planer behält ihn für sich
Eine nicht abgefangene Exception lässt Python mit Status 1 enden (so beschreibt es die Python-Dokumentation zu sys.exit und zur Hauptschleife des Interpreters: 0 ist Erfolg, alles andere ein abnormales Ende). Der Planer weiß es also. Was er damit macht:
- cron schaut sich den Exit-Status gar nicht an. Es schickt die Ausgabe des Jobs per Mail an den Besitzer der crontab oder an
MAILTO, sofern der Rechner ein funktionierendes Mailprogramm hat; ohne eines schreibt cronie die Ausgabe ins Syslog. Ein Skript, das fehlschlägt und dessen Ausgabe in eine Datei umgeleitet wird, schickt nirgendwohin etwas. - Die Aufgabenplanung zeigt
0x1in der Spalte Last Run Result (Letztes Laufergebnis), und das war's. Forenbeiträge wie „How to fix (0x1) error in task scheduler that runs a python script“ (Microsoft Q&A, 2023) beginnen damit, dass jemand es Tage später bemerkt.
Manche Fehler sind gar keine Exceptions: ein try/except, das protokolliert und weitermacht, eine API, die eine leere Liste zurückgibt, eine Abfrage, die keine neuen Zeilen findet. Python endet mit 0, und der Planer ist zufrieden. Und ein Lauf, der nie gestartet ist (Rechner aus, cron-Daemon gestoppt, falscher Pfad in der crontab), hinterlässt überhaupt keinen Status.
Aus dem Skript melden
Der Code unten verwendet nur die Standardbibliothek (urllib) und funktioniert daher in jedem Python 3 und jeder virtuellen Umgebung. Er pingt TaskBeacon beim Start; bei einer Exception sendet er /fail mit dem Fehler und den letzten 20 Zeilen des Tracebacks und löst sie dann erneut aus, damit der Exit-Status 1 bleibt; am Ende sendet er die Zeilenzahl.
# --- 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)})In der App gibt Ihnen der Tab Code Ihres Jobs diesen Code mit der eigenen Adresse des Jobs statt your-job-id, und Sie können die Teile abwählen, die Sie nicht brauchen.
Ersetzen Sie die Beispielzeile durch Ihren Code und legen Sie das Ergebnis in df ab (ein pandas-DataFrame oder eine Liste von Zeilen), oder senden Sie eine andere Zahl. Ein fehlgeschlagener Ping gibt eine Meldung aus, und das Skript läuft weiter: Die Überwachung bricht den Job nie.
Bei einem cron-Job bleibt die crontab-Zeile, wie sie ist:
0 6 * * * /home/me/jobs/venv/bin/python /home/me/jobs/sales.py >> /home/me/jobs/sales.log 2>&1
Wenn Sie das Skript lieber nicht anfassen, meldet die cron-Zeile stattdessen den Exit-Code (ohne Traceback und ohne Zeilenzahl).
Was Sie bekommen
- Failed (fehlgeschlagen) mit der Exception und dem Ende des Tracebacks, zum Beispiel
KeyError: 'amount', per E-Mail, in Slack oder Teams. - Missed (verpasst), wenn bis zur geplanten Zeit plus Karenzzeit kein Ping ankam: Rechner aus, cron läuft nicht, ein Tippfehler in der crontab.
- Late (verspätet), wenn das Skript gestartet ist und viel länger als üblich dauert, etwa weil eine Anfrage ohne Timeout ewig wartet.
- Odd data (ungewöhnliche Daten), wenn die Zeilen um mehr als 40 % fallen oder 0 sind.
Ohne TaskBeacon
Unter Linux installieren und konfigurieren Sie ein Mailprogramm, setzen MAILTO und lassen das Skript nur bei Fehlern etwas ausgeben, damit cron Ihnen genau dann eine Mail schickt. Unter Windows fügen Sie auf oberster Ebene ein try/except hinzu, das vor dem erneuten Auslösen eine E-Mail über smtplib sendet. Beides deckt Exceptions ab. Keines von beiden deckt einen Lauf ab, der nie gestartet ist; dafür brauchen Sie etwas, das ein Signal vom Job erwartet, eine Heartbeat-Prüfung, oder einen zweiten Job, der jeden Morgen die Ausgabe des ersten prüft.
Claude oder ChatGPT mit TaskBeacon verbunden? Fragen Sie: „Was ist letzte Nacht fehlgeschlagen, und warum?“, und die Antwort kommt aus Ihren Jobs. So funktioniert das.
Verwandte Themen
In den Docs: Python · Linux cron · Status.
- Heartbeat-Monitoring (ein Totmannschalter) für geplante SkripteDer Job meldet sich bei jedem Lauf; Stille ist die Benachrichtigung.
- Erfahren, wenn ein geplantes R-Skript fehlschlägttaskscheduleR und cron schreiben ein Log; niemand liest es, bis etwas schiefgeht.
- Benachrichtigung, wenn ein Job 0 Zeilen oder viel weniger als üblich lädtExit-Code 0 sagt nichts darüber, wie viele Zeilen angekommen sind.
Der Einstieg in TaskBeacon ist kostenlos, derzeit mit allen Funktionen und ohne Kreditkarte. Legen Sie einen Job an, fügen Sie den Code ein, und der erste Ping erscheint auf der Seite des Jobs.
Kostenlos starten Live-Demo ansehenQuellen
- Python docs: Py_RunMain gibt bei einer unbehandelten Exception 1 zurück (Python-3.15-Doku, ohne Datum; geprüft am 9. November 2026)
- Python docs: sys.exit (null ist Erfolg, alles andere ein abnormales Ende) (Python-3.15-Doku, ohne Datum; geprüft am 9. November 2026)
- man7.org: crontab(5), cronie (MAILTO) (Seite von 2012, entspricht dem Upstream-Stand von cronie 2026)
- man7.org: cron(8), cronie (Ausgaben werden per Mail verschickt; ohne sendmail gehen sie ins Syslog) (Seite von 2013, entspricht dem Upstream-Stand von cronie 2026)
- Microsoft Q&A: Fehler (0x1) in der Aufgabenplanung beheben, die ein Python-Skript ausführt (28. August 2023, alt: ein Zeichen für Bedarf)
Diese Seite wurde am 9. November 2026 mit ihren Quellen abgeglichen. Menüs und Grenzen anderer Produkte ändern sich; wenn hier etwas nicht mehr stimmt, schreiben Sie an support@taskbeacon.io.