Monitorização de disponibilidade auto-alojada com o Uptime Kuma

Porquê monitorização auto-alojada

O Uptime Kuma verifica HTTP(S), TCP e ping e pode alertar por Telegram ou email. Teste a entrega das notificações.

Passo 1 — Um clique na criação do servidor

Crie uma conta, Servidores → Novo servidor: o plano mais pequeno, qualquer imagem Ubuntu ou Debian, assinale Uptime Kuma. O primeiro arranque instala o Docker e inicia o Kuma na porta 80.

Passo 2 — Criar a conta de administrador, adicionar monitores

Abra http://<server-ip>/ — a primeira visita é o assistente de configuração do Kuma; crie a conta de administrador de imediato (até o fazer, o assistente está aberto a qualquer pessoa que encontre o IP). Depois adicione os seus primeiros monitores: o URL do seu site, o endpoint de saúde da sua API, a porta SSH de um servidor que lhe interesse.

Passo 3 — Configurar alertas do Telegram

Definições → Notificações → Telegram: crie um bot com o @BotFather, cole o token, envie uma mensagem ao bot e deixe o Kuma detetar o chat ID. Associe a notificação aos seus monitores e desligue o servidor de teste uma vez para ver o alerta a chegar mesmo.

Guarde os dados e a base de dados e teste o restauro. Os volumes Docker nomeados não ficam no diretório do projeto Compose.

Uma disposição sensata para uma stack pequena

Uma regra honesta de monitorização: não corra o vigilante na mesma máquina que o vigiado. Dê ao Kuma o seu próprio servidor pequeno, idealmente numa região diferente daquilo que monitoriza.