O que este guia cobre
O WatchZit é um sistema de monitoramento gratuito e de código aberto (AGPLv3) para redes e servidores. Além das verificações de ping, SNMP, web e bancos de dados, ele tem um pequeno agente para Windows e Linux. Desde a versão 1.4 existem dois tipos de verificação que não precisam de nada instalado na máquina: Linux por SSH (sem agente) e Windows por WinRM (sem agente).
O que é medido
As duas verificações leem os mesmos valores de uma máquina em que nada está instalado:
- a carga de CPU (medida durante um segundo a cada execução),
- a memória em uso,
- o swap no Linux ou o arquivo de paginação no Windows,
- o disco mais cheio,
- o uptime,
- e no Linux também o load.
Os valores têm os mesmos nomes dos valores do agente. Por isso os gatilhos integrados de CPU, memória e discos, e as previsões, funcionam nessas verificações sem nenhuma configuração extra.
Preparar um servidor Linux (SSH)
O WatchZit entra por SSH e executa um único comando fixo que só lê /proc, df e uname. Nada é gravado no servidor.
- Usuário: qualquer usuário que possa entrar por SSH é suficiente — sem root, sem sudo. Um usuário próprio, por exemplo
monitor, o mantém separado das contas das pessoas. - Senha ou chave privada: uma das duas. A chave pode estar no formato OpenSSH ou PEM e não pode ter frase-senha. O WatchZit guarda a senha ou a chave criptografadas e nunca mais as mostra.
- Porta: 22, a menos que você informe outra. O servidor WatchZit (ou o coletor remoto que executa a verificação) precisa alcançá-la.
Chave do host: confiança no primeiro uso
Na primeira conexão, a verificação aceita a chave do host do servidor e a guarda. A cada execução seguinte, a chave é conferida. Quando ela muda, a verificação fica fora e mostra a nova chave — assim, um servidor trocado ou uma conexão interceptada não passam despercebidos. Se a mudança era esperada, por exemplo porque a máquina foi reinstalada, abra a verificação, marque Esquecer a chave de anfitrião guardada e aceitar a seguinte e salve.
Se não quiser depender da primeira conexão, informe você mesmo a impressão digital no campo Chave de anfitrião. No servidor, este comando a mostra:
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
O campo aceita uma impressão digital SHA256 como SHA256:…; vazio significa que a primeira chave é aceita.
Preparar um servidor Windows (WinRM)
No Windows, o WatchZit lê o WMI pelo WinRM. O Windows Server vem com o WinRM ativado; em outras versões do Windows, ative-o com:
winrm quickconfig
- HTTP, porta 5985: o WatchZit entra com NTLMv2 e criptografa cada mensagem com a chave da sessão, como o Windows exige. Nada trafega em texto puro, mesmo sem certificado.
- HTTPS, porta 5986: precisa de um listener HTTPS do WinRM no servidor. O TLS protege as mensagens e a autenticação fica vinculada ao certificado (channel binding). Se o listener usar um certificado autoassinado, marque Aceitar certificados não confiáveis (autoassinados).
- Usuário: escrito como
name,DOMAIN\nameouname@domain. Precisa ser administrador ou membro de Remote Management Users com direitos WMI emroot\cimv2. A segunda opção é a preferível para uma conta de monitoramento. A senha é guardada criptografada.
Adicionar a verificação no console
- Adicione a máquina em Dispositivos com um nome e o endereço, se ela ainda não estiver lá.
- Abra a página do dispositivo e clique em Adicionar uma verificação.
- Em Tipo, escolha Linux por SSH (sem agente) ou Windows por WinRM (sem agente).
- Preencha Nome de utilizador e Senha. No Linux você pode colar uma Chave privada no lugar da senha e, opcionalmente, a Chave de anfitrião. No Windows, marque HTTPS (porta 5986) se usar o listener HTTPS. Porta é opcional nos dois casos: vazio significa 22, ou 5985 / 5986.
- Defina Intervalo (segundos) e Tempo limite (ms). Uma execução leva alguns segundos, então dê a ela um tempo limite de pelo menos 15 segundos (
15000); um intervalo de um minuto ou mais é suficiente. - Clique em Adicionar verificação. Depois da primeira execução, a página do dispositivo mostra os valores, e os gráficos passam a se preencher.
Ao editar a verificação depois, deixe o campo da senha vazio para manter a senha guardada.
Coletores remotos: uma verificação que roda por um coletor remoto em uma filial não consegue guardar sozinha a chave do host. Informe a chave na verificação; até lá, a verificação mostra a chave que o coletor viu, para que você possa compará-la e copiá-la.
Gatilhos e previsões
Como os valores têm os nomes do agente, os gatilhos integrados em Problemas → Gatilhos acompanham essas verificações assim que elas rodam:
- Carga de CPU alta e Memória quase cheia — acima de 90 % por 5 minutos,
- Disco quase cheio e Disco cheio — acima de 90 % e 97 %.
Para ser avisado antes de um disco encher, adicione um gatilho do tipo O valor vai atingir um limite (previsão): escolha o valor do disco, um Limite e No prazo de (dias). O WatchZit traça uma reta pela última semana do valor e abre um problema quando essa reta atinge o limite dentro dos dias definidos. O problema informa o valor atual, quanto ele muda por dia e a data em que chegará ao limite.
Os problemas vão para os canais de notificação que você configurou — e-mail, Slack, Microsoft Teams, Discord, Telegram, ntfy, PagerDuty, SMS ou webhooks — e dependências e janelas de manutenção valem para esses dispositivos como para qualquer outro.
Quando o agente é a melhor escolha
As verificações sem agente cobrem o básico. O agente do WatchZit vê muito mais, então instale-o onde for permitido:
| Sem agente (SSH / WinRM) | Agente do WatchZit | |
|---|---|---|
| CPU, memória, swap / arquivo de paginação, uptime | Sim (Linux também load) | Sim |
| Discos | O disco mais cheio | Cada unidade |
| Interfaces, serviços, processos vigiados | — | Sim |
| Máquinas Hyper-V, contêineres Docker | — | Sim |
| Logs de eventos do Windows, journal do systemd | — | Os erros vão para Registos |
| Conexão | O WatchZit se conecta à máquina (SSH ou WinRM) | Uma conexão de saída do agente para a porta 8444 |
| Na máquina | Nada instalado; um usuário com direito de login | MSI para Windows, deb e rpm para Linux; atualiza-se sozinho pelo console |
Uma boa regra: o agente nos seus próprios servidores, as verificações sem agente nas máquinas que você não pode ou não deve alterar.
Também novo no 1.4: caminho de rede e gatilhos aprendidos
Caminho de rede (traceroute) é uma verificação que traça o caminho até um dispositivo a cada cinco minutos, como o MTR: para cada roteador no caminho, o endereço, a perda e o tempo melhor, médio e pior (3 sondas por salto por padrão, até 30 saltos). Cada execução é guardada por 30 dias; a página do dispositivo mostra o último caminho, cada salto nas últimas 24 horas e as dez últimas mudanças de rota. O gatilho Loss on the network path (acima de 20 % por 10 minutos) vem junto. Coloque-a na linha para uma filial ou um provedor para ver onde começam a perda ou o atraso; a partir de um coletor remoto, ela traça o caminho daquele local.
Valor invulgar para a hora (aprendido) é um gatilho que não precisa de limite. Ele aprende com as últimas quatro semanas o que é normal para um valor em cada hora da semana e abre um problema quando o valor se afasta muito disso — mais alto, mais baixo ou ambos. A Sensibilidade é Alta (mais problemas), Médio ou Baixa (só grandes mudanças). Ele começa a comparar após uma semana de histórico. Também funciona com os valores das verificações sem agente, por exemplo uma carga de CPU normal na segunda de manhã, mas não no domingo à noite.
Limitações
- Só um disco é informado: o mais cheio. Interfaces, serviços, processos e logs precisam do agente.
- Chaves SSH com frase-senha não são suportadas; use uma chave sem ela ou uma senha.
- A verificação de Linux lê
/proc, então é feita para Linux, não para outros sistemas Unix. - WinRM por HTTPS precisa de um listener que você configura no servidor Windows; o usuário do WinRM precisa ser administrador ou estar em Remote Management Users com direitos WMI.
- Uma execução leva alguns segundos; intervalos muito curtos não ajudam. Por um coletor remoto, a chave do host precisa ser informada à mão.
Próximos passos
- Desenhe os servidores em um mapa de rede ao lado de roteadores e switches — veja o guia Uma alternativa moderna ao MikroTik The Dude.
- Instale o agente nos servidores em que puder e mantenha as verificações sem agente para o resto.
- Adicione um gatilho de previsão para os discos mais importantes.
Tudo o que o WatchZit faz está na página de funcionalidades; ele pode ser baixado na página de download, e a referência completa é a documentação. As perguntas são bem-vindas nas GitHub Discussions. Empresas podem contratar suporte comercial da MaxZit (somente em inglês).