Heartbeat-Monitore (Cron-Jobs)

Was ein Heartbeat-Monitor ist

Ein Heartbeat-Monitor ist ein passiver Totmannschalter für Aufgaben, die planmäßig laufen sollen — Cron-Jobs, nächtliche Backups, ETL-Pipelines, Queue-Worker und ähnliche Hintergrundaufgaben. Anstatt dass LoadFocus Ihren Dienst aufruft, ruft Ihre Aufgabe LoadFocus auf, jedes Mal, wenn sie erfolgreich abgeschlossen wird. Wenn der erwartete Ping nicht rechtzeitig eintrifft, geht der Monitor auf DOWN und Warnungen werden ausgelöst.

Anders als aktive Prüfungen sondiert ein Heartbeat-Monitor nichts und hat keine Regionen — er wartet einfach darauf, dass sich Ihre Aufgabe meldet. Das macht ihn ideal, um zu prüfen, ob geplante Aufgaben tatsächlich ausgeführt wurden, und nicht nur, ob ein Endpunkt erreichbar ist.

Wie es funktioniert

1. Sie erstellen einen Heartbeat-Monitor und legen ein erwartetes Ping-Intervall und eine Kulanzzeit fest.
2. LoadFocus stellt Ihnen eine eindeutige Ping-URL zur Verfügung.
3. Ihre Aufgabe pingt diese URL bei jedem erfolgreichen Lauf an.
4. Wenn ein Ping innerhalb des erwarteten Fensters eintrifft, bleibt der Monitor UP.
5. Wenn innerhalb von Intervall + Kulanzzeit kein Ping eintrifft, geht der Monitor auf DOWN und Warnungen werden ausgelöst.
6. Der nächste erfolgreiche Ping stellt den Monitor wieder auf UP.

Alle Zeiten und Intervalle werden in Sekunden angegeben.

Einen Heartbeat-Monitor erstellen

1. Öffnen Sie die Seite für neue API-Prüfung.
2. Wählen Sie den Typ Heartbeat.
3. Legen Sie das erwartete Ping-Intervall in Sekunden fest — wie oft sich Ihre Aufgabe melden soll (zum Beispiel 3600 für einen stündlichen Job).
4. Legen Sie eine Kulanzzeit in Sekunden fest — der zusätzliche Spielraum, den Sie gewähren, bevor die Aufgabe als verspätet gilt (zum Beispiel 300).
5. Kopieren Sie die eindeutige Ping-URL, die LoadFocus generiert.
6. Wählen Sie Ihre Benachrichtigungskanäle und speichern Sie.

Die URL aus Ihrer Aufgabe anpingen

Lassen Sie Ihre Aufgabe die Ping-URL aufrufen, nachdem sie erfolgreich abgeschlossen wurde. GET, POST oder HEAD funktionieren gleichermaßen.

Am einfachsten hängen Sie einen curl-Aufruf an das Ende Ihres Skripts oder Cron-Eintrags an:

curl -fsS https://apimonitor.loadfocus.com/heartbeat/<your-ping-id>

Das Flag -f lässt curl bei HTTP-Fehlern fehlschlagen, -s hält es ruhig und -S zeigt echte Fehler dennoch an. Führen Sie dies nur bei Erfolg aus — zum Beispiel als letzte Zeile der Aufgabe — sodass ein fehlgeschlagener Lauf keinen Ping sendet und der Monitor das Ausbleiben korrekt erkennt.

Warnungen und Wiederherstellung

• Wenn Intervall + Kulanzzeit ohne Ping verstreichen, schaltet der Monitor auf DOWN und Ihre Benachrichtigungskanäle werden benachrichtigt.
• Wenn der nächste Ping eintrifft, stellt sich der Monitor wieder auf UP und eine Wiederherstellungsbenachrichtigung wird gesendet.

Das gibt Ihnen eine schnelle, zuverlässige Bestätigung, dass Ihre geplante Aufgabe tatsächlich läuft — und eine klare Warnung in dem Moment, in dem sie stillschweigend stoppt.

Für aktive, regionsbasierte Prüfungen siehe stattdessen So erstellen Sie eine neue API-Prüfung.