Heartbeats und Cronjobs
So merken Sie sofort, wenn ein Cronjob, Backup oder Hintergrundprozess nicht läuft, zu lange braucht oder fehlschlägt.
Das Prinzip
Ihr Job ruft nach jedem Lauf eine Adresse bei uns auf, den Ping. Bleibt der Ping aus, läuft der Job zu lange oder meldet er einen Fehler, werden Sie alarmiert. So merken Sie, wenn das nächtliche Backup seit Tagen still steht.
Heartbeat anlegen
- Öffnen Sie Heartbeats (
/app/heartbeats) und klicken Sie auf Heartbeat anlegen. - Geben Sie einen Namen ein, zum Beispiel „Backup Datenbank“.
- Wählen Sie den Zeitplan: ein festes Intervall oder einen Cron-Ausdruck mit fünf Feldern samt Zeitzone.
- Legen Sie eine Kulanz fest, also wie lange wir nach dem erwarteten Zeitpunkt warten, bevor wir alarmieren.
- Optional: eine maximale Laufzeit zwischen Start und Erfolg.
- Speichern Sie und kopieren Sie die Ping-Adresse.
Die App zeigt den Zeitplan in verständlichen Worten, den letzten Ping und Beispiele für curl, cron und systemd.
Pings senden
Die Ping-Adresse hat diese Form:
https://monitor.agiledeveloper.de/api/ping/<token>Sie funktioniert per GET oder POST und braucht keine weitere Anmeldung. Zusätzlich gibt es:
/start: Der Job hat begonnen (für die maximale Laufzeit)./fail: Der Job ist fehlgeschlagen./<exitcode>: Exitcode anhängen; alles außer 0 gilt als Fehler.
# Erfolg melden
0 3 * * * /opt/backup.sh && curl -fsS -m 10 https://monitor.agiledeveloper.de/api/ping/<token>
# Start melden und Exitcode anhängen
0 3 * * * curl -fsS -m 10 https://monitor.agiledeveloper.de/api/ping/<token>/start; /opt/backup.sh; curl -fsS -m 10 https://monitor.agiledeveloper.de/api/ping/<token>/$?Ausgabe mitschicken
Per POST können Sie bis zu 10 KB Ausgabe mitsenden. Sie erscheint im Verlauf des Heartbeats und hilft bei der Fehlersuche:
/opt/import.sh 2>&1 | tail -c 10000 | curl -fsS -m 10 --data-binary @- https://monitor.agiledeveloper.de/api/ping/<token>systemd und Kubernetes
[Service]
Type=oneshot
ExecStart=/bin/sh -c '/opt/backup.sh; curl -fsS -m 10 https://monitor.agiledeveloper.de/api/ping/<token>/$?'In einem Kubernetes-CronJob hängen Sie den Ping an das Kommando an und rufen im Fehlerfall /fail auf.
Mit einem Fehler-SDK
Die Cron-Check-ins der offiziellen Open-Source-Fehler-SDKs werden automatisch zu Heartbeats. Den Zeitplan übernehmen wir aus der Konfiguration im SDK. Per curl geht es auch ohne vorherige Anlage, mit Projektnummer, einem frei gewählten Namen und dem Projekt-Schlüssel:
curl "https://monitor.agiledeveloper.de/api/<nummer>/cron/nachtlauf/<schluessel>/?status=ok"Weitere Beispiele: https://monitor.agiledeveloper.de/docs/einrichten#heartbeats
Alarme
- Verpasst: Kein Ping innerhalb von Zeitplan und Kulanz.
- Fehlgeschlagen:
/failoder ein Exitcode ungleich 0. - Zu lang: Nach
/startkam der Erfolg nicht innerhalb der maximalen Laufzeit. - Wieder in Ordnung: Der nächste erfolgreiche Ping schließt den Vorfall.
Für „verpasst“ gibt es bei jedem neuen Projekt eine Standardregel per Push und E-Mail an die Admins.
Grenzen
| Tarif | Heartbeats |
|---|---|
| Kostenlos | 5 |
| Starter | 25 |
| Team | 100 |
| Agentur | 300 |
Pings zählen nicht ins Ereignis-Kontingent. Der Verlauf der Pings bleibt 90 Tage gespeichert.