Cron-/Heartbeat-Monitoring
Der Unterschied zu einem Monitor
Ein regulärer Monitor funktioniert, indem Dumza aktiv deine URL anspricht und die Antwort prüft. Ein Heartbeat-Check funktioniert genau umgekehrt — ein „Totmannschalter“: DEIN Job ruft bei jedem erfolgreichen Durchlauf eine eindeutige Dumza-URL auf. Trifft dieser erwartete Aufruf nicht rechtzeitig ein, benachrichtigt Dumza dich darüber, dass der Job stillschweigend aufgehört hat zu laufen oder mittendrin fehlgeschlagen ist. Das ist für Dinge ohne jeden HTTP-Endpunkt gedacht: ein nächtliches Backup-Skript, ein per Cron geplanter Datenabgleich, ein Queue-Worker.
Einen Heartbeat-Check einrichten
Klicke auf der Heartbeats-Seite auf Erstellen, gib ihm einen Namen und lege das Intervall fest, in dem dein Job laufen soll, plus eine Karenzzeit (zusätzlicher Puffer, bevor Dumza ihn als überfällig betrachtet). Du erhältst eine eindeutige Check-in-URL. Du kannst sie jederzeit auf der Seite des Checks erneut kopieren.
In deinen Job einbinden
Rufe die Check-in-URL als allerletzten Schritt eines erfolgreichen Durchlaufs auf. Ein typischer Crontab-Eintrag: Skript ausführen und, nur wenn es erfolgreich war, die Check-in-URL per curl aufrufen — so meldet sich ein fehlgeschlagener Durchlauf korrekterweise nie und löst korrekterweise eine Benachrichtigung aus. Zum Beispiel: */30 * * * * /path/to/backup.sh && curl -fsS https://dumza.com/api/heartbeat/<your-token>
Karenzzeit beim ersten Durchlauf
Ein brandneuer Heartbeat-Check, der noch nie einen Check-in erhalten hat, alarmiert bei seiner Erstellung nicht sofort — er erhält dasselbe Fenster aus Intervall plus Karenzzeit, um seinen ersten Check-in zu erhalten, bevor Dumza ihn als überfällig betrachtet. Das gibt dir Zeit, die Änderung tatsächlich auszurollen.
Wiederherstellung
Sobald ein Heartbeat-Check nach einer Überfälligkeit wieder regelmäßig eincheckt, erhältst du eine separate Wiederherstellungs-Benachrichtigung — nach demselben Muster wie bei einem Monitor, der nach einem Vorfall wieder erreichbar ist.
Benachrichtigungskanäle
Heartbeat-Checks nutzen genau dieselben Benachrichtigungskanäle wie Monitore (E-Mail, Webhook, Telegram, Slack) — konfiguriere sie auf der eigenen Seite des Heartbeat-Checks.
Limit im kostenlosen Tarif
Bis zu 20 Heartbeat-Checks im kostenlosen Tarif; unbegrenzt in jedem bezahlten Tarif.
Einen Check pausieren
Du kannst einen Heartbeat-Check auf seiner eigenen Seite pausieren — Dumza wartet dann gar nicht mehr auf seine Meldungen, ein pausierter Check wird also nie überfällig und löst nie einen Alarm aus. Pausierte Checks zählen außerdem nicht gegen dein Tariflimit. Wenn du auf einen Tarif mit weniger Heartbeat-Checks wechselst, als du aktuell hast, werden die ältesten automatisch pausiert (die neuesten laufen weiter); nach einem erneuten Upgrade setzt du sie auf ihren Seiten fort.