Uptime Kuma: monitoramento de disponibilidade no seu próprio servidor
Um monitor auto-hospedado que verifica seus sites e serviços a cada minuto e avisa no instante em que um deles para de responder.
Sobre o Uptime Kuma
O Uptime Kuma é uma ferramenta de monitoramento de código aberto criada pelo desenvolvedor Louis Lam e hoje um dos projetos auto-hospedados com mais estrelas no GitHub. Ele verifica se as coisas respondem: sites por HTTP(S), palavras-chave em uma página, portas TCP, ping, registros DNS, bancos de dados e mais.
Quando uma verificação falha, ele envia uma notificação por um dos vários canais suportados, entre eles Telegram, Discord, Slack, e-mail e webhooks. Ele também acompanha os tempos de resposta, avisa antes de os certificados TLS expirarem e permite montar páginas de status públicas para seus clientes.
As pessoas o hospedam por conta própria porque ele é leve, gratuito e tem uma interface limpa que se configura em minutos. Rodá-lo em um servidor separado é o detalhe essencial: um monitor que fica na mesma máquina que o seu site não consegue avisar quando essa máquina cai.
Para que as pessoas usam
Alertas quando um site cai
Verifique seu site e sua API a cada minuto e receba uma mensagem no Telegram ou por e-mail assim que eles pararem de responder.
Avisos de expiração de certificado
Seja lembrado dias antes de um certificado HTTPS vencer, em vez de ficar sabendo pelos clientes.
Uma página de status pública
Mostre aos clientes o estado atual dos seus serviços em uma página que você controla.
Depois da contratação
A primeira inicialização do servidor instala o Uptime Kuma e abre a porta 3001 no firewall, então o monitor fica acessível em http://endereco-do-servidor:3001/. Na primeira visita, você cria a conta de administrador, então abra o endereço assim que o servidor estiver pronto. Depois, adicione seu primeiro monitor e conecte um canal de notificação.
Onde rodar
O Uptime Kuma verifica a partir de onde está rodando. Um monitor no mesmo servidor dos serviços que ele vigia cai junto com eles e não consegue avisar você, então mantenha-o em um servidor separado do que ele monitora.
Domínio próprio e HTTPS para o Uptime Kuma
Logo após a instalação, o Uptime Kuma responde no endereço IP do servidor, por HTTP simples. Para dar a ele um nome como status.example.com com certificado, crie no seu DNS um registro A para esse nome apontando para o endereço IPv4 do servidor e coloque o Caddy na frente: o Caddy obtém sozinho um certificado gratuito da Let's Encrypt e o renova. Os comandos abaixo são para o Ubuntu 24.04, que nossos servidores de aplicativos usam.
No painel, abra as portas TCP 80 e 443 no firewall do servidor: o Caddy precisa delas para obter o certificado da Let's Encrypt e servir o site.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyCom um domínio na frente, as páginas de status do Uptime Kuma podem ser compartilhadas com seus clientes: crie uma página de status, escolha quais monitores ela mostra e divulgue https://status.example.com/status/sua-pagina. Você também pode associar o domínio diretamente a uma página de status nas configurações dela.
Quando o domínio estiver funcionando, ninguém mais precisa da porta 3001 direta: em /opt/uptime-kuma/compose.yml, troque "3001:…" por "127.0.0.1:3001:…", rode docker compose up -d e remova a porta 3001 do firewall. A partir daí, o Uptime Kuma só pode ser acessado por HTTPS.
Atualizar o Uptime Kuma
As imagens em /opt/uptime-kuma/compose.yml estão fixadas em versões exatas, então um simples docker compose pull baixa a mesma versão de novo. Para atualizar, troque a versão na linha image: pela que você quer (leia antes as notas da versão), baixe a imagem e recrie os contêineres. Os dados ficam em volumes do Docker e são preservados.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dBackup do Uptime Kuma
No painel, você pode ativar backups diários do servidor inteiro (+20% sobre o preço do plano, com as últimas 7 cópias guardadas) e restaurar o servidor a partir de qualquer uma delas. Mesmo assim, vale ter uma cópia dos dados do próprio aplicativo em um arquivo: ela pode ser levada para outro servidor ou restaurada sem voltar todo o resto no tempo.
Os monitores, as configurações de notificação e o histórico de verificações ficam no volume uptime-kuma_uptime_kuma (/app/data). Pare o aplicativo por um instante para que o arquivo do banco de dados seja copiado em um estado consistente:
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose startComo funciona
- Escolha o Uptime Kuma na página de contratação do servidor e um plano com memória suficiente.
- O aplicativo é instalado no servidor na primeira inicialização, normalmente em poucos minutos.
- Abra o servidor no seu painel: o endereço e os dados de acesso estão lá.