Ajuda e guiasHeartbeat (cron monitoring) › Criar monitor heartbeat

Criar monitor heartbeat

3 min de leitura · Heartbeat (cron monitoring)

Objetivo: Criar um monitor heartbeat e obter a URL de ping para colocar no cron job.

Passo 1: Abra a criação do monitor

  1. No dashboard do ePulz.io clique em + Novo monitor
  2. 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 BD
  • CRM sync (horário)
  • Faturamento semanal
  • Cleanup 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:

  • E-mail
  • 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.

Dica: A URL é secreta - quem a conhece pode fingir que o seu cron está rodando. Não a compartilhe, não a coloque em gits públicos.

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