Um heartbeat é o registro de uma verificação feita por um monitor. Cada execução produz um resultado: o serviço respondeu ou não, em quanto tempo, com qual código e com qual mensagem. O conjunto desses registros forma o histórico que aparece no painel e alimenta o cálculo de disponibilidade.
O termo descreve o resultado, não a configuração. O monitor define o que testar, de quanto em quanto tempo e quantas tentativas fazer antes de avisar. O heartbeat é a resposta observada naquela execução.
O que cada resultado informa
Um monitor HTTP registra o código recebido e o tempo de resposta. Um monitor TCP registra se a conexão com a porta foi aceita. Um monitor de ping registra a resposta ICMP. O mesmo serviço pode ter vários monitores, e cada um produz heartbeats próprios.
Essa separação evita uma conclusão errada. Um container em execução e um endereço HTTP podem ter resultados diferentes: o primeiro confirma o processo, e o segundo confirma que a aplicação atende. Quando só o segundo falha, o problema está na aplicação, no proxy ou na porta.
Intervalo, tempo limite e tentativas
O intervalo define a distância entre duas verificações. O tempo limite define quanto o monitor espera antes de considerar a execução sem resposta. As tentativas definem quantas falhas seguidas acontecem antes do alerta.
Um intervalo curto detecta a queda mais rápido e gera mais registros. Um intervalo longo reduz o volume, mas pode demorar a perceber uma indisponibilidade breve. O tempo limite precisa ser menor que o intervalo, para que uma verificação não atrase a seguinte.
As tentativas também mudam a leitura. Um serviço que reinicia em poucos segundos pode produzir uma falha isolada e voltar antes do aviso. O histórico mostra a sequência completa, com o horário de cada heartbeat.
Push e tarefas agendadas
No monitor push, a comunicação se inverte. O Uptime Kuma fornece um endereço, e o processo acompanhado envia um sinal quando termina o trabalho. O heartbeat registra a chegada desse sinal dentro da janela configurada.
O envio precisa acontecer no ponto certo do fluxo. Um backup que avisa antes de copiar os arquivos confirma apenas o início. Um aviso depois da conclusão permite interpretar a ausência como falha do backup ou do caminho até o monitor. O tipo de monitor explica os outros testes disponíveis.
Heartbeat e alerta
O alerta é uma consequência do heartbeat, não o próprio registro. O monitor compara o resultado com as condições e, depois das tentativas configuradas, dispara a notificação. O histórico continua guardando o que aconteceu, mesmo quando o aviso não chega ao destinatário.
Por isso a investigação começa no registro. O horário da queda, o código recebido e o tempo de resposta mostram se a falha foi de rede, de certificado ou do serviço. O endpoint de saúde complementa essa leitura quando a aplicação expõe um estado interno.
Retenção e disponibilidade
O cálculo de disponibilidade usa os heartbeats do período. Uma retenção curta apaga registros antigos e limita a comparação com meses anteriores. A configuração do Uptime Kuma e o espaço em disco definem por quanto tempo o histórico fica disponível.
A leitura de um percentual de 99,9% precisa do período junto. O mesmo número pode representar minutos ou horas de queda, conforme a janela. O SLO define o alvo, e o heartbeat mostra o que aconteceu de fato.
Dúvidas frequentes
Perguntas frequentes sobre Heartbeat
- O heartbeat comprova que a aplicação funciona por completo?
- Não. Ele registra a resposta da verificação configurada. Um HTTP 200 confirma que o endereço respondeu, mas não executa o fluxo de compra nem valida uma consulta no banco. O alcance depende do teste escolhido.
- Por que o monitor mostra queda se o site abre no navegador?
- O monitor parte de outra rede e segue as condições configuradas, como o código aceito, o tempo limite e o conteúdo esperado. Um redirecionamento, uma página de login ou uma diferença de DNS pode produzir um resultado diferente do seu acesso.
- O que muda no monitor push?
- A direção da comunicação. Em vez de o monitor consultar o serviço, a tarefa envia um sinal ao endereço do Uptime Kuma. O heartbeat registra a chegada desse sinal dentro do intervalo.
Para continuar
Recursos relacionados
Repositório
Uptime Kuma: monitoramento e heartbeats
Reúne o código e a documentação do monitor, incluindo os tipos de teste e o registro de cada verificação.
Abrir recursoDocumentação
Uptime Kuma: monitoramento de containers
Mostra como acompanhar o estado do container e o serviço HTTP como verificações separadas.
Abrir recursoSite de referência
Promovaweb: tipos de monitor
Compara o que cada monitor confirma e como interpretar o resultado antes de abrir um alerta.
Abrir recursoAplicação na formação
Formação DevOps
Ao acompanhar a VPS, você lê os heartbeats para separar uma falha do serviço de uma oscilação de rede e conferir o intervalo configurado no monitor.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.