Cron-Anleitung

Linux-Cron-Job mit Verifagent überwachen

Cron ist der häufigste Server-Zeitplan. Hängen Sie einen Verifagent-Aufruf nach dem Job-Befehl an — Stille bedeutet, der Job lief nicht oder scheiterte vor dem Ping.

Bevor Sie beginnen

Erstellen Sie einen Monitor mit der tatsächlichen Frequenz Ihres Workflows und kopieren Sie dann die URL aus dem Dashboard. Der Token ist geheim — veröffentlichen Sie ihn nicht.

Zu verwendendes Modul : crontab + curl. Platzieren Sie es nach der letzten sinnvollen Aktion auf dem Erfolgspfad.

Einrichtung

Monitor-URL kopieren

Erstellen Sie einen Monitor, dessen erwartete Periode dem Crontab-Zeitplan entspricht (z. B. täglich um 03:15 → 24h-Periode). Kopieren Sie die Ping-URL aus dem Dashboard.

https://verifagent.com/api/ping/your-ping-token

Echten Befehl mit && verketten

Bearbeiten Sie crontab mit crontab -e. Setzen Sie den Geschäftsbefehl zuerst, dann && curl, damit der Ping nur bei Exit-Code 0 läuft. Ein Ping am Anfang würde Erfolg vortäuschen.

# Täglich um 03:15 — Skriptpfad und URL ersetzen
15 3 * * * /usr/local/bin/backup.sh && curl -fsS "https://verifagent.com/api/ping/your-ping-token"

Absoluten PATH und vollen curl-Pfad verwenden

Cron startet mit minimaler Umgebung. Bevorzugen Sie absolute Pfade für Binaries und Skripte. Fehlt curl im PATH, rufen Sie /usr/bin/curl explizit auf.

# Minimale Umgebung: PATH setzen oder absolute Pfade verwenden
PATH=/usr/local/bin:/usr/bin:/bin
15 3 * * * /usr/local/bin/backup.sh && /usr/bin/curl -fsS "https://verifagent.com/api/ping/your-ping-token"

Zuerst außerhalb von Cron testen

Führen Sie dieselbe verkettete Befehlszeile einmal in der Shell aus. Sie sollten HTTP 200 und {"ok":true} sehen. Warten Sie dann auf den nächsten Cron-Tick oder erzwingen Sie einen Lauf.

/usr/local/bin/backup.sh && curl -fsS "https://verifagent.com/api/ping/your-ping-token"

Immer nach Erfolg pingen (&&), nie davor. Setzen Sie die erwartete Periode auf das Crontab-Intervall und die Kulanz leicht über Worst-Case-Laufzeit plus Uhrenabweichung (oft 5–15 Minuten).

Verfügbare Routen

Die Basis-URL reicht für einen Heartbeat. Varianten bereichern den Verlauf, wenn Ihre Plattform mehrere Zweige hat.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

POST https://YOUR_PING_URL/fail?msg=Error

Prüfen

Nach erfolgreicher Kette öffnen Sie den Monitor: Status wird Up. Brechen Sie den Befehl vorübergehend (false && curl …) und prüfen Sie, dass kein neuer Ping ankommt.

Erwartete Antwort: 200 {"ok":true}. Der Monitor wechselt von Pending zu Up.