Ir para o conteúdo
Promovaweb

O que é o Uptime Kuma

O Uptime Kuma é um monitor de disponibilidade que testa endereços e serviços a partir do servidor onde você o instala. Ele registra os resultados e usa os destinos de notificação configurados para avisar sobre falhas e recuperações.

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
  1. O servidor que faz as verificações
  2. O que um monitor confirma
  3. Heartbeats e mudanças de estado
  4. O alerta chega por outro serviço
  5. O que você apresenta ao cliente

O servidor que faz as verificações

O Uptime Kuma executa testes periódicos contra os serviços cadastrados no painel. Um teste pode abrir o endereço HTTPS de um app, tentar uma conexão numa porta ou consultar um registro DNS. Cada monitor guarda seu próprio destino e a forma de avaliar a resposta, por isso dois monitores do mesmo app podem mostrar resultados diferentes.

Você acompanha essas verificações pelo navegador, mas o trabalho continua no servidor depois que a aba fecha. O painel exibe o histórico recebido do processo que está rodando na VPS. Deixar o navegador aberto não mantém o monitor funcionando quando esse processo para, porque a execução dos testes pertence ao servidor.

O projeto é mantido por Louis Lam e pela comunidade sob licença MIT. A versão de referência deste portal é a 2.5.11. A licença permite usar e modificar o código conforme seus termos, enquanto o nome e o símbolo continuam identificando o projeto original. O portal da Promovaweb explica o produto de forma independente.

  1. Monitor

    Define o destino, o tipo de teste e o intervalo.

  2. Serviço

    Recebe a verificação a partir da rede do Uptime Kuma.

  3. Heartbeat

    Registra o estado e a mensagem produzidos pelo teste.

  4. Aviso

    A mudança de estado segue para os destinos configurados.

O servidor executa o monitor, compara a resposta e registra o resultado antes de apresentar o estado.

O que um monitor confirma

Um monitor HTTP verifica uma resposta do endereço escolhido. Quando você acompanha a página inicial de um app, o teste confirma o comportamento dessa página naquele momento. Uma página inicial acessível pode conviver com uma falha no envio de mensagens ou na gravação de um formulário, pois essas ações percorrem outros caminhos dentro do app.

A escolha do endereço acompanha a função que você precisa observar. Um endpoint de saúde do próprio app pode consultar suas dependências antes de responder. Nesse caso, o monitor recebe uma avaliação feita pelo app. Já uma página estática devolvida pelo proxy pode responder normalmente enquanto o processo principal está parado.

Os tipos de monitor explicam essa diferença pelo mecanismo de cada teste. A conexão TCP confirma acesso à porta. A consulta DNS confirma uma resposta do resolvedor. O monitor de palavra-chave examina o conteúdo devolvido por HTTP. Você escolhe o teste pelo comportamento que deseja verificar, sem interpretar todos os estados verdes como a mesma comprovação.

Heartbeats e mudanças de estado

O heartbeat registra o estado e a mensagem de uma verificação. Nos testes ativos, o servidor produz esse registro ao consultar o serviço. No monitor push, ele recebe o sinal enviado pelo app e acompanha o prazo até o próximo envio. O painel usa esses registros para mostrar as respostas e os períodos de indisponibilidade observados. As barras situam a mudança no tempo, enquanto a mensagem descreve o erro, como uma conexão recusada ou uma resposta HTTP inesperada.

O intervalo define a frequência das verificações. As tentativas adicionais podem manter um monitor em estado pendente antes de confirmar a queda. Você ajusta esses valores por monitor, considerando o tempo aceitável para perceber a falha e o volume de requisições que o serviço recebe. Uma interrupção inteira entre duas verificações pode não aparecer no histórico.

O percentual de disponibilidade resume a janela observada por aquele monitor. Ele depende do destino escolhido e das respostas registradas. Um percentual do endereço público não descreve automaticamente todas as funções do aplicativo, nem substitui a leitura das mensagens de erro durante um atendimento.

O alerta chega por outro serviço

As notificações ligam o estado do monitor a um destino de mensagem. O Uptime Kuma oferece integrações com Telegram e Discord, além de email por SMTP e webhook. Você associa os destinos aos monitores, então um serviço interno pode avisar num canal diferente daquele usado para o app dos clientes.

A mensagem precisa atravessar a rede e ser aceita pelo provedor escolhido. Um monitor que detecta a queda ainda pode falhar ao enviar o aviso quando sua própria VPS perde acesso à internet. A diferença entre verificar o serviço e transportar o alerta até o celular está em notificações.

Um webhook também pode iniciar um fluxo do n8n. Nesse desenho, o Uptime Kuma informa o evento ao n8n. O fluxo interpreta a mensagem e encaminha o aviso ao destino configurado. A automação acrescenta outro serviço ao caminho, portanto sua disponibilidade também participa da chegada do alerta.

O que você apresenta ao cliente

Uma página pública de status reúne os monitores selecionados por você, sem liberar o painel administrativo. Um cliente consulta o estado do atendimento ou do portal enquanto as verificações de serviços internos continuam restritas ao painel.

As mensagens de incidente acrescentam a explicação humana da interrupção. Uma falha de conexão informa o resultado do teste, mas não descreve por si mesma o motivo do problema ou o andamento do reparo. A publicação dessa explicação é uma ação sua, separada da atualização automática dos heartbeats.

O local do monitor também interfere no alcance da observação. Quando o Uptime Kuma e os apps estão na mesma VPS, a queda dessa máquina interrompe ambos. Uma instância em outro servidor consegue observar a perda de acesso à VPS principal. A página Onde o Uptime Kuma roda mostra essa relação entre processo, rede e armazenamento.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.