O que este guia cobre
Um console do WatchZit verifica os dispositivos que consegue alcançar. Os de uma filial muitas vezes ficam fora de alcance: estão atrás do NAT do roteador da filial, a VPN não os cobre ou a rede de gerenciamento é fechada de propósito. O coletor remoto resolve isso. É o agente comum do WatchZit em um computador do local, marcado como coletor no console. Ele recebe as verificações dos dispositivos do seu local, executa-as ali, descobre a rede do local e envia os resultados de volta pela sua própria conexão criptografada. Quando o link com o console cai, ele continua medindo, e um segundo coletor pode assumir se o primeiro falhar.
- O que você precisa
- Preparar o servidor para agentes externos
- Instalar o agente no local
- Transformá-lo em coletor remoto
- Atribuir os dispositivos do local
- Descobrir a rede da filial
- Um mapa por local
- Alertas quando o link da filial ou o coletor cai
- Um segundo coletor para failover
- O que ter em mente
- Próximos passos
O que você precisa
- Um console do WatchZit em funcionamento (o appliance ou o script de instalação; veja a página de download).
- Em cada local, um computador sempre ligado: Linux ou Windows. Uma VM pequena ou uma máquina da classe Raspberry Pi basta; o agente Linux existe para amd64 e arm64.
- A partir desse computador, uma conexão de saída para a porta de agentes 8444 do servidor. Nada precisa ser aberto no local: o coletor se conecta para fora, e o console nunca se conecta a ele.
- Direitos de administrador no console: só administradores criam coletores e escolhem de onde os dispositivos são monitorados.
Preparar o servidor para agentes externos
O console tem duas portas: 8443 para a interface web e a API, e 8444 para os agentes. Deixe a 8443 para suas redes de administração e torne acessível a partir das filiais apenas a 8444, por exemplo com um redirecionamento de porta no firewall da matriz.
Se as filiais alcançam o servidor por outro nome que não o do console, informe-o em Configurações → Rede e acesso como Endereço público para agentes, por exemplo https://monitor.example.com:8444. Ele vai em todo código de registro, então defina-o antes de criar os códigos. Na mesma página você pode limitar as redes de onde os agentes podem vir.
Instalar o agente no local
- Em Agentes, crie um código de registro: um nome, por quantos dias vale, quantos computadores podem usá-lo e o grupo dos novos dispositivos. O código é mostrado uma única vez. Ele contém o endereço do servidor e a impressão digital do certificado dos agentes, de modo que o agente só confia no seu servidor.
- Em um computador Windows, baixe o MSI na página Agentes e instale-o; ele pede o código. Em modo silencioso:
msiexec /i watchzit-agent-x64.msi ENROLLCODE="WZ1-…" /qn. O serviço se chamaWatchZitAgent. - No Linux, copie o comando que a página Agentes mostra: ele baixa o agente pela porta de agentes, confere o SHA-256 e o instala com o código como serviço systemd
watchzit-agent. Ou instale o pacote deb ou rpm da versão e executesudo watchzit-agent enroll --code "WZ1-…".
O computador aparece como dispositivo com CPU, memória, discos e interfaces. Se não se conectar, verifique se ele alcança a porta 8444 e as redes permitidas em Configurações → Rede e acesso; o log do agente fica em C:\ProgramData\WatchZit Agent no Windows e em journalctl -u watchzit-agent no Linux.
Transformá-lo em coletor remoto
Abra a página do dispositivo do novo agente e clique em Usar como coletor remoto no quadro Agente. É só isso do lado do coletor: ele não tem interface web própria e nada é configurado localmente — tudo é ajustado no console.
A página Agentes agora o lista em Coletores remotos, com seu status e quantos dispositivos monitora. Um coletor é atualizado como qualquer outro agente: um agente mais antigo que o servidor recebe a versão do servidor ao se conectar.
Atribuir os dispositivos do local
Cada dispositivo tem na sua página a opção Monitorado a partir de: Esta console ou um dos seus coletores remotos. Para um dispositivo, escolha ali o coletor e clique em Salvar.
Para muitos dispositivos de uma vez, filtre a lista de dispositivos (por exemplo pelo grupo da filial), marque-os e use Alterar selecionados: → Monitorado a partir de.
O coletor passa a receber as verificações deles — ping, TCP, SNMP, páginas web e cenários, certificados, DNS, bancos de dados, MikroTik RouterOS, APIs JSON — com as senhas e configurações SNMP de que precisam, executa-as nos seus intervalos e envia os resultados ao console. Gráficos, gatilhos e mapas funcionam exatamente como para os dispositivos que o próprio console verifica.
Descobrir a rede da filial
Você não precisa adicionar os dispositivos da filial à mão. Em Dispositivos → Descoberta, adicione uma faixa da filial (por exemplo 192.168.20.0/24; até um /22) e escolha o coletor ao lado. O coletor varre a rede do seu próprio local: faz ping em cada endereço, testa portas comuns, consulta o SNMP com seus perfis SNMP e procura os nomes DNS. Execute a varredura agora, todo dia ou toda semana; com um agendamento, novos hosts da filial aparecem sozinhos.
Marque os hosts desejados e clique em Adicionar como dispositivos. Dispositivos adicionados a partir de uma faixa varrida por um coletor passam a ser monitorados automaticamente por esse coletor. A descoberta SNMP na página do dispositivo e a leitura de dados, interfaces e VLANs também passam pelo coletor.
Um mapa por local
Um mapa por filial mantém a visão clara. Em Mapas, adicione um mapa, clique em Editar e coloque os dispositivos da filial com Adicionar dispositivo. Ligações sugeridas oferece os cabos que o WatchZit encontrou nos dispositivos, com as portas nas duas pontas; Adicionar tudo os aceita, Organizar dispõe o mapa pelos cabos e Salvar o guarda. Uma planta baixa pode ficar atrás como imagem de fundo.
Depois crie um mapa geral com um submapa para cada filial: um submapa leva ao mapa da filial e mostra o seu pior estado, então uma filial em vermelho chama a atenção na hora. Para uma tela de parede, Configurações → Ecrãs quiosque mostra mapas em tela cheia por trás de um link secreto.
Para acompanhar o próprio link, adicione a verificação Caminho de rede (traceroute) a um dispositivo monitorado pelo coletor: o coletor traça o caminho a partir do seu próprio local, então você vê cada roteador no trajeto desde a filial com perda e latência, e quando a rota mudou.
Alertas quando o link da filial ou o coletor cai
Quando a conexão entre a filial e o console cai, o coletor continua executando as verificações. Os resultados — até um dia, os 200.000 mais recentes — aguardam no coletor e chegam quando a conexão volta, então os gráficos não ficam com lacunas.
Enquanto isso, o console não finge saber mais do que sabe: as verificações dos dispositivos do coletor mostram Desconhecido em vez de fora do ar, porque o local pode estar bem. A verificação de agente do próprio coletor abre um problema, e essa é a mensagem que você recebe: um alerta para a filial, não um por dispositivo. Para onde os problemas vão é definido em Configurações → Notificações — e-mail, webhook, Slack, Microsoft Teams, Telegram, ntfy, PagerDuty, SMS e outros.
Dentro da filial, as dependências reduzem o ruído. Abra o mapa da filial e clique em Dependências: seguindo os cabos a partir do roteador, cada dispositivo recebe a sugestão do anterior. Clique em Definir as dependências marcadas. Quando o roteador ou um switch da filial falha, os dispositivos atrás dele ficam apenas inalcançáveis, e seus problemas são registrados, mas não enviados. Um gatilho Sem dados novos detecta verificações que param de entregar valores.
Um segundo coletor para failover
Para um local importante, instale o agente em um segundo computador ali e transforme-o também em coletor. Depois escolha-o como Reserva ao lado de Monitorado a partir de na página do dispositivo, ou para muitos dispositivos na lista em Alterar selecionados: → Coletor de reserva.
Enquanto o primeiro coletor está offline, o de reserva executa as verificações dos seus dispositivos. Quando o primeiro volta, ele as retoma. Para devolver os dispositivos totalmente ao console, clique em Parar a coleta na página do dispositivo do coletor.
O que ter em mente
- Os resultados guardados durante uma queda não sobrevivem a uma reinicialização do coletor: depois de reiniciar ele recebe de novo as verificações do console, e o que ainda não tinha enviado se perde.
- O buffer guarda até um dia, no máximo os 200.000 resultados mais recentes. Uma queda mais longa deixa uma lacuna.
- As verificações de hipervisores ficam com o console; um coletor não as executa.
- Verificações Linux sem agente por SSH através de um coletor precisam da chave do host informada na verificação: o coletor não pode salvá-la, então mostra a chave que viu.
- Enquanto o link está fora, o console mostra os dispositivos do coletor como desconhecidos; o estado real só aparece quando os resultados chegam.
- Remover o agente na página do dispositivo torna sua chave desconhecida; para usar esse computador de novo, registre-o com um novo código.
Próximos passos
- Leia os capítulos sobre agentes e coletores na documentação e veja tudo o que o WatchZit faz na página de funcionalidades.
- Se as filiais usam MikroTik, siga o guia Uma alternativa moderna ao MikroTik The Dude para SNMP, a API do RouterOS e o desenho dos mapas.
- O appliance e o script de instalação estão na página de download.
Perguntas e ideias são bem-vindas nas GitHub Discussions. Empresas podem contratar suporte comercial da MaxZit (somente em inglês).