Heartbeat: como saber que seu backup e seus crons pararam
Aprenda a monitorar rotinas agendadas, backups, filas e scripts com heartbeat, o monitoramento que avisa quando uma tarefa deixa de rodar.

Algumas das falhas mais caras não derrubam o site. São rotinas que param de rodar em silêncio: o backup noturno, a emissão de notas fiscais, a sincronização de estoque, o envio da fila de e-mails. Ninguém percebe até o dia em que precisa delas.
O monitoramento comum, que acessa uma URL, não enxerga esse tipo de problema. Para isso existe o heartbeat.
O que é heartbeat
Heartbeat (batimento) é um monitoramento ao contrário. Em vez de o serviço de monitoramento chamar o seu sistema, é o seu sistema que chama um endereço único sempre que termina uma tarefa:
- Você cria um monitor de heartbeat e define o intervalo esperado (por exemplo, a cada 24 horas).
- Recebe um endereço exclusivo, como
https://uptimepage.com.br/hb/9f2c…. - Ao final da tarefa, o seu script chama esse endereço.
- Se o sinal não chegar dentro do prazo (mais uma tolerância), o monitoramento alerta.
É a forma mais simples de saber que algo deixou de acontecer.
Exemplos práticos
Cron no Linux
0 2 * * * /opt/scripts/backup.sh && curl -fsS -m 10 https://uptimepage.com.br/hb/SEU_TOKEN > /dev/null
O && garante que o sinal só é enviado se o backup terminar com sucesso.
Avisando a falha explicitamente
Alguns serviços aceitam um parâmetro de falha. No UptimePage, chamar o endereço com ?fail=1&msg=... registra a falha na hora, com a mensagem:
/opt/scripts/backup.sh || curl -fsS "https://uptimepage.com.br/hb/SEU_TOKEN?fail=1&msg=backup+falhou"
Em código
Em PHP, Node, Python ou qualquer linguagem, basta uma requisição HTTP ao final do job. Use um tempo limite curto para o heartbeat nunca travar a sua rotina.
O que monitorar com heartbeat
- Backups de banco e de arquivos.
- Rotinas agendadas (cron, agendadores de framework, tarefas do Windows).
- Workers de fila: o worker pode enviar um sinal a cada minuto enquanto está vivo.
- Integrações: importação de pedidos, sincronização com ERP, emissão de notas.
- Relatórios que precisam sair todo dia em um horário.
- Renovação de certificados: o próprio script do certbot pode avisar que rodou.
Como escolher o intervalo e a tolerância
- O intervalo é a frequência normal da tarefa (1 minuto, 1 hora, 24 horas).
- A tolerância cobre variações naturais. Um backup que às vezes leva 40 minutos não deve gerar alerta aos 5 minutos de atraso.
Uma regra prática: tolerância de 10% a 25% do intervalo para tarefas longas, e alguns minutos para tarefas frequentes.
Heartbeat não substitui testar o backup
O heartbeat diz que o backup rodou. Ele não garante que o arquivo é restaurável. Inclua no seu calendário um teste de restauração periódico. Um backup que nunca foi restaurado é uma esperança, não um backup.
Onde o heartbeat se encaixa no monitoramento
Combine os três tipos:
- HTTP, para o que o cliente acessa.
- Porta e DNS, para a infraestrutura por trás.
- Heartbeat, para o que roda sozinho.
No UptimePage, os três ficam no mesmo painel, com os mesmos canais de alerta e a mesma status page.
Perguntas frequentes
Heartbeat funciona atrás de firewall?
Sim. O seu sistema só precisa conseguir fazer uma requisição HTTPS de saída. Não é preciso abrir nenhuma porta de entrada.
E se o próprio servidor cair?
Esse é o ponto forte do heartbeat: se o servidor cair, o sinal não chega e o alerta dispara. Ele detecta exatamente o silêncio.
Posso usar heartbeat para saber se um worker está vivo?
Pode. Configure o worker para enviar o sinal a cada minuto e um intervalo de 1 a 2 minutos no monitor.


