Criar monitor heartbeat
Objetivo: Criar um monitor heartbeat e obter a URL de ping para colocar no cron job.
Passo 1: Abra a criação do monitor
- No dashboard do ePulz.io clique em + Novo monitor
- Selecione o tipo Heartbeat (cron)
Passo 2: Nomeie o monitor
Use um nome descritivo que te lembre o que você está monitorando. Exemplos:
Backup noturno do BDCRM sync (horário)Faturamento semanalCleanup de sessions antigas
Passo 3: Configure o intervalo
Intervalo em minutos, com que frequência o heartbeat deve chegar:
- 5 = a cada 5 minutos (jobs curtos, healthcheck)
- 60 = a cada hora
- 1440 = diariamente (24 x 60)
- 10080 = semanalmente (7 x 24 x 60)
Passo 4: Configure o período de grace
Grace é a tolerância após o tempo esperado. Crons podem ter um pequeno deslocamento (NTP, network, ou a tarefa demora mais que o usual).
Recomendações:
- Cron curto (5-60 min): grace 2-10 minutos
- Cron horário: grace 10-15 minutos
- Cron diário: grace 30-60 minutos
- Cron semanal: grace 6+ horas
Passo 5: Notificações
Ative quais canais devem receber o alerta por heartbeat perdido:
- Telegram (requer bot conectado)
- Webhook (Slack, Discord, endpoint próprio)
Passo 6: Salve e obtenha a URL
Clique em Criar monitor. Aparece o detalhe do monitor com a sua heartbeat URL única:
https://epulz.io/heartbeat/Qs78OPNIIsCF_-Vj
Esta URL você adiciona ao seu script de cron ou tarefa. O ePulz.io vai esperar o ping a partir de agora a cada [interval] minutos.
Estado do monitor
Após criar, o monitor fica no estado Pending (esperando o primeiro heartbeat). Após o primeiro ping bem-sucedido, alterna para OK. Se o heartbeat não chegar dentro da janela esperada, alterna para Down e envia um alerta.
Próximo passo:
Adicione a heartbeat URL ao seu cron job (exemplos em bash, Python, Node.js).
Adicionar ao cron job