O Uptime Kuma chama cada serviço de tempos em tempos e avisa quando a resposta não vem. Três cuidados fazem o aviso chegar antes do cliente.
- Instale o monitor fora da máquina que ele vigia.
- Teste o endereço que o cliente usa, com HTTPS.
- Ligue um canal de aviso e simule uma queda.
O webhook do n8n parou às duas da manhã e você soube às nove, pelo cliente. O Uptime Kuma, monitor de código aberto, testa cada serviço em intervalos curtos e avisa quando algum para de responder.
Fora da máquina vigiada
Monitor que roda na mesma máquina dos serviços cai junto com eles e não avisa ninguém. Instale o Kuma em outra máquina, de preferência em outro datacenter, pelo mesmo motivo que leva a manter separado o que não pode parar junto. O guia de instalação sobe tudo num contêiner:
docker run -d --restart=unless-stopped -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2O painel abre na porta 3001. Os dados ficam no volume uptime-kuma, em disco local, porque o README do projeto avisa que NFS não é suportado. Com o painel na internet, ponha HTTPS na frente, como o Caddy do n8n com Docker Compose.
O que monitorar
O Kuma testa HTTP(s), TCP, ping, DNS, contêineres Docker e outros tipos, a cada 20 segundos se você quiser. No n8n, crie um monitor HTTP(s) para https://n8n.seudominio.com.br/healthz/readiness: pela documentação do n8n, esse endereço só responde 200 com o banco conectado, então o mesmo monitor vigia o n8n e o Postgres sem expor o banco à internet.
Em painel de cliente, o tipo HTTP(s) Keyword procura uma palavra na resposta e pega a página que carrega com erro. O que roda por dentro, como o backup, vai no tipo Push, que inverte a lógica: a tarefa chama uma URL do Kuma ao terminar, e o alerta sai quando a chamada não chega no prazo.
Avisos que chegam
O Kuma avisa por Telegram, Discord, Slack, e-mail e mais de 90 serviços. Ligue pelo menos um canal em cada monitor, de preferência um que você não silencia à noite.
Depois, num horário sem fluxo agendado, pare o n8n com docker stop por dois minutos e veja quanto tempo o aviso leva. Se demorar, encurte o intervalo; se não chegar, revise o canal.
Quando a queda se repete
Queda isolada pode ser a rede no caminho. Se o n8n cai sempre no mesmo horário, ou o gráfico de resposta sobe com os fluxos pesados, o problema costuma estar na máquina. Antes de trocar de plano, veja como medir o n8n para saber se a culpa é do banco, da memória ou de um fluxo pesado.
