Monitoramento

O monitoramento aqui é sem agente: nada é instalado nos servidores, nenhuma porta extra é aberta. O app mantém uma conexão SSH por VM monitorada e roda exatamente um comando somente leitura por ciclo de poll.

Ativar para uma VM

Abra a aba Monitoring da VM, então:

1. Ative Enable.
2. Escolha a credencial usada no polling — deve ser uma conta de baixo privilégio, veja Credenciais.
3. Defina o intervalo (em segundos). 60 segundos é um equilíbrio razoável na maioria dos casos.

O polling começa em cerca de 15 segundos — uma tarefa de monitoramento em segundo plano verifica periodicamente quais VMs estão ativadas e as associa a tarefas em execução. Desativar interrompe a tarefa dentro do mesmo intervalo de tempo.

O botão Poll now roda um ciclo imediato sem esperar o próximo agendado.

Cofre Bloqueado Significa Monitoramento Parado

O polling precisa de credenciais, e credenciais vivem no cofre. Então:

• Bloquear o cofre → todas as tarefas de polling param.
• Desbloquear o cofre → as tarefas reiniciam automaticamente.
• Bloquear a tela → nenhum efeito, o polling continua normalmente.

Métricas Coletadas

Grupo	Conteúdo
Carga do sistema	Uptime, load average de 1 minuto, percentual de CPU
Memória	RAM usada/total, swap usada/total
Disco	Por mount: usado, total, percentual
Rede	Taxa de recebimento/envio em bytes por segundo
Processos	Os seis maiores consumidores de CPU
Segurança	Portas escutando, contas, chaves SSH autorizadas, sudoers, log de login

O percentual de CPU e a taxa de rede são derivados entre polls consecutivos — então o primeiro poll depois de ativar o monitoramento não terá esses dois valores.

Histórico e Retenção

• Amostras brutas são mantidas por 14 dias, depois são limpas.
• Enquanto isso, os dados são agregados em resumos diários e mantidos a longo prazo. Os relatórios mensais leem dessa tabela de resumo, não das amostras brutas — se lessem das amostras, um “relatório mensal” acabaria silenciosamente cobrindo só duas semanas.

A aba de monitoramento desenha os gráficos a partir da janela de 14 dias de amostras brutas.

Quando o Servidor Não Responde

Um poll perdido é normal. Duas falhas consecutivas marcam a VM como inacessível e criam um evento.

Depois de cada falha, o intervalo de poll recua gradualmente (máximo de 5 minutos) para evitar martelar uma máquina fora do ar. Quando ela volta, o intervalo retorna ao normal e um evento de recuperação é registrado.

Comando do Probe

É isso que você vai precisar quando o cliente perguntar “o que o software de vocês roda no nosso servidor”. O comando é uma constante no código-fonte, nunca montado a partir de dados do usuário, e o app o exibe literalmente (botão View probe command na aba de monitoramento).

LC_ALL=C; export LC_ALL
echo '@@VMOPS:uptime@@';  cat /proc/uptime
echo '@@VMOPS:load@@';    cat /proc/loadavg
echo '@@VMOPS:cpu@@';     grep '^cpu ' /proc/stat
echo '@@VMOPS:mem@@';     grep -E '^(MemTotal|MemFree|MemAvailable|Buffers|Cached|SwapTotal|SwapFree):' /proc/meminfo
echo '@@VMOPS:net@@';     cat /proc/net/dev
echo '@@VMOPS:disk@@';    df -P -k
echo '@@VMOPS:procs@@';   ps -eo pcpu,pmem,comm --sort=-pcpu | head -6
echo '@@VMOPS:ports@@';   ss -H -tuln || netstat -tuln
echo '@@VMOPS:users@@';   cut -d: -f1,3,7 /etc/passwd
echo '@@VMOPS:keys@@';    # conteúdo legível dos arquivos authorized_keys
echo '@@VMOPS:sudoers@@'; cat /etc/sudoers /etc/sudoers.d/*
echo '@@VMOPS:auth@@';    journalctl -u sshd  # ou /var/log/auth.log
echo '@@VMOPS:fail2ban@@'; fail2ban-client status sshd
echo '@@VMOPS:end@@'

Quatro princípios por trás desse design:

Uma única ida e volta. Cada poll é exatamente um sh -c que retorna um único bloco delimitado. Monitorar 30 máquinas por minuto não pode significar 300 canais de execução.

Ler /proc, não top. A saída de top, vmstat e free muda entre distribuições e locales; /proc não muda.

Fixo e auditável. O comando nunca é montado a partir de dados de entrada — não há superfície para command injection, e o conteúdo pode sempre ser inspecionado.

Degrada, nunca quebra. Qualquer coisa que precise de root e não esteja disponível volta vazia, e o resto do poll ainda chega ao destino.