slim, SQLite). Seus dados ficam no seu próprio app.
O que ele cria
Um app (imagem) que sobe pronto, sem perguntas. Usa pouca memória (cerca de 120 MiB em repouso); 512 MB é o mínimo de um app web. Exige um plano com imagens Docker e uma vaga de imagem livre; veja Planos e limites.Primeiros passos
1
Crie o administrador
Abra o endereço logo depois do deploy. O Uptime Kuma pede usuário e senha na primeira visita, e quem abrir primeiro cria a conta.
2
Crie o primeiro monitor
Add New Monitor: tipo (HTTP(S), TCP, Ping, DNS, palavra-chave, JSON e outros), nome, alvo e intervalo. O mínimo é 20 segundos; 60 segundos bastam para a maioria dos sites.
3
Conecte um alerta
Settings > Notifications > Setup Notification. Para o Telegram, crie um bot com o @BotFather e informe o token e o id do chat. Marque Default enabled para que todo novo monitor use o canal. Discord, Slack, e-mail (SMTP), webhook e muitos outros funcionam da mesma forma.
4
Publique uma página de status
Status Pages > New Status Page, escolha o endereço curto (
/status/<name>), adicione os monitores e salve. A página é pública e não pede login. Para usar o seu próprio domínio, adicione-o em Domínios do app e informe-o na página de status em Domain Names.Monitor push para jobs agendados
Para cron jobs e backups, crie um monitor Push. O Kuma gera uma URL: faça o job chamá-la a cada execução. Se o job parar de chamar dentro do intervalo, o monitor cai e o alerta dispara.Variáveis
Limites e boas práticas
- O monitor Real Browser não está disponível: a imagem não tem navegador.
- Somente SQLite. Para milhares de monitores, prefira outra configuração.
- Não há monitor de container Docker.
- As verificações partem de um único lugar, o servidor do seu app, então um alerta de “fora do ar” reflete a rota desse servidor até o alvo.
- O deploy sem downtime está desligado: duas cópias no mesmo banco de dados executariam cada monitor duas vezes e enviariam alertas duplicados.
- Os dados (
/app/data/kuma.db) fazem parte dos snapshots do app. O Kuma migra o banco de dados ao atualizar, então um rollback volta com os dados. O histórico antigo é apagado após 180 dias por padrão (Settings > Monitor History).
Problemas comuns
- Alguém criou o administrador antes de mim. Apague os dados em
/app/datacom o gerenciador de arquivos e reinicie para começar de novo, ou restaure um snapshot anterior. - O monitor Ping não responde. O
pingroda sem privilégios e alguns alvos filtram ICMP. Use um monitor TCP ou HTTP. - Alertas duplicados. Mantenha uma única cópia do app.