Ihre Website antwortet mit HTTP 200. Gleichzeitig ist der nächtliche Import nicht gestartet und das letzte Backup fehlgeschlagen. Die Erreichbarkeit der Website allein macht diese Probleme nicht sichtbar. Cronjob-Monitoring ergänzt den Blick auf Hintergrundaufgaben: Hat ein Auftrag rechtzeitig begonnen, ist er fertig geworden und welches Ergebnis hat er gemeldet?
Diese Anleitung zeigt Ihnen, wie Sie Cronjobs mit MetriBeacon überwachen, einen vorhandenen Befehl einbinden und Meldungen sowie Benachrichtigungen prüfen. Beginnen Sie mit einer wichtigen Aufgabe, deren Zeitplan Sie kennen.
Was ist Cronjob-Monitoring?
Cronjob-Monitoring erfasst die Ausführungen geplanter Aufgaben und vergleicht sie mit einer festgelegten Erwartung. Statt die Antwort einer Website zu prüfen, beobachtet es Start, Abschluss und Laufzeit eines Auftrags.
Typische Anwendungen sind Datenimporte, Exporte, Aufräumskripte und Backups. Legen Sie für jede Aufgabe fest, was ein erfolgreiches Ergebnis bedeutet. Exitcode null heißt zunächst, dass der Prozess Erfolg gemeldet hat. Er beweist weder die Richtigkeit importierter Daten noch die Wiederherstellbarkeit eines Backups.
MetriBeacon zeigt einzelne Läufe und erkennt bei einem hinterlegten Cron-Zeitplan auch ausgebliebene Starts. Cron, ein systemd-Timer oder Ihre Workflow-Plattform führen die Aufgabe weiterhin aus. MetriBeacon übernimmt die Überwachung darum herum.
Diese vier Laufergebnisse sollten Sie unterscheiden
| Ergebnis | Was der Monitor beobachtet | Was Sie zuerst prüfen |
|---|---|---|
| Erfolgreich | Eine Abschlussmeldung meldet Erfolg | Bei Bedarf das fachliche Ergebnis |
| Fehlgeschlagen oder abgebrochen | Der Prozess meldet Fehler oder Abbruch | Exitcode, lokale Logs und Abhängigkeiten |
| Ausgeblieben | Bis zum Ende der Toleranz kam kein erwarteter Start | Scheduler, Zeitzone, Host und Meldungsversand |
| Überlang | Ein gestarteter Lauf überschreitet seine Laufzeitgrenze | Fortschritt, blockierte Abhängigkeiten und Ressourcen |
Eine ausgebliebene Meldung braucht eine Prüfung. Vielleicht lief die Aufgabe nicht; vielleicht wurde sie ausgeführt, während ihr Monitoring-Ereignis nicht zugestellt werden konnte. Vergleichen Sie die Laufhistorie mit lokalen Logs und dem Zustand des Hosts, bevor Sie die Ursache festlegen.
Wenn Sie bereits die öffentliche Website überwachen, nutzen Sie beide Ansichten zusammen. Die Anleitung zum Website-Monitoring erklärt Verfügbarkeit, Antwortzeiten und Zertifikatsprüfungen. Eine erreichbare Startseite und ein fehlgeschlagener Hintergrundauftrag können gleichzeitig zutreffende Beobachtungen sein.
Einen Cronjob-Monitor in MetriBeacon einrichten
1. Aufgabe und erwartetes Ergebnis festlegen
Wählen Sie einen Auftrag, bei dessen Ausfall Sie handeln können, etwa einen nächtlichen Produktimport. Notieren Sie den Befehl, tatsächlichen Zeitplan, die Zeitzone und die übliche Laufzeit. Zugangsdaten und vollständige Logs bleiben auf Ihrem System; der Monitor benötigt sie nicht, um einen Lauf zu erkennen.
2. Die Vorlage Backup/Cronjob öffnen
Melden Sie sich an oder erstellen Sie ein kostenloses Konto. Öffnen Sie die Vorlage Backup/Cronjob, wählen Sie einen Arbeitsbereich und benennen Sie den Monitor nach seiner Aufgabe. „Nächtlicher Produktimport“ hilft in einer Alarmmeldung mehr als „Cron 1“.
Tragen Sie den Cron-Ausdruck mit fünf Feldern und die IANA-Zeitzone Ihres Schedulers ein. 0 3 * * * beschreibt einen täglichen Lauf um 03:00 Uhr in dieser Zeitzone. Das ist ein Beispiel und kein Anlass, Ihren bestehenden Produktionszeitplan zu ändern. Prüfen Sie die Vorschau und legen Sie den Monitor ausdrücklich an.
3. Toleranz und Laufzeitgrenze passend wählen
Die Vorlage verwendet für geplante Läufe eine Toleranz von 300 Sekunden. Eine Startmeldung darf damit fünf Minuten nach ihrem geplanten Zeitpunkt eintreffen, bevor die Erwartung als ausgeblieben gilt. Prüfen Sie diesen Wert anhand Ihrer Aufgabe und ihrer üblichen Start- und Zustellverzögerungen.
Die maximale Laufzeit beantwortet eine andere Frage: Wie lange darf eine bereits gestartete Aufgabe dauern? Wenn ein Auftrag normalerweise nach zwei Minuten fertig ist, können zehn Minuten ein sinnvoller Ausgangspunkt sein. Diese Zeiten sind Beispiele; wählen Sie Ihre Grenze anhand des tatsächlichen Verlaufs.
Bei einem Zeitplan für 03:00 Uhr und fünf Minuten Toleranz kann ein fehlender Start nach 03:05 Uhr sichtbar werden. Ein um 03:00 Uhr gestarteter Lauf mit zehn Minuten Laufzeitgrenze kann nach 03:10 Uhr als überlang gelten. Verarbeitung und Nachrichtenversand brauchen ebenfalls Zeit. Die Grenzen versprechen deshalb keinen minutengenauen Eingang einer Alarmmeldung.
4. Einen Monitorschlüssel erstellen
Erstellen Sie in der Schlüsselverwaltung einen Geräteschlüssel für diesen Monitor. Speichern Sie ihn auf dem ausführenden Rechner in einer privaten Datei, die nur dessen Dienstnutzer lesen kann; unter Linux mit Dateiberechtigung 0600. Der Schlüssel gehört weder in die Crontab noch in ein Befehlsargument.
Die Anleitung zur Schlüsselverwaltung erklärt Geltungsbereich und Rotation. Installieren Sie die offizielle CLI über die MetriBeacon-Dokumentation. Verwenden Sie in den folgenden Befehlen den tatsächlichen Pfad Ihrer Installation.
Ausführungen über den CLI-Wrapper melden
Der Wrapper metribeacon run startet Ihren vorhandenen Befehl und meldet Start sowie Abschluss unter derselben Lauf-ID. Ausgabe und Exitcode des Befehls bleiben erhalten.
Das folgende Beispiel gilt für Linux. Ersetzen Sie Beispiel-UUID, Pfade und Schlüsseldatei durch Ihre eigenen Werte. Prüfen Sie zunächst auf einem eigenen Testmonitor einen harmlosen Befehl:
/home/job/.local/bin/metribeacon run \
--monitor-id 11111111-1111-4111-8111-111111111111 \
--key-file /home/job/.config/metribeacon/import.key \
-- /usr/bin/true
Ersetzen Sie anschließend /usr/bin/true durch Ihre tatsächliche Aufgabe. Ein Eintrag in einer Nutzer-Crontab könnte so aussehen:
0 3 * * * /home/job/.local/bin/metribeacon run --monitor-id 11111111-1111-4111-8111-111111111111 --key-file /home/job/.config/metribeacon/import.key -- /home/job/bin/nightly-import
Nutzen Sie absolute Pfade und prüfen Sie die Umgebung des Schedulers. Der Wrapper startet den Befehl nach -- ohne zusätzliche Shell. Für Pipelines oder mehrere aufeinanderfolgende Befehle legen Sie die Logik in ein Skript und starten dieses Skript.
Ein Fehler beim Monitoring-Versand macht einen ansonsten erfolgreichen Geschäftsprozess standardmäßig nicht zu einem fehlgeschlagenen Lauf. Lesen Sie die Diagnosehinweise des Wrappers, wenn eine Ausführung in der Oberfläche fehlt. Ein erfolgreicher lokaler Befehl und eine erfolgreich zugestellte Monitoring-Meldung sind getrennte Ergebnisse.
Die Cronjob-Dokumentation beschreibt die vollständige Einrichtung. Falls sich Toleranzfenster überlappen, übergeben Sie mit --scheduled-for die exakte geplante UTC-Minute. Das verhindert eine mehrdeutige Zuordnung. Nutzen Sie dafür einen Zeitpunkt aus Ihrem Scheduler oder Ihrer Integration statt eines festen Datums aus einem Beispiel.
Zeitplan, Zeitzone und Sommerzeit abstimmen
Der Zeitplan in MetriBeacon muss den Zeitplan beschreiben, der Ihren Befehl tatsächlich ausführt. Ein in UTC ausgewerteter Ausdruck kann eine andere lokale Uhrzeit meinen als derselbe Ausdruck in Europe/Berlin.
Achten Sie besonders auf die Zeitumstellung. Manche lokalen Uhrzeiten existieren dabei nicht, andere treten zweimal auf. Prüfen Sie das Verhalten Ihres Schedulers zusammen mit den Einstellungen in MetriBeacon. Das Crontab-Handbuch erklärt Felder und Zeitabgleich. Verschiedene Scheduler können Uhrzeitänderungen unterschiedlich behandeln.
Wenn sich der echte Zeitplan ändert, passen Sie auch die Monitordefinition an. Pausieren Sie eine Aufgabe bewusst, pausieren Sie die zugehörige Zeitplanüberwachung, damit ihr Ausbleiben erwartet ist.
Meldungen und Alarme vor dem Ernstfall testen
Aktivieren Sie den Laufalarm ausdrücklich. Er umfasst fehlgeschlagene, abgebrochene, überlange und ausgebliebene Läufe; empfangene Laufereignisse allein legen keine Alarmregel an. Verbinden Sie E-Mail oder Telegram und prüfen Sie die Zustellung mit einer Testnachricht.
Prüfen Sie auf einem eigenen Testmonitor die wichtigen Fälle:
/usr/bin/truemeldet einen erfolgreichen Abschluss./usr/bin/falsemeldet einen fehlgeschlagenen Abschluss mit einem Exitcode ungleich null.- Ein bewusst ausgelassener geplanter Testlauf gilt nach Ablauf der Toleranz als ausgeblieben.
- Ein harmloser Testbefehl oberhalb einer kurzen Laufzeitgrenze gilt als überlang.
- Die vorgesehene Person erhält die Benachrichtigung.
Halten Sie diese Tests von produktiven Aufgaben getrennt. Sie müssen keinen echten Import und kein Backup beschädigen, um die Überwachung zu prüfen. Öffnen Sie nach einem Alarm den betroffenen Lauf, seine Zeitpunkte und die lokalen Logs. Prüfen Sie anschließend das fachliche Ergebnis der Aufgabe, bevor Sie den Vorfall als erledigt behandeln.
Häufige Fragen zum Cronjob-Monitoring
Ist Cronjob-Monitoring mit MetriBeacon kostenlos?
Ja, innerhalb der technischen Kontingente des Dienstes. Läufe nutzen die bestehenden Ereignis-, Byte- und Requestbudgets. Die Übersicht zum kostenlosen Monitoring erklärt die aktuellen Grenzen; Ihr Konto zeigt den Verbrauch.
Führt MetriBeacon meine Cronjobs aus?
Ihr eigener Scheduler startet die Aufgabe. MetriBeacon beobachtet gemeldete Ausführungen und konfigurierte Erwartungen. Ein Monitoring-Zeitplan richtet keinen Cron-Eintrag auf Ihrem Server ein.
Kann ich eine Aufgabe ohne Cron-Zeitplan überwachen?
Ja. Eine Aufgabe kann Starts und Abschlüsse ohne Cron-Definition melden. Für die Erwartung eines ausgebliebenen geplanten Laufs braucht der Monitor einen Zeitplan, damit er weiß, wann eine Ausführung fällig ist.
Beweist ein erfolgreicher Backup-Job, dass das Backup nutzbar ist?
Ein erfolgreicher Prozess ist ein Signal. Prüfen Sie die Wiederherstellung separat und berücksichtigen Sie die fachlichen Anforderungen Ihrer Anwendung. MetriBeacon erstellt oder validiert Ihr Backup nicht allein dadurch, dass es den Auftrag überwacht.
Was passiert, wenn Monitoring-Ereignisse nicht gesendet werden können?
Prüfen Sie Diagnosehinweise des Wrappers, Verbindung, Systemzeit und Kontoverbrauch. Eine fehlende Meldung beweist keinen Fehler der eigentlichen Aufgabe. Die CLI kann den Versand wiederholen und einen begrenzten lokalen Puffer nutzen; daraus entsteht keine unbegrenzte Zustellgarantie.
Ihre erste überwachte Aufgabe: eine kurze Checkliste
Wählen Sie einen wichtigen Auftrag, gleiche Zeitplan und Zeitzone ab, setzen Sie Toleranz sowie Laufzeitgrenze und schützen Sie seinen Monitorschlüssel. Prüfen Sie Erfolgs- und Fehlermeldungen, aktivieren Sie den Laufalarm und testen Sie die Zustellung.
Starten Sie über den Button unter diesem Artikel mit der Vorlage Backup/Cronjob. Sobald die erste Aufgabe zuverlässig meldet, ergänzen Sie weitere Importe, Exporte oder geplante Wartungsaufgaben, deren Ergebnisse Sie nutzen können.
