O que é heartbeat e quando usar

Em resumo: O monitor heartbeat avisa quando alguma tarefa (tipicamente backup noturno, sync diário ou outro cron job) deixar de rodar. Funciona ao contrário do monitor de uptime clássico - você envia o "ping" para o ePulz.io, e não nós para o seu servidor.

Quando o heartbeat é útil

• Backups noturnos do banco - você quer saber se o backup falhar de noite
• Sincronização com serviço externo - import do CRM, accounting, payment processor
• Faturamento regular - geração de faturas, envio de lembretes
• Tarefas de cleanup - apagar sessions antigas, arquivos temporários, logs
• Relatórios e estatísticas - relatórios semanais/mensais
• Healthcheck de workers em background - Celery, Sidekiq, BullMQ

Como funciona

1. No ePulz.io você cria um monitor heartbeat com o intervalo esperado (por exemplo a cada hora, toda noite às 3:00, etc.)
2. Recebe uma heartbeat URL única - parece https://epulz.io/heartbeat/abc123xyz
3. Você adiciona essa URL ao final do seu script cron / tarefa
4. Quando a tarefa termina com sucesso, ela faz "ping" para essa URL
5. Se o ping não chegar no tempo esperado (+ período de grace), o ePulz.io avisa você

Exemplo prático

Imaginemos um backup noturno do banco que roda todo dia às 3:00 da manhã e dura cerca de 5 minutos:

1. Você cria um monitor heartbeat com o nome "Backup noturno do BD", intervalo 1440 minutos (24 horas), grace 15 minutos
2. Adicione ao script de backup: após o backup bem-sucedido, chame a heartbeat URL
3. Todo dia após as 3:05 o ePulz.io espera o ping. Se não chegar até 3:15 (intervalo + grace), envia um alerta

Interval vs Grace

• Interval - com que frequência o heartbeat deveria chegar (por exemplo a cada hora = 60 minutos)
• Grace - tolerância, quanto esperar após o tempo esperado antes de disparar o alerta

Valores práticos:

Comece

No próximo passo mostramos o procedimento exato para criar o monitor heartbeat no dashboard do ePulz.io.