WatchZit

Monitorare le filiali con un collettore remoto

Come tenere sotto controllo la rete di una filiale, di un cliente dietro NAT o di una VLAN di gestione chiusa da un’unica console WatchZit, senza aprire nemmeno una porta nel sito. Una guida passo passo, dal primo collettore alle mappe, agli avvisi e a un collettore di riserva.

Di cosa tratta questa guida

Una console WatchZit controlla i dispositivi che riesce a raggiungere. Quelli di una filiale spesso non lo sono: stanno dietro il NAT del router della filiale, la VPN non li copre o la rete di gestione è chiusa di proposito. Il collettore remoto risolve il problema. È il normale agente WatchZit su un computer del sito, contrassegnato come collettore nella console. Riceve i controlli dei dispositivi del suo sito, li esegue sul posto, rileva la rete del sito e rimanda i risultati tramite la propria connessione cifrata. Quando il collegamento con la console cade continua a misurare, e un secondo collettore può subentrare se il primo si guasta.

Cosa serve

  • Una console WatchZit in funzione (l’appliance o lo script di installazione; vedete la pagina di download).
  • In ogni sito, un computer sempre acceso: Linux o Windows. Basta una piccola VM o una macchina della classe Raspberry Pi; l’agente Linux esiste per amd64 e arm64.
  • Da quel computer, una connessione in uscita verso la porta degli agenti 8444 del server. Nel sito non va aperto nulla: il collettore si connette verso l’esterno e la console non si connette mai a lui.
  • Diritti di amministratore nella console: solo gli amministratori creano collettori e scelgono da dove vengono monitorati i dispositivi.

Preparare il server per agenti esterni

La console ha due porte: 8443 per l’interfaccia web e l’API, 8444 per gli agenti. Lasciate la 8443 alle vostre reti di amministrazione e rendete raggiungibile dalle filiali solo la 8444, per esempio con un port forwarding sul firewall della sede.

Se le filiali raggiungono il server con un nome diverso da quello della console, inseritelo in Impostazioni → Rete e accesso come Indirizzo pubblico per gli agenti, per esempio https://monitor.example.com:8444. Entra in ogni codice di registrazione, quindi impostatelo prima di creare i codici. Nella stessa pagina potete limitare le reti da cui possono arrivare gli agenti.

Installare l’agente nel sito

  1. In Agenti create un codice di registrazione: un nome, per quanti giorni vale, quanti computer possono usarlo e il gruppo dei nuovi dispositivi. Il codice viene mostrato una sola volta. Contiene l’indirizzo del server e l’impronta del certificato degli agenti, così l’agente si fida solo del vostro server.
  2. Su un computer Windows scaricate l’MSI dalla pagina Agenti e installatelo; chiede il codice. In modo silenzioso: msiexec /i watchzit-agent-x64.msi ENROLLCODE="WZ1-…" /qn. Il servizio si chiama WatchZitAgent.
  3. Su Linux copiate il comando mostrato dalla pagina Agenti: scarica l’agente dalla porta degli agenti, ne verifica lo SHA-256 e lo installa con il codice come servizio systemd watchzit-agent. Oppure installate il pacchetto deb o rpm della release ed eseguite sudo watchzit-agent enroll --code "WZ1-…".

Il computer compare come dispositivo con CPU, memoria, dischi e interfacce. Se non si connette, verificate che raggiunga la porta 8444 e le reti consentite in Impostazioni → Rete e accesso; il log dell’agente è in C:\ProgramData\WatchZit Agent su Windows e in journalctl -u watchzit-agent su Linux.

Farne un collettore remoto

Aprite la pagina del dispositivo del nuovo agente e fate clic su Usa come collettore remoto nel riquadro Agente. Dal lato del collettore non serve altro: non ha un’interfaccia web propria e non si configura nulla in locale — tutto si imposta nella console.

La pagina Agenti ora lo elenca in Collettori remoti, con il suo stato e il numero di dispositivi che monitora. Un collettore si aggiorna come qualsiasi altro agente: un agente più vecchio del server riceve la versione del server quando si connette.

Assegnare i dispositivi del sito

Ogni dispositivo ha nella sua pagina l’impostazione Monitorato da: Questa console o uno dei vostri collettori remoti. Per un dispositivo scegliete lì il collettore e fate clic su Salva.

Per molti dispositivi insieme filtrate l’elenco dei dispositivi (per esempio per il gruppo della filiale), spuntateli e usate Modifica selezionati: → Monitorato da.

Il collettore riceve allora i loro controlli — ping, TCP, SNMP, pagine web e scenari, certificati, DNS, database, MikroTik RouterOS, API JSON — con le password e le impostazioni SNMP necessarie, li esegue ai loro intervalli e invia i risultati alla console. Grafici, trigger e mappe funzionano esattamente come per i dispositivi controllati dalla console stessa.

Rilevare la rete della filiale

Non serve aggiungere a mano i dispositivi della filiale. In Dispositivi → Rilevamento aggiungete un intervallo della filiale (per esempio 192.168.20.0/24; fino a un /22) e scegliete accanto il collettore. Il collettore scansiona la rete del proprio sito: fa il ping di ogni indirizzo, prova le porte comuni, interroga SNMP con i vostri profili SNMP e cerca i nomi DNS. Avviate la scansione subito, ogni giorno o ogni settimana; con una pianificazione, i nuovi host della filiale compaiono da soli.

Spuntate gli host che volete e fate clic su Aggiungi come dispositivi. I dispositivi aggiunti da un intervallo scansionato da un collettore vengono monitorati automaticamente da quel collettore. Anche il rilevamento SNMP nella pagina del dispositivo e la lettura di dati, interfacce e VLAN passano dal collettore.

Una mappa per sito

Una mappa per ogni filiale mantiene chiaro il quadro. In Mappe aggiungete una mappa, fate clic su Modifica e posizionate i dispositivi della filiale con Aggiungi dispositivo. Collegamenti suggeriti propone i cavi che WatchZit ha trovato sui dispositivi, con le porte a entrambe le estremità; Aggiungi tutto li prende, Disponi organizza la mappa secondo i cavi e Salva la conserva. Una planimetria può fare da immagine di sfondo.

Poi create una mappa generale con una sottomappa per ogni filiale: una sottomappa porta alla mappa della filiale e ne mostra lo stato peggiore, così una filiale in rosso si nota subito. Per uno schermo a parete, Impostazioni → Schermi kiosk mostra le mappe a schermo intero dietro un link segreto.

Per tenere d’occhio il collegamento stesso, aggiungete il controllo Percorso di rete (traceroute) a un dispositivo monitorato dal collettore: il collettore traccia il percorso dal proprio sito, quindi vedete ogni router lungo il tragitto dalla filiale con perdita e latenza, e quando il percorso è cambiato.

Avvisi quando cade il collegamento della filiale o il collettore

Quando la connessione tra filiale e console si interrompe, il collettore continua a eseguire i controlli. I risultati — fino a un giorno, i 200.000 più recenti — attendono sul collettore e arrivano quando la connessione torna, così i grafici non hanno buchi.

Nel frattempo la console non finge di sapere più di quanto sa: i controlli dei dispositivi del collettore mostrano Sconosciuto invece di non raggiungibile, perché il sito potrebbe essere a posto. Il controllo dell’agente del collettore stesso apre un problema, ed è questo il messaggio che ricevete: un avviso per la filiale, non uno per dispositivo. Dove vanno i problemi si imposta in Impostazioni → Notifiche — e-mail, webhook, Slack, Microsoft Teams, Telegram, ntfy, PagerDuty, SMS e altro.

All’interno della filiale le dipendenze riducono il rumore. Aprite la mappa della filiale e fate clic su Dipendenze: seguendo i cavi dal router, a ogni dispositivo viene proposto quello che lo precede. Fate clic su Imposta le dipendenze spuntate. Quando il router o uno switch della filiale si guasta, i dispositivi dietro sono solo irraggiungibili e i loro problemi vengono registrati ma non inviati. Un trigger Nessun dato nuovo rileva i controlli che smettono di fornire valori.

Un secondo collettore per il failover

Per un sito importante installate l’agente su un secondo computer del sito e rendete anche lui un collettore. Poi sceglietelo come Riserva accanto a Monitorato da nella pagina del dispositivo, o per molti dispositivi nell’elenco con Modifica selezionati: → Collettore di riserva.

Finché il primo collettore è offline, quello di riserva esegue i controlli dei suoi dispositivi. Quando il primo torna, li riprende. Per restituire del tutto i dispositivi alla console, fate clic su Interrompi la raccolta nella pagina del dispositivo del collettore.

Cosa tenere presente

  • I risultati conservati durante un’interruzione non sopravvivono a un riavvio del collettore: dopo il riavvio riceve di nuovo i controlli dalla console, e ciò che non aveva ancora inviato va perso.
  • Il buffer copre fino a un giorno, al massimo i 200.000 risultati più recenti. Un’interruzione più lunga lascia un buco.
  • I controlli degli hypervisor restano alla console; un collettore non li esegue.
  • I controlli Linux senza agente via SSH attraverso un collettore richiedono la chiave host inserita nel controllo: il collettore non può salvarla e quindi mostra la chiave che ha visto.
  • Mentre il collegamento è interrotto, la console mostra i dispositivi del collettore come sconosciuti; il loro stato reale si vede solo quando arrivano i risultati.
  • Rimuovere l’agente nella pagina del dispositivo rende sconosciuta la sua chiave; per riutilizzare quel computer, registratelo con un nuovo codice.

I passi successivi

Domande e idee sono benvenute nelle GitHub Discussions. Le aziende possono ottenere supporto commerciale da MaxZit (solo in inglese).