Einen Cronjob oder ein Skript überwachen

Behalte ein Backup-Skript, einen Cronjob oder eine geplante Aufgabe im Blick, indem du es sich bei InfraNest melden lässt — dies ist für alle gedacht, die sofort erfahren möchten, wenn ein Routinejob stillschweigend nicht mehr läuft.

Überblick

• Ein Heartbeat-Monitor funktioniert umgekehrt zu den meisten Prüfungen: Statt dass InfraNest deinen Dienst kontaktiert, meldet sich dein Job jedes Mal bei InfraNest, wenn er fertig ist.
• Trifft diese Meldung nicht rechtzeitig ein, löst InfraNest eine Benachrichtigung aus.
• Dies ist die beste Methode, um einen Job zu erkennen, der still und leise nicht mehr läuft, statt einen, der nur langsam reagiert.

Einen Monitor einrichten

1. Gehe zu Monitore und wähle add a monitor.
2. Wähle Heartbeat / Cron monitor als Typ.

3. Vergib einen name, den du in einer Benachrichtigung wiedererkennst — „Nightly database backup“ ist besser als „job 1“.
4. Lege das check interval darauf fest, wie oft der Job laufen soll.
5. Lege eine grace period fest — zusätzliche Zeit, die erlaubt ist, bevor der Job als verspätet gilt. Ein Backup, das normalerweise vier Minuten dauert, aber gelegentlich acht, benötigt eine Kulanzzeit, die deutlich länger ist als diese Überschreitung.
6. Wähle create monitor.

Für diesen Typ gibst du keine URL ein — InfraNest erstellt beim Speichern automatisch eine für dich.

Deinen Job zur Meldung bringen

1. Öffne den Monitor, um die ping URL sowie eine fertige Einzeiler-Vorlage zum Einfügen zu sehen.
2. Füge diese Zeile am Ende deines Skripts oder Cronjobs ein, sodass sie nur ausgeführt wird, wenn der Job tatsächlich erfolgreich war:

0 3 * * *  /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 https://your-infranest-url/api/heartbeat/your-uuid

3. Behalte das && bei — es bedeutet, dass die Meldung nur erfolgt, wenn das Backup selbst erfolgreich beendet wurde. Ein fehlgeschlagener Job bleibt dann stumm, und genau diese Stille löst die Benachrichtigung aus.
4. Verwende die Schaltfläche Kopieren, statt die URL erneut einzutippen — die darin enthaltene Kennung ist eindeutig für diesen Monitor.

Was als Nächstes passiert

• Jede Meldung kennzeichnet den Monitor als Aktiv und speichert den Zeitpunkt als letzten Ping.
• Ein brandneuer Monitor bleibt ausstehend, bis sein erstes Zeitfenster verstrichen ist, sodass du Zeit hast, die Meldung einzurichten, ohne dafür benachrichtigt zu werden.
• Trifft innerhalb des Intervalls plus der Kulanzzeit nichts ein, wechselt der Monitor auf Inaktiv und eröffnet einen Vorfall, wodurch deine üblichen Benachrichtigungsziele ausgelöst werden.
• Die nächste Meldung löst den Vorfall auf und benachrichtigt dich, dass wieder alles läuft — du musst ihn nicht manuell schließen.

NoteDas Pausieren eines Heartbeat-Monitors ist unbedenklich: Die Ping-URL antwortet weiterhin normal, sodass ein Job, der sie noch aufruft, keine Fehler meldet. InfraNest stellt lediglich die Überwachung ein, bis du sie fortsetzt.

TipBehandle die Ping-URL wie ein Geheimnis. Wer sie kennt, kann deinen Job als fehlerfrei melden — und damit einen echten Ausfall verschleiern.

Fehlerbehebung

• No ping received yet am Monitor bedeutet, dass InfraNest überhaupt noch nichts vom Job gehört hat. Führe die curl-Zeile manuell auf derselben Maschine aus: Wechselt der Monitor dadurch auf Aktiv, liegt das Problem in deinem Skript, nicht hier.
• Wenn die Maschine keine ausgehende Internetverbindung hat, kann die Meldung nicht ankommen — erlaube ausgehendes HTTPS zu InfraNest.
• Ein Monitor, der jede Nacht zur gleichen Zeit eine Benachrichtigung auslöst, hat meist eine Kulanzzeit, die kürzer ist als die tatsächliche längste Laufzeit des Jobs.