Guida e tutorialHeartbeat (cron monitoring) › Crea monitor heartbeat

Crea monitor heartbeat

3 min di lettura · Heartbeat (cron monitoring)

Obiettivo: creare un monitor heartbeat e ottenere l'URL di ping da inserire in un cron job.

Passo 1: apri la creazione del monitor

  1. Nella dashboard di ePulz.io clicca su + Nuovo monitor
  2. Seleziona il tipo Heartbeat (cron)

Passo 2: assegna un nome al monitor

Usa un nome descrittivo che ti ricordi cosa stai monitorando. Esempi:

  • Backup DB notturno
  • Sync CRM (orario)
  • Fatturazione settimanale
  • Cleanup sessioni vecchie

Passo 3: imposta l'intervallo

Intervallo in minuti, ogni quanto deve arrivare l'heartbeat:

  • 5 = ogni 5 minuti (job brevi, healthcheck)
  • 60 = ogni ora
  • 1440 = giornaliero (24 × 60)
  • 10080 = settimanale (7 × 24 × 60)

Passo 4: imposta il periodo di grace

Grace è la tolleranza oltre l'orario atteso. I cron possono avere un lieve scostamento (NTP, rete, oppure l'attività dura più del solito).

Raccomandazioni:

  • Cron breve (5-60 min): grace 2-10 minuti
  • Cron orario: grace 10-15 minuti
  • Cron giornaliero: grace 30-60 minuti
  • Cron settimanale: grace 6+ ore

Passo 5: notifiche

Attiva i canali che devono ricevere l'alert in caso di heartbeat mancato:

  • Email
  • Telegram (richiede un bot collegato)
  • Webhook (Slack, Discord, endpoint personalizzato)

Passo 6: salva e ottieni l'URL

Clicca Crea monitor. Si apre il dettaglio del monitor con il tuo URL heartbeat univoco:

https://epulz.io/heartbeat/Qs78OPNIIsCF_-Vj

Questo URL va inserito nel tuo script cron o nella tua attività. ePulz.io si aspetterà un ping ogni [intervallo] minuti da adesso.

Suggerimento: l'URL è segreto - chi lo conosce può fingere che il tuo cron giri. Non condividerlo, non metterlo in git pubblici.

Stato del monitor

Dopo la creazione il monitor è nello stato Pending (in attesa del primo heartbeat). Dopo il primo ping riuscito passa a OK. Se l'heartbeat non arriva entro la finestra attesa, passa a Down e invia l'alert.

Prossimo passo:

Aggiungi l'URL heartbeat al tuo cron job (esempi in bash, Python, Node.js).

Aggiunta al cron job