O que cada tipo de monitor verifica
Um monitor do Uptime Kuma define como verificar a disponibilidade de um serviço. Você escolhe o tipo de teste conforme a resposta que precisa acompanhar, como uma conexão HTTP ou um sinal enviado pelo app.
Ficha e sumário da página
- Referência técnica
- Uptime Kuma 2.5.11
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
HTTP e o endereço do app
O monitor HTTP abre uma URL e avalia a resposta conforme a configuração do teste. O endereço inclui o protocolo, o domínio e o caminho. Ao verificar o endereço público do app, você acompanha também as dependências usadas para chegar até ele, como a resolução do domínio e o proxy reverso.
O status HTTP aceito faz parte dessa configuração. Um redirecionamento, uma página de autenticação ou uma resposta de erro podem mudar o resultado, conforme os valores escolhidos. Você precisa relacionar a resposta aceita ao comportamento daquele endpoint. Aceitar qualquer código esconderia a diferença entre uma página funcionando e um erro servido pelo mesmo endereço.
O HTTPS acrescenta a negociação TLS ao caminho. A conexão pode falhar por certificado inválido antes de o app responder. O resultado continua útil para o acesso público, porque o navegador também precisa estabelecer essa conexão. O Uptime Kuma oferece ainda informações sobre o certificado, separadas do conteúdo da página.
Palavra-chave e consulta JSON
O monitor de palavra-chave examina o corpo da resposta HTTP em busca do texto configurado. Uma página de erro pode devolver o mesmo código HTTP de uma página normal. Nesse caso, a presença de um trecho esperado acrescenta uma verificação sobre o conteúdo retornado, além da conexão e do status.
Uma frase que muda em toda publicação é uma referência frágil para esse teste. Você observa melhor uma informação estável e relacionada à função acompanhada. Mesmo assim, encontrar um texto na página confirma sua presença naquela resposta. O monitor não executa automaticamente todas as ações que um cliente realiza no navegador.
O tipo JSON Query aplica uma consulta à resposta JSON. Ele atende endpoints que expõem um estado estruturado, como um campo de saúde do serviço. A interpretação depende da estrutura devolvida pelo app, por isso uma alteração no nome do campo pode causar falha no monitor mesmo com o processo funcionando.
HTTP
https://app.example.com/healthConsulta um endpoint e avalia sua resposta.
Conteúdo
Palavra-chave ou JSONExamina uma informação dentro da resposta HTTP.
Resultado
HeartbeatRegistra se a condição configurada foi atendida.
TCP, ping e DNS
O monitor TCP tenta estabelecer uma conexão com um host e uma porta. O teste alcança serviços que não oferecem uma página HTTP, mas uma conexão aceita não confirma autenticação nem execução de uma consulta no banco. Você lê o resultado como disponibilidade daquela porta a partir do Uptime Kuma.
O ping usa ICMP para verificar resposta de rede. Um servidor pode atender HTTPS e recusar ICMP por configuração de firewall. Por isso um ping sem resposta não comprova, por si só, que o app está indisponível. O resultado descreve o protocolo testado, não todos os serviços da máquina.
O monitor DNS consulta um registro pelo resolvedor configurado. A resposta informa a resolução daquele nome, inclusive quando o app depende de um domínio público. O cache do resolvedor participa da resposta, então a leitura pode diferir daquela feita por outro cliente na internet durante uma alteração de DNS.
Esses três testes partem da rede do servidor de monitoramento. Um endereço privado acessível dentro da VPS pode não ser alcançável da internet. Da mesma forma, um nome que resolve no seu notebook pode falhar no container do Uptime Kuma. A origem da consulta faz parte do significado do resultado.
Docker e o estado do container
O monitor Docker consulta o Docker Engine para acompanhar um container. A documentação descreve o acesso pelo socket do host ou por uma conexão com a API do daemon. Na versão 2.5.11, o teste considera se o container está em execução, pausado ou reiniciando. Quando existe um healthcheck, também considera a saúde informada pelo Docker. O monitor HTTP observa a resposta oferecida pelo endereço do serviço.
Um container em execução pode ter um app incapaz de responder. Acompanhar ambos os pontos permite distinguir a parada do processo de uma falha no atendimento HTTP. Você nomeia os monitores como “container do app” e “endereço público do app” para identificar a verificação que falhou.
O acesso ao socket do Docker concede controle amplo sobre o daemon. A documentação alerta que uma invasão do Uptime Kuma com esse acesso pode alcançar o host. Esse vínculo exige atenção à exposição do painel e às permissões concedidas, mesmo quando a intenção inicial é apenas consultar o estado do container.
Push e tarefas que precisam avisar
No monitor push, a direção da comunicação muda: o processo acompanhado chama o endereço fornecido pelo Uptime Kuma. Esse formato atende uma tarefa agendada que consegue enviar um sinal após executar seu trabalho. O monitor acompanha a chegada desse sinal dentro do intervalo configurado.
Você relaciona o envio ao término real da tarefa. Uma chamada feita antes do trabalho só comprova que o processo começou. Se um backup envia o sinal após concluir, a ausência dele pode indicar atraso, falha do backup ou falha no caminho até o Uptime Kuma. A mensagem orienta a investigação, mas a causa precisa ser conferida.
A versão 2.5.11 também lista WebSocket e Steam entre os tipos disponíveis. A seleção acompanha o serviço real da sua stack. Depois de definir o teste e interpretar seu resultado, o próximo vínculo é o destino dos avisos de indisponibilidade.