As páginas de status do Uptime Kuma
Uma página de status do Uptime Kuma mostra os monitores selecionados por você e o histórico das verificações. O cliente consulta os estados e os avisos publicados sem entrar no painel administrativo.
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
A seleção pública dos serviços
O painel administrativo reúne os monitores que você acompanha. Uma página pública de status apresenta a seleção desses monitores em grupos. Essa separação permite mostrar o atendimento e o portal do cliente enquanto o monitor de uma porta interna continua fora da apresentação pública.
O nome apresentado precisa identificar o serviço para o cliente. Um nome interno de container pode fazer sentido no painel, mas pouco explica sobre a função indisponível. Você organiza os grupos pela relação entre os serviços mostrados, mantendo a correspondência entre cada rótulo e o teste que realmente produz aquele estado.
A seleção pública também define o alcance do que a página informa. Um app pode depender de banco, fila e serviços externos sem expor todas essas verificações. O estado do monitor publicado descreve seu teste, por isso uma página com todos os itens disponíveis ainda pode omitir uma função do app que não está sendo acompanhada.
Uptime KumaExecuta os monitores e guarda os heartbeats.Painel administrativoConfiguração dos testes e dos destinos de notificação.Página de statusApresentação pública escolhida por você.Grupos de serviçosMonitores selecionados para consulta do cliente.Mensagens publicadasManutenções e incidentes associados à página.
As barras e o histórico observado
As barras de heartbeat representam resultados das verificações. Elas oferecem uma sequência visual para localizar períodos de mudança, mas cada resultado vem de um teste executado em um instante. Uma interrupção que começa e termina entre verificações pode não produzir um heartbeat de falha.
O percentual de disponibilidade acompanha uma janela de tempo e o monitor correspondente. A interpretação depende da frequência de verificação e do endereço observado. Você apresenta esse percentual como histórico do teste, sem convertê-lo numa promessa de que todas as funções do aplicativo estiveram acessíveis pelo mesmo período.
A mensagem de incidente complementa esse histórico com uma explicação escrita. Um monitor HTTP pode apontar falha ao alcançar o app, mas não informa automaticamente se o motivo é uma atualização, um problema na rede ou uma alteração de configuração. A explicação publicada descreve o que você já confirmou sobre a interrupção.
A página usa cache
A documentação oficial descreve a página pública como uma página tradicional, com atualização menos responsiva que a do dashboard. Na versão 2.5.11, o servidor configura cache de cinco minutos para a configuração pública da página e de um minuto para o endpoint de heartbeats. Uma mudança relevante de estado do monitor também limpa o cache, portanto esses prazos não representam uma espera obrigatória a cada mudança.
Essa diferença evita interpretar uma divergência breve entre o painel e a página como um defeito do monitor. O dashboard pode já exibir uma recuperação enquanto a página ainda apresenta uma resposta guardada em cache. O comportamento também depende da atualização feita pelo navegador e de outros caches colocados na frente do servidor.
Você considera esse atraso ao comunicar o andamento de um incidente. A página pública serve para consulta compartilhada, enquanto o acompanhamento administrativo usa o painel e os registros do monitor. Prometer que ambos refletem cada mudança no mesmo instante descreveria um funcionamento diferente daquele documentado.
Um domínio para cada página
O Uptime Kuma aceita várias páginas de status na mesma instância. Cada página tem seu próprio endereço e pode receber um domínio específico. Essa organização permite separar a apresentação de serviços destinados a públicos diferentes, mantendo os monitores no mesmo servidor.
O domínio precisa chegar ao Uptime Kuma pela rede e ser associado à página. Com um proxy reverso, o cabeçalho de host participa dessa identificação. O Traefik encaminha a requisição do domínio ao serviço, enquanto o Uptime Kuma seleciona a página correspondente àquele nome.
A existência de domínios diferentes não cria servidores independentes. Todas essas páginas continuam dependendo da instância que as publica. Quando o próprio Uptime Kuma para, a apresentação pública também pode ficar inacessível, mesmo que os apps acompanhados continuem funcionando normalmente.
Incidente e manutenção têm usos diferentes
A mensagem de incidente descreve uma ocorrência que você deseja comunicar. Sua publicação exige uma ação autenticada no painel, com título e conteúdo. O texto pode ser atualizado conforme a investigação avança, mantendo a explicação ligada à página correspondente.
A manutenção registra um período planejado para os monitores selecionados. Além de suspender notificações nesses monitores, ela pode exibir uma mensagem nas páginas escolhidas. O cliente recebe a explicação da intervenção no mesmo lugar usado para consultar a disponibilidade.
Você preserva a precisão dos dois registros ao escrever somente o que já foi confirmado. Uma falha no monitor não demonstra por si mesma a causa da interrupção. Um aviso de manutenção também não confirma que o reparo terminou, porque o horário programado e a resposta real do serviço são informações diferentes.
A página Manutenção e incidentes desenvolve essa relação entre agenda, estado observado e mensagem publicada. O resultado útil para o cliente é saber qual serviço está afetado e qual informação você tem sobre ele naquele momento.