Começar
Todas as aplicações VPS
Monitorização

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.

Encomendar um servidor com Uptime Kuma Ver planos VPS

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 caddy

Com 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 -d

Có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 start

Como funciona

  1. Escolha Uptime Kuma na página de encomenda do servidor e um plano com memória suficiente.
  2. A aplicação é instalada no servidor no primeiro arranque, normalmente em poucos minutos.
  3. Abra o servidor no seu painel: o endereço e os dados de acesso estão lá.

Perguntas sobre o Uptime Kuma

Sim. O Uptime Kuma é leve: 1 GB de memória e 20 GB de disco é o mínimo e aguenta sem esforço dezenas de monitores. Centenas de monitores com intervalos curtos ficam melhor com 2 GB.
De preferência, não. Se partilharem o servidor e ele falhar, o monitor vai abaixo também e nenhum alerta é enviado. Um pequeno servidor separado é a solução fiável.
Sim. Um plano ARM pequeno serve-lhe tão bem como um x86.
Pelos canais de notificação que configurar no Uptime Kuma: Telegram, email por SMTP, Slack, Discord, webhooks e muitos outros. Adicione um canal uma vez e associe-o aos monitores.
A primeira pessoa a abrir o endereço cria a conta de administrador, por isso abra http://endereco-do-seu-servidor:3001/ assim que o servidor esteja pronto.

Outras aplicações em Monitorização