Criar monitor heartbeat

Objetivo: Criar um monitor Heartbeat e obter o endereço de ping que você insere na sua tarefa cron.

Passo 1: Abra a criação do monitor

1. Na visão geral do ePulz.io, clique em + Adicionar monitor
2. Selecione o tipo Heartbeat (cron)

Passo 2: Nomeie o monitor

Use um nome descritivo que lhe lembre o que está monitorando. Exemplos:

• Backup noturno do BD
• Sincronização com CRM (horária)
• Faturamento semanal
• Limpeza de logins antigos

Passo 3: Defina o intervalo

Intervalo em minutos - com que frequência o Heartbeat deve chegar:

• 5 = a cada 5 minutos (tarefas curtas, verificação de serviço)
• 60 = a cada hora
• 1440 = diariamente (24 × 60)
• 10080 = semanalmente (7 × 24 × 60)

Passo 4: Defina a janela de tolerância (grace)

A tolerância é o tempo após o prazo previsto durante o qual ainda aguardamos. As tarefas cron podem ter um leve desvio (tempo de rede, atraso ou a tarefa demora mais do que o habitual).

Recomendações:

• Cron curto (5-60 min): tolerância 2-10 minutos
• Cron por hora: tolerância 10-15 minutos
• Cron diário: tolerância 30-60 minutos
• Cron semanal: tolerância 6 horas ou mais

Passo 5: Notificações

Ative quais canais devem receber uma notificação quando um Heartbeat for perdido:

• E-mail
• Telegram (requer um bot conectado)
• Webhook (Slack, Discord, endereço próprio)

Passo 6: Salve e obtenha o endereço

Clique em Criar monitor. O detalhe do monitor aparece com o seu endereço Heartbeat único:

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

Você adiciona esse endereço ao seu script cron ou tarefa. A partir de agora, o ePulz.io esperará um ping a cada [interval] minutos.

Estado do monitor

Após a criação, o monitor está no estado Aguardando (esperando o primeiro Heartbeat). Após o primeiro ping bem-sucedido, ele muda para OK. Se o Heartbeat não chegar dentro da janela prevista, ele muda para Queda e envia uma notificação.