Di cosa tratta questa guida
WatchZit è un sistema di monitoraggio gratuito e open source (AGPLv3) per reti e server. Il suo centro è la mappa di rete: dispositivi con immagini reali e porte, cavi che mostrano il loro traffico, tutto colorato in base allo stato. Dietro la mappa ci sono i controlli, i grafici e gli avvisi che conoscete da strumenti come Zabbix. Funziona su un piccolo server Linux o come macchina virtuale pronta all’uso, senza prezzo per dispositivo e senza cloud.
Cosa serve
- Una macchina virtuale su VMware, Proxmox VE o Hyper-V con 2 CPU, 2 GB di memoria e un disco da 16 GB — oppure un qualsiasi server a 64 bit con Debian 12+, Ubuntu 22.04+, AlmaLinux o Rocky Linux 9+. Basta per qualche centinaio di dispositivi.
- SNMP sui dispositivi che volete vedere nel dettaglio (MikroTik, Cisco, HP, Ubiquiti, stampanti, UPS …): una community v2c o un utente v3 in sola lettura.
- Per i router MikroTik con RouterOS 7, facoltativamente, il servizio www o www-ssl e un utente in un gruppo di sola lettura, per il controllo tramite l’API di RouterOS.
Installare il server
La via più rapida è l’appliance: un’immagine pronta all’uso con Debian, WatchZit, PostgreSQL e aggiornamenti di sicurezza automatici. Scaricatela dalla pagina di download — OVA per VMware ESXi e Workstation, qcow2 per Proxmox VE e KVM, VHDX per Hyper-V (generazione 1) o una ISO per una nuova VM o un server fisico. Importatela, avviatela e seguite il menu sul suo schermo. Mostra l’indirizzo della console e il token di configurazione.
Su un vostro server Linux basta un solo comando da root:
curl -fsSL https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh | sudo sh
Lo script installa PostgreSQL, verifica la firma della versione, crea il database con una password casuale, apre le porte e avvia il servizio. Alla fine mostra l’indirizzo della console e il token di configurazione. Eseguendolo di nuovo più avanti, aggiorna WatchZit.
Primo accesso
- Aprite
https://<server>:8443. Il browser avvisa una volta del certificato autofirmato; accettatelo. - Inserite il token di configurazione e create il primo amministratore.
- Scansionate il codice QR con un’app di autenticazione — l’accesso a due fattori è obbligatorio — e conservate i codici di recupero.
Per impostazione predefinita la console risponde solo alle reti private. Lasciatela così; gli agenti, se li userete in seguito, hanno bisogno solo della porta 8444.
Trovare i dispositivi di una rete
Come il rilevamento di The Dude, Dispositivi → Rilevamento scansiona un intervallo come 192.168.88.0/24 (fino a un /22, subito, ogni giorno o ogni settimana). WatchZit esegue il ping di ogni indirizzo, prova le porte più comuni (SSH, Telnet, web, RDP, WinBox, SMB, stampanti, VNC), interroga SNMP con i vostri profili SNMP per nome, descrizione e produttore, e cerca il nome DNS. Spuntate gli host che vi servono e aggiungeteli; ogni nuovo dispositivo riceve un controllo ping.
Un singolo dispositivo si aggiunge in Dispositivi con solo un nome e un indirizzo.
Leggere i dispositivi MikroTik: SNMP e l’API di RouterOS
- Sul router attivate SNMP (
/snmp set enabled=yes) e impostate una community in sola lettura — oppure un utente v3 con SHA-2 e AES, che WatchZit supporta. - In WatchZit create il profilo in Impostazioni → SNMP e sceglietelo sul dispositivo. Si apre il rilevamento SNMP: spuntate le interfacce, la CPU, la memoria e i dischi da controllare. Le interfacce di loopback e quelle senza link vengono escluse.
- La pagina del dispositivo ora mostra le porte con lo stato del link e il traffico in tempo reale, e i grafici di ogni valore da un’ora fino a un anno.
Per RouterOS 7 aggiungete anche il controllo MikroTik RouterOS (API): legge CPU, memoria, uptime e temperatura tramite l’API REST, e con esso WatchZit legge le VLAN del bridge, i tunnel VXLAN e lo stato VRRP del router. Il rilevamento dei vicini di MikroTik, LLDP e CDP dicono a WatchZit quale porta è collegata a quale — la base della mappa.
In Backup della configurazione WatchZit può anche salvare ogni notte l’export di RouterOS via SSH e mostrare cosa è cambiato tra due versioni.
Disegnare la mappa
In Mappe aggiungete una mappa e fate clic su Modifica.
- Aggiungi dispositivo mette i dispositivi sulla mappa. Ogni dispositivo riceve un’immagine — dalla libreria integrata di circa 3.500 modelli reali, compresi router e switch MikroTik con le loro porte, oppure una che caricate voi.
- Collegamenti suggeriti elenca i cavi che WatchZit ha trovato nelle tabelle dei vicini, nelle tabelle degli indirizzi MAC degli switch e nelle descrizioni delle porte, con le porte a entrambe le estremità. Aggiungi tutto li acquisisce. Con Disegna da sola la mappa continua ad aggiungere ogni 15 minuti i nuovi collegamenti e i dispositivi a cui portano.
- Disponi organizza la mappa in base ai cavi: il router in alto, gli switch sotto e ciò che è collegato a loro più in basso.
- Fate clic su Salva.
Verde significa attivo, ambra parzialmente non raggiungibile e rosso non raggiungibile. I cavi si allargano e cambiano colore con il traffico, e una porta senza link è disegnata in rosso e tratteggiata. Fate clic su un dispositivo per i suoi controlli e le sue porte, su un cavo per lo storico del suo traffico. Rack, filtri VLAN, il percorso tra due dispositivi, sottomappe e riquadri degli hypervisor con le loro macchine virtuali sono pronti quando la rete cresce. Per uno schermo di monitoraggio, Impostazioni → Schermi kiosk mostra le mappe a schermo intero dietro un link segreto.
Avvisi
I trigger integrati controllano già dispositivi non raggiungibili, perdita di pacchetti, carico della CPU elevato, dischi pieni e certificati in scadenza. Stabilite dove inviare i problemi in Impostazioni → Notifiche: email, webhook, Slack o Microsoft Teams. Le dipendenze riducono il rumore — quando il router di una filiale non risponde, ricevete un solo problema, non uno per ogni dispositivo che sta dietro — e finestre di manutenzione e conferme fanno il resto.
Aprire WinBox, SSH e pagine web dalla mappa
Il pannello di un dispositivo apre con un clic la sua pagina web, SSH, Desktop remoto, WinBox o i vostri strumenti. I programmi sul vostro computer vengono avviati dal piccolo MaxZit Launcher, che installate una volta dalla console; apre WinBox con l’indirizzo del router.
The Dude e WatchZit a confronto
| The Dude | WatchZit | |
|---|---|---|
| Server | Un pacchetto RouterOS (le versioni più vecchie anche su Windows) | Server Linux o immagine VM pronta all’uso |
| Client | Un programma per Windows | Qualsiasi browser, in 14 lingue |
| Mappe | Dispositivi, collegamenti e sottomappe | Immagini reali dei dispositivi con porte, rack, VLAN, VXLAN, gruppi HA, hypervisor, collegamenti trovati da soli |
| Oltre la mappa | Sonde e i loro grafici | Controlli SNMP, tramite agente, web, database e API, due anni di storico, dashboard, report, ruoli con due fattori e single sign-on, un registro di audit |
| Prezzo | Gratuito | Gratuito e open source (AGPLv3), supporto a pagamento se lo desiderate |
The Dude resta un buon strumento per una rete solo MikroTik. WatchZit è pensato per reti con dispositivi di più produttori, per server e servizi accanto ai router e per i team che vogliono lavorare nel browser.
I passi successivi
- Installate l’agente sui server Windows e Linux per CPU, memoria, dischi, servizi e registri eventi (documentazione).
- Mettete un collettore remoto in ogni filiale: esegue i controlli della sua sede e continua a misurare quando la linea verso la console è interrotta.
- Create una dashboard per lo schermo a parete e un report mensile di disponibilità.
Domande e idee sono benvenute nelle GitHub Discussions (solo in inglese).
MikroTik, RouterOS, WinBox e The Dude sono marchi del rispettivo titolare. MaxZit non è affiliata al titolare di questi nomi né sponsorizzata o approvata da esso; i nomi sono usati solo per descrivere l’argomento di questa guida.