Como Monitorar Sites pelo Terminal com a CLI da Nova Uptime
Guia passo a passo para monitorar uptime, saúde de e-mail, certificados SSL e incidentes pela linha de comando usando a CLI da Nova Uptime. Sem precisar.
Monitore Tudo Sem Abrir um Navegador#
Se você passa a maior parte do dia no terminal, mudar para um dashboard web só para checar uptime parece errado. Você faz deploy com git push, gerencia servidores com ssh e debuga com curl. Seu monitoramento deveria funcionar do mesmo jeito.
A CLI da Nova Uptime traz toda a sua stack de monitoramento para o terminal — domínios, saúde de e-mail, incidentes, screenshots e gestão de equipe. Este guia mostra tudo o que você pode fazer com ela.
Instalação e Configuração#
Instale via npm#
npm install -g novauptime
Autentique-se#
Faça login direto pelo terminal — sem navegador nem visita ao dashboard:
novauptime auth login
# Escolha "Sign in with email" → digite seu e-mail → digite o código de verificação
Sua API key é gerada e salva automaticamente. Você não vai precisar autenticar de novo, a menos que faça logout.
Verifique a conexão#
novauptime account
Isso mostra seu e-mail, plano atual, quantidade de domínios e limites de uso — confirmando que a CLI está conectada à sua conta.
Verificar Status dos Domínios#
O comando mais usado. Veja todos os seus domínios monitorados de uma vez:
novauptime status
A saída tem cores: verde para UP, vermelho para DOWN, âmbar para DEGRADED. Cada linha mostra o domínio, estado, tempo de resposta, dias restantes do SSL e nota de saúde do e-mail.
Filtrar por estado#
novauptime status --down # Mostra só os domínios fora do ar
novauptime status --degraded # Mostra só os domínios degradados
Saída em JSON para scripts#
novauptime status --json | jq '.[] | select(.state == "down") | .domain'
Isso passa a saída para o jq para extrair só os nomes dos domínios que estão fora do ar — útil para scripts de alerta automatizados.
Gerenciar Domínios#
Adicionar um domínio#
novauptime domains add example.com
O domínio é adicionado com configurações padrão (intervalo de check de 5 minutos, alertas por e-mail ativados). O monitoramento começa imediatamente e a primeira verificação roda em segundos.
Adicionar com configurações customizadas#
novauptime domains add staging.example.com --interval 59 --timeout 15
Isso monitora o site de staging a cada 59 segundos com timeout de 15 segundos — útil para pegar deploys que quebram rápido.
Listar todos os domínios#
novauptime domains list
Remover um domínio#
novauptime domains remove example.com
Isso faz um soft delete — o domínio para de ser monitorado, mas o histórico fica preservado no dashboard.
Verificações de Saúde de E-mail#
Rode uma análise completa de entregabilidade de e-mail para qualquer domínio — checando MX, SPF, DKIM, DMARC e status de blacklist:
novauptime email-health example.com
A saída mostra:
- Pontuação (0-100) com nota em letra (de A até F)
- Registros MX — configuração do servidor de e-mail
- SPF — status e força da política do sender policy framework
- DKIM — configuração do DomainKeys Identified Mail
- DMARC — política de autenticação de mensagens baseada em domínio
- Blacklist — se algum IP de servidor MX está listado em blacklists DNS
Forçar uma verificação nova#
novauptime email-health example.com --fresh
Isso ignora o cache e roda uma verificação ao vivo — útil depois de fazer mudanças de DNS e querer confirmar que propagaram.
Revisar Incidentes#
Liste os incidentes recentes com seus códigos únicos INC-XXXXXX:
novauptime incidents
Cada incidente mostra o domínio, código de status, horário de início e se já foi resolvido. Os códigos INC facilitam referenciar incidentes específicos em conversas com a equipe ou post-mortems.
Filtrar por limite#
novauptime incidents --limit 5
Monitorar URLs (Monitoramento de Links)#
Acompanhe mudanças de conteúdo e tire screenshots de qualquer URL:
novauptime urls list
novauptime urls add https://competitor.com/pricing --detect-changes
Quando o conteúdo da página muda, você recebe uma notificação com um diff mostrando exatamente o que foi adicionado ou removido. Isso é útil para acompanhar preços de concorrentes, monitorar páginas de documentação ou verificar deploys.
Scripts e Automação#
O verdadeiro poder da CLI está na automação. Aqui vão exemplos práticos.
Verificação de saúde pós-deploy#
Adicione isso ao seu pipeline de CI/CD:
#!/bin/bash
# deploy-verify.sh
echo "Deploying to production..."
git push origin main
echo "Waiting for deployment to stabilize..."
sleep 60
STATUS=$(novauptime status --domain myapp.com --json | jq -r '.state')
if [ "$STATUS" = "up" ]; then
echo "Deployment verified — site is UP"
else
echo "WARNING: Site is $STATUS after deployment!"
novauptime incidents --limit 1
exit 1
fi
Relatório diário de saúde de e-mail via cron#
# No seu crontab: roda toda manhã às 8h
0 8 * * * novauptime email-health mycompany.com --json >> /var/log/email-health.json
Script de verificação de status para múltiplos domínios#
#!/bin/bash
# Verifica vários domínios e alerta se algum estiver fora do ar
DOWN=$(novauptime status --json | jq '[.[] | select(.state == "down")] | length')
if [ "$DOWN" -gt 0 ]; then
echo "$DOWN domain(s) are DOWN!"
novauptime status --down
# Adicione sua lógica de alerta aqui (webhook do Slack, PagerDuty, etc.)
fi
Importação em massa de domínios#
Adicione vários domínios a partir de um arquivo de texto:
while IFS= read -r domain; do
novauptime domains add "$domain" --interval 300
echo "Added: $domain"
done < domains.txt
CLI, Dashboard Web ou WhatsApp: Quando Usar Cada Um#
A Nova Uptime te dá três interfaces. Veja quando cada uma brilha:
| Tarefa | Melhor Interface |
|---|---|
| Verificação rápida de status | CLI — novauptime status |
| Adicionar um domínio durante o deploy | CLI — scriptável, sem trocar de contexto |
| Revisar tendências de tempo de resposta de 90 dias | Dashboard Web — gráficos visuais |
| Ser alertado sobre uma queda às 3 da manhã | WhatsApp — notificação instantânea no celular |
| Rodar verificação de saúde de e-mail | CLI ou Web — funcionam igualmente bem |
| Compartilhar status com um cliente | Web — widget de status incorporável |
| Automatizar verificação pós-deploy | CLI — scriptável em CI/CD |
| Integrar um novo membro da equipe | Dashboard Web — visual e intuitivo |
| Revisar histórico de incidentes com screenshots | Dashboard Web — visualização de imagens |
| Auditar saúde de domínios em 50+ sites | CLI — passa para scripts e relatórios |
As interfaces se complementam. Use a CLI para velocidade e automação, o dashboard para visualização e colaboração em equipe, e o WhatsApp para alertas críticos que precisam de atenção imediata.
Comparação: CLI da Nova Uptime vs. Outras Ferramentas de Monitoramento por CLI#
| Recurso | CLI da Nova Uptime | Updo | Gatus | curl + scripts |
|---|---|---|---|---|
| Monitoramento de uptime | Sim | Sim | Sim | Manual |
| Saúde de e-mail (MX/SPF/DKIM/DMARC) | Sim | Não | Não | Não |
| Acompanhamento de certificado SSL | Sim | Sim | Sim | Manual |
| Monitoramento de expiração de domínio | Sim | Não | Não | Não |
| Códigos de incidente (INC-XXXXXX) | Sim | Não | Não | Não |
| Detecção de mudança de conteúdo | Sim | Não | Não | Manual |
| Gestão de equipe | Sim | Não | Não | Não |
| Alertas via WhatsApp | Sim | Não | Não | Não |
| Dashboard web incluído | Sim | Não | Sim | Não |
| Integração com Prometheus | Via webhooks | Nativa | Nativa | Manual |
| Saída em JSON para scripts | Sim | Sim | N/A | Manual |
| Opção self-hosted | Não (SaaS) | Sim | Sim | N/A |
A Nova Uptime troca o self-hosting por uma plataforma gerenciada que inclui a CLI como uma das várias interfaces. Se você quer uma plataforma de monitoramento completa acessível pelo terminal, ela é a opção mais completa disponível.
Requisitos#
- Node.js 18+ — para instalação via npm
- Plano Pro ou Agency — o acesso à CLI exige um plano pago
- Endereço de e-mail — faça login ou cadastro direto pela CLI (sem navegador)
Como Começar#
Três comandos para sair do zero e começar a monitorar:
npm install -g novauptime
novauptime auth
novauptime domains add yoursite.com
Verifique o status quando quiser com novauptime status. Sem precisar de aba do navegador.
Cadastre-se na Nova Uptime ou autentique-se direto pela CLI com novauptime auth login. Explore a documentação completa da CLI com todos os 13 grupos de comandos.
Leitura Relacionada#
Monitor Your Website Before It Goes Down
Get uptime monitoring, SSL tracking, domain expiry alerts, and email health checks. Free plan — no credit card required.
Start Monitoring FreeArtigos relacionados
Por que desenvolvedores estão abandonando dashboards web pelo monitoramento via CLI
Desenvolvedores estão criando ferramentas de monitoramento via CLI porque os dashboards web atrapalham. Por que o monitoramento terminal-first está.
Uptime Monitoring no CLI vs Dashboard: Qual Abordagem Combina Com o Seu Workflow?
Compare uptime monitoring no terminal (CLI) com dashboards web. Prós, contras e como combinar as duas abordagens para o melhor workflow.
Monitoramento de Uptime para Agências: Gerenciando 50+ Domínios de Clientes Sem Enlouquecer
Rode monitoramento de uptime para 50+ domínios de clientes como agência. Tags, acesso de time, status pages white-label, cobrança por cliente. Playbook 2026.