Guida cron

Monitora un cron job Linux con Verifagent

Cron è la pianificazione server più comune. Aggiungi una chiamata Verifagent dopo il comando del job così il silenzio significa che il job non è partito o è fallito prima del ping.

Prima di iniziare

Crea un monitor con la frequenza reale del workflow, poi copia l'URL dalla dashboard. Il token è segreto: non pubblicarlo.

Modulo da usare : crontab + curl. Posizionalo dopo l'ultima azione utile sul percorso di successo.

Configurazione

Copia l'URL del monitor

Crea un monitor con periodo atteso uguale alla pianificazione crontab (ad es. ogni giorno alle 03:15 → periodo 24h). Copia l'URL di ping dalla dashboard.

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

Concatena il comando reale con &&

Modifica crontab con crontab -e. Metti prima il comando di business, poi && curl così il ping parte solo se il comando esce con 0. Un ping all'inizio mentirebbe sul successo.

# Ogni giorno alle 03:15 — sostituisci il percorso dello script e l'URL
15 3 * * * /usr/local/bin/backup.sh && curl -fsS "https://verifagent.com/api/ping/your-ping-token"

Usa PATH assoluto e percorso completo di curl se necessario

Cron parte con un ambiente minimale. Preferisci percorsi assoluti per binari e script. Se curl manca dal PATH, chiama esplicitamente /usr/bin/curl.

# Ambiente minimale: imposta PATH o usa percorsi assoluti
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"

Testa prima fuori da cron

Esegui la stessa catena di comandi nella shell una volta. Dovresti vedere HTTP 200 e {"ok":true}. Poi attendi il prossimo tick cron o forza un'esecuzione.

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

Pinga sempre dopo il successo (&&), mai prima. Imposta il periodo atteso sull'intervallo crontab e la tolleranza leggermente sopra il runtime peggiore più lo skew dell'orologio (spesso 5–15 minuti).

Route disponibili

L'URL base basta per un heartbeat. Le varianti arricchiscono la cronologia se la piattaforma ha più rami.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

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

Verifica

Dopo un'esecuzione concatenata riuscita, apri il monitor: lo stato diventa Up. Rompi temporaneamente il comando (false && curl …) e conferma che non arriva alcun nuovo ping finché non lo correggi.

Risposta attesa: 200 {"ok":true}. Il monitor passa da In attesa a Up.