4UptimePage EntrarCriar conta grátis

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.

Por Equipe UptimePage · · 3 min de leitura
Coração feito de trilhas de circuito emitindo uma linha de batimento verde até um disco de backup e um relógio

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:

  1. Você cria um monitor de heartbeat e define o intervalo esperado (por exemplo, a cada 24 horas).
  2. Recebe um endereço exclusivo, como https://uptimepage.com.br/hb/9f2c….
  3. Ao final da tarefa, o seu script chama esse endereço.
  4. 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.

#heartbeat#cron#backup#filas#monitoramento

Saiba que caiu antes do seu cliente.

Monitore sites, APIs e servidores a cada 30 segundos, receba o alerta onde estiver e mostre uma status page aos seus clientes. 5 monitores grátis, sem cartão.

Começar grátis