Hilfe und Anleitungen ›
Heartbeat (Cron-Monitoring)
› Was ist Heartbeat und wann verwenden
Was ist Heartbeat und wann verwenden
3 Min. Lesezeit · Heartbeat (Cron-Monitoring)
Kurz gesagt: Ein Heartbeat-Monitor benachrichtigt Sie, wenn eine Aufgabe (typischerweise ein nächtliches Backup, eine tägliche Synchronisation oder ein anderer Cron-Job) nicht mehr läuft. Es funktioniert umgekehrt zum klassischen Uptime-Monitor - Sie senden den "Ping" an ePulz.io, nicht wir an Ihren Server.
Wann ist Heartbeat nützlich
- Nächtliche Datenbank-Backups - Sie wollen wissen, wenn das Backup nachts fehlschlägt
- Synchronisation mit einem externen Dienst - Import aus CRM, Accounting, Payment Processor
- Regelmäßige Rechnungsstellung - Generierung von Rechnungen, Versand von Erinnerungen
- Cleanup-Aufgaben - Löschen alter Sessions, temporärer Dateien, Logs
- Berichte und Statistiken - wöchentliche/monatliche Berichte
- Healthcheck von Background-Workern - Celery, Sidekiq, BullMQ
So funktioniert es
- In ePulz.io erstellen Sie einen Heartbeat-Monitor mit erwartetem Intervall (z. B. jede Stunde, jede Nacht um 3:00 usw.)
- Sie erhalten eine eindeutige Heartbeat-URL - sie sieht aus wie
https://epulz.io/heartbeat/abc123xyz - Diese URL fügen Sie am Ende Ihres Cron-Skripts / Ihrer Aufgabe hinzu
- Wenn die Aufgabe erfolgreich abgeschlossen wird, "pingt" sie diese URL
- Wenn der Ping nicht zum erwarteten Zeitpunkt (+ Grace-Periode) eintrifft, benachrichtigt Sie ePulz.io
Praktisches Beispiel
Stellen wir uns ein nächtliches Datenbank-Backup vor, das jeden Tag um 3:00 morgens läuft und ~5 Minuten dauert:
- Sie erstellen einen Heartbeat-Monitor mit dem Namen "Nächtliches DB-Backup", Intervall 1440 Minuten (24 Stunden), Grace 15 Minuten
- Zum Backup-Skript fügen Sie hinzu: Nach erfolgreichem Backup die Heartbeat-URL aufrufen
- Jeden Tag nach 3:05 erwartet ePulz.io einen Ping. Wenn er nicht bis 3:15 (Intervall + Grace) eintrifft, sendet es Ihnen eine Benachrichtigung
Schlüsselprinzip:
Die Heartbeat-URL rufen Sie nur nach erfolgreichem Abschluss der Aufgabe auf. Wenn das Skript fehlschlägt, geht kein Ping durch, ePulz.io erfährt davon und benachrichtigt Sie. Kein Ping = Ausfall.
Intervall vs. Grace
- Intervall - wie oft der Heartbeat eintreffen sollte (z. B. jede Stunde = 60 Minuten)
- Grace - Toleranz, wie lange nach der erwarteten Zeit gewartet wird, bevor eine Benachrichtigung ausgelöst wird
Praktische Werte:
| Aufgabe | Intervall | Grace |
|---|---|---|
| Jede Stunde | 60 Min. | 10 Min. |
| Tägliches Backup (dauert durchschnittlich 20 Min.) | 1440 Min. | 60 Min. |
| Wöchentlicher Bericht | 10080 Min. | 6 Stunden |
| Worker-Check alle 5 Minuten | 5 Min. | 2 Min. |
Loslegen
Im nächsten Schritt zeigen wir das genaue Vorgehen, wie Sie einen Heartbeat-Monitor im ePulz.io-Dashboard erstellen.