Cos'è heartbeat e quando usarlo

In breve: il monitor heartbeat ti avvisa quando un'attività (tipicamente un backup notturno, una sync giornaliera o un altro cron job) smette di funzionare. Funziona al contrario rispetto al classico uptime monitor: sei tu a inviare il "ping" verso ePulz.io, non noi al tuo server.

Quando l'heartbeat è utile

• Backup notturni del database - vuoi sapere se il backup notturno fallisce
• Sincronizzazione con un servizio esterno - import da CRM, accounting, payment processor
• Fatturazione periodica - generazione di fatture, invio di solleciti
• Attività di cleanup - eliminazione di sessioni vecchie, file temporanei, log
• Report e statistiche - report settimanali/mensili
• Healthcheck di worker in background - Celery, Sidekiq, BullMQ

Come funziona

1. In ePulz.io crei un monitor heartbeat con l'intervallo atteso (ad es. ogni ora, ogni notte alle 3:00, ecc.)
2. Ricevi un URL heartbeat univoco - appare come https://epulz.io/heartbeat/abc123xyz
3. Aggiungi questo URL alla fine del tuo script cron / attività
4. Quando l'attività termina con successo, "pinga" questo URL
5. Se il ping non arriva entro il tempo atteso (+ periodo di grace), ePulz.io ti avvisa

Esempio pratico

Immaginiamo un backup notturno del database che gira ogni giorno alle 3:00 del mattino e dura circa 5 minuti:

1. Crei un monitor heartbeat chiamato "Backup DB notturno", intervallo 1440 minuti (24 ore), grace 15 minuti
2. Nello script di backup aggiungi: dopo il backup riuscito chiama l'URL heartbeat
3. Ogni giorno dopo le 3:05 ePulz.io si aspetta il ping. Se non arriva entro le 3:15 (interval + grace), ti invia un alert

Interval vs Grace

• Interval - ogni quanto dovrebbe arrivare l'heartbeat (ad es. ogni ora = 60 minuti)
• Grace - tolleranza, quanto attendere dopo l'orario atteso prima di scatenare l'alert

Valori pratici:

Inizia

Nel prossimo passo mostriamo la procedura esatta per creare un monitor heartbeat nella dashboard di ePulz.io.