Uptime Kuma: monitorização da disponibilidade no seu próprio servidor
Um monitor alojado por si que verifica os seus sites e serviços a cada minuto e o avisa no momento em que algum deixa de responder.
Sobre o Uptime Kuma
O Uptime Kuma é uma ferramenta de monitorização open source criada pelo programador Louis Lam e é hoje um dos projetos de alojamento próprio com mais estrelas no GitHub. Verifica se as coisas respondem: sites por HTTP(S), palavras-chave numa página, portas TCP, ping, registos DNS, bases de dados e mais.
Quando uma verificação falha, envia uma notificação por um de dezenas de canais suportados, incluindo Telegram, Discord, Slack, email e webhooks. Acompanha também os tempos de resposta, avisa antes de os certificados TLS expirarem e permite criar páginas de estado públicas para os seus clientes.
Quem o aloja fá-lo porque é leve, gratuito e tem uma interface limpa que se configura em minutos. Corrê-lo num servidor separado é o pormenor essencial: um monitor que vive na mesma máquina que o seu site não o consegue avisar quando essa máquina vai abaixo.
Para que é usado
Alertas quando um site vai abaixo
Verifique o seu site e a sua API a cada minuto e receba uma mensagem no Telegram ou por email assim que deixarem de responder.
Avisos de expiração de certificados
Seja lembrado dias antes de um certificado HTTPS expirar, em vez de saber pelos clientes.
Uma página de estado pública
Mostre aos clientes o estado atual dos seus serviços numa página controlada por si.
Depois de encomendar
O primeiro arranque do servidor instala o Uptime Kuma e abre a porta 3001 na firewall, por isso o monitor fica acessível em http://endereco-do-seu-servidor:3001/. Na primeira visita, cria a conta de administrador, por isso abra o endereço assim que o servidor esteja pronto. Depois, adicione o primeiro monitor e ligue um canal de notificações.
Onde o instalar
O Uptime Kuma verifica a partir do sítio onde corre. Um monitor no mesmo servidor que os serviços que vigia vai abaixo juntamente com eles e não o consegue avisar, por isso mantenha-o num servidor separado daquilo que monitoriza.
Domínio próprio e HTTPS para o Uptime Kuma
De origem, o Uptime Kuma responde no endereço IP do servidor, em HTTP simples. Para lhe dar um nome como status.example.com com certificado, crie no seu DNS um registo A para esse nome a apontar para o endereço IPv4 do servidor e coloque o Caddy à frente: o Caddy obtém sozinho um certificado Let's Encrypt gratuito e renova-o. Os comandos abaixo são para o Ubuntu 24.04, que é o sistema dos nossos servidores de aplicações.
No painel, abra as portas TCP 80 e 443 na firewall do servidor: o Caddy precisa delas para obter o certificado Let's Encrypt e para 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 à frente, as páginas de estado do Uptime Kuma podem ser partilhadas com os seus clientes: crie uma página de estado, escolha que monitores mostra e divulgue https://status.example.com/status/a-sua-pagina. Também pode associar o domínio diretamente a uma página de estado, nas definições dela.
Com o domínio a funcionar, já ninguém precisa da porta 3001 em bruto: em /opt/uptime-kuma/compose.yml altere "3001:…" para "127.0.0.1:3001:…", execute docker compose up -d e remova a porta 3001 da firewall. A partir daí, o Uptime Kuma só fica acessível por HTTPS.
Atualizar o Uptime Kuma
As imagens em /opt/uptime-kuma/compose.yml estão fixadas em versões exatas, por isso um simples docker compose pull volta a descarregar a mesma versão. Para atualizar, altere a versão na linha image: para a que pretende (leia primeiro as notas da versão) e, depois, descarregue e recrie os contentores. Os dados ficam em volumes Docker e são mantidos.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dCópias de segurança do Uptime Kuma
No painel pode ativar backups diários do servidor inteiro (+20% do preço do plano, são mantidas as 7 cópias mais recentes) e restaurar o servidor a partir de qualquer uma delas. Ainda assim, vale a pena ter uma cópia dos dados da própria aplicação num ficheiro: pode ser levada para outro servidor ou restaurada sem reverter tudo o resto.
Os monitores, as definições de notificação e o histórico de verificações estão no volume uptime-kuma_uptime_kuma (/app/data). Pare a aplicação por um momento, para que o ficheiro da base de dados seja copiado num 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 Uptime Kuma na página de encomenda do servidor e um plano com memória suficiente.
- A aplicação é instalada no servidor no primeiro arranque, normalmente em poucos minutos.
- Abra o servidor no seu painel: o endereço e os dados de acesso estão lá.