Heartbeats für Cronjobs und Backups
Ein Heartbeat überwacht, dass ein Job überhaupt läuft: nächtliches Backup, Shop-Import, Newsletter-Versand, Zertifikatserneuerung. Du legst ihn in den Einstellungen der Domain an (Name, erwartete Periode, Karenz) und baust den Aufruf seiner Ping-Adresse ans Ende des Jobs. Bleibt der Aufruf länger als Periode plus Karenz aus, eröffnet DomainWarn die Meldung heartbeat_missed; der nächste Ping behebt sie sofort. Ein Aufruf von …/fail meldet einen Fehlschlag (heartbeat_failed). Den Heartbeat der geplanten Aufgaben von WordPress und Shopware legt die DomainWarn-Erweiterung selbst an; bleibt er aus, nennt der Befund die typischen Ursachen der Plattform – WP-Cron ohne Cronjob, hängende Scheduled Tasks, Admin-Worker, die Website nicht erreichbar oder die Erweiterung, die sich gar nicht mehr meldet – und stellt die wahrscheinlichste nach dem, was die Erweiterung zuletzt gemeldet hat, voran, samt fertiger Cronjob-Zeile.
Läuft ein Job sehr oft, etwa WP-Cron alle 5 Minuten, überbrückt die Einstellung „Melden nach“ kurze Aussetzer: Der Heartbeat meldet erst, wenn 2, 3, 5 oder 10 Läufe in Folge ausgeblieben sind; die Karenz gilt zusätzlich, ein gemeldeter Fehlschlag zählt sofort. Unter jedem Heartbeat zeigt ein Streifen die letzten 30 Tage, ein Balken je Tag: grün pünktlich, gelb verspätet, rot verpasst oder fehlgeschlagen, dazu der Anteil pünktlicher Läufe. Verpasste Läufe zählen an dem Tag, an dem sie fällig waren.
Die Adresse braucht keine Anmeldung, das Token in der Adresse ist der Nachweis; GET und POST sind gleichwertig. Für Cron eignet sich curl -fsS --retry 3, damit kurze Netzprobleme den Ping nicht verschlucken.
#!/bin/sh
# Backup, danach Heartbeat melden – bei Fehler …/fail
if /usr/local/bin/backup.sh; then
curl -fsS --retry 3 https://api.domainwarn.com/api/v1/heartbeats/<TOKEN>
else
curl -fsS https://api.domainwarn.com/api/v1/heartbeats/<TOKEN>/fail
fi