Cosa copre questa guida
WatchZit è un sistema di monitoraggio gratuito e open source (AGPLv3) per reti e server. Oltre ai controlli ping, SNMP, web e database ha un piccolo agente per Windows e Linux. Dalla versione 1.4 esistono due tipi di controllo che non richiedono nulla di installato sulla macchina: Linux tramite SSH (senza agente) e Windows tramite WinRM (senza agente).
Cosa viene misurato
Entrambi i controlli leggono gli stessi valori da una macchina su cui non è installato nulla:
- il carico della CPU (misurato su un secondo a ogni esecuzione),
- la memoria in uso,
- lo swap su Linux o il file di paging su Windows,
- il disco più pieno,
- l’uptime,
- e su Linux anche il load.
I valori hanno gli stessi nomi di quelli dell’agente. Per questo i trigger integrati per CPU, memoria e dischi, e le previsioni, funzionano su questi controlli senza alcuna configurazione aggiuntiva.
Preparare un server Linux (SSH)
WatchZit accede tramite SSH ed esegue un unico comando fisso che legge solo /proc, df e uname. Sul server non viene scritto nulla.
- Utente: basta un qualsiasi utente che possa accedere via SSH — niente root, niente sudo. Un utente dedicato, ad esempio
monitor, lo tiene separato dagli account delle persone. - Password o chiave privata: l’una o l’altra. La chiave può essere in formato OpenSSH o PEM e non deve avere una passphrase. WatchZit conserva password o chiave cifrate e non le mostra mai più.
- Porta: 22, a meno che non ne indichiate un’altra. Il server WatchZit (o il collettore remoto che esegue il controllo) deve poterla raggiungere.
Chiave host: fiducia al primo utilizzo
Alla prima connessione il controllo accetta la chiave host del server e la salva. A ogni esecuzione successiva la chiave viene verificata. Quando cambia, il controllo va giù e indica la nuova chiave — così un server sostituito o una connessione intercettata non passano inosservati. Se il cambiamento era previsto, per esempio perché la macchina è stata reinstallata, aprite il controllo, spuntate Dimentica la chiave host salvata e accetta la prossima e salvate.
Se non volete affidarvi alla prima connessione, inserite voi l’impronta nel campo Chiave host. Sul server la mostra questo comando:
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
Il campo accetta un’impronta SHA256 come SHA256:…; vuoto significa che viene accettata la prima chiave.
Preparare un server Windows (WinRM)
Su Windows, WatchZit legge WMI tramite WinRM. Windows Server ha WinRM attivo; sulle altre versioni di Windows attivatelo con:
winrm quickconfig
- HTTP, porta 5985: WatchZit accede con NTLMv2 e cifra ogni messaggio con la chiave di accesso, come richiede Windows. Nulla viaggia in chiaro, anche senza certificato.
- HTTPS, porta 5986: richiede un listener HTTPS di WinRM sul server. TLS protegge i messaggi e l’accesso è legato al certificato (channel binding). Se il listener usa un certificato autofirmato, spuntate Accetta certificati non attendibili (autofirmati).
- Utente: scritto come
name,DOMAIN\nameoname@domain. Deve essere un amministratore oppure membro di Remote Management Users con diritti WMI suroot\cimv2. La seconda via è preferibile per un account di monitoraggio. La password è conservata cifrata.
Aggiungere il controllo nella console
- Aggiungete la macchina in Dispositivi con un nome e il suo indirizzo, se non c’è ancora.
- Aprite la pagina del dispositivo e fate clic su Aggiungi un controllo.
- In Tipo scegliete Linux tramite SSH (senza agente) o Windows tramite WinRM (senza agente).
- Compilate Nome utente e Password. Per Linux potete incollare una Chiave privata al posto della password e, facoltativamente, la Chiave host. Per Windows spuntate HTTPS (porta 5986) se usate il listener HTTPS. Porta è facoltativa in entrambi i casi: vuota significa 22, oppure 5985 / 5986.
- Impostate Intervallo (secondi) e Timeout (ms). Un’esecuzione dura qualche secondo, quindi date un timeout di almeno 15 secondi (
15000); un intervallo di un minuto o più è sufficiente. - Fate clic su Aggiungi controllo. Dopo la prima esecuzione la pagina del dispositivo mostra i valori e da lì i grafici si riempiono.
Quando modificate il controllo in seguito, lasciate vuoto il campo della password per mantenere quella salvata.
Collettori remoti: un controllo eseguito tramite un collettore remoto in una filiale non può salvare da solo la chiave host. Inserite la chiave nel controllo; fino ad allora il controllo mostra la chiave vista dal collettore, così potete confrontarla e copiarla.
Trigger e previsioni
Poiché i valori hanno i nomi dell’agente, i trigger integrati in Problemi → Trigger controllano questi controlli non appena girano:
- Carico CPU elevato e Memoria quasi piena — sopra il 90 % per 5 minuti,
- Disco quasi pieno e Disco pieno — sopra il 90 % e il 97 %.
Per essere avvisati prima che un disco si riempia, aggiungete un trigger del genere Il valore raggiungerà una soglia (previsione): scegliete il valore del disco, una Soglia ed Entro (giorni). WatchZit traccia una retta attraverso l’ultima settimana del valore e apre un problema quando la retta raggiunge la soglia entro i giorni impostati. Il problema indica il valore attuale, quanto cambia al giorno e la data in cui arriverà alla soglia.
I problemi vanno ai canali di notifica configurati — email, Slack, Microsoft Teams, Discord, Telegram, ntfy, PagerDuty, SMS o webhook — e dipendenze e finestre di manutenzione valgono per questi dispositivi come per tutti gli altri.
Quando l’agente è la scelta migliore
I controlli senza agente coprono l’essenziale. L’agente di WatchZit vede molto di più, quindi installatelo ovunque vi sia permesso:
| Senza agente (SSH / WinRM) | Agente WatchZit | |
|---|---|---|
| CPU, memoria, swap / file di paging, uptime | Sì (Linux anche load) | Sì |
| Dischi | Il disco più pieno | Ogni unità |
| Interfacce, servizi, processi controllati | — | Sì |
| Macchine Hyper-V, container Docker | — | Sì |
| Registri eventi di Windows, journal di systemd | — | Gli errori vanno in Log |
| Connessione | WatchZit si collega alla macchina (SSH o WinRM) | Una connessione in uscita dall’agente alla porta 8444 |
| Sulla macchina | Nulla di installato; un utente con diritto di accesso | MSI per Windows, deb e rpm per Linux; si aggiorna da solo dalla console |
Una buona regola: l’agente sui vostri server, i controlli senza agente sulle macchine che non potete o non dovete modificare.
Anche nuovo nella 1.4: percorso di rete e trigger appresi
Percorso di rete (traceroute) è un controllo che traccia il percorso verso un dispositivo ogni cinque minuti, come MTR: per ogni router lungo il percorso il suo indirizzo, la perdita e il tempo migliore, medio e peggiore (3 sonde per hop di default, fino a 30 hop). Ogni esecuzione è conservata 30 giorni; la pagina del dispositivo mostra l’ultimo percorso, ogni hop nelle ultime 24 ore e gli ultimi dieci cambi di percorso. Con esso arriva il trigger Loss on the network path (oltre il 20 % per 10 minuti). Mettetelo sulla linea verso una filiale o un provider per vedere dove iniziano perdita o ritardo; da un collettore remoto traccia il percorso da quella sede.
Valore insolito per l'orario (appreso) è un trigger che non richiede una soglia. Impara dalle ultime quattro settimane cosa è normale per un valore a ogni ora della settimana e apre un problema quando il valore se ne discosta molto — più alto, più basso o entrambi. La Sensibilità è Alta (più problemi), Medio o Bassa (solo grandi cambiamenti). Inizia a confrontare dopo una settimana di storico. Funziona anche sui valori dei controlli senza agente, per esempio un carico CPU normale il lunedì mattina ma non la domenica notte.
Limiti
- Viene riportato un solo disco: il più pieno. Interfacce, servizi, processi e log richiedono l’agente.
- Le chiavi SSH con passphrase non sono supportate; usate una chiave senza passphrase o una password.
- Il controllo Linux legge
/proc, quindi è pensato per Linux, non per altri sistemi Unix. - WinRM via HTTPS richiede un listener da configurare sul server Windows; l’utente WinRM deve essere amministratore o in Remote Management Users con diritti WMI.
- Un’esecuzione dura qualche secondo; intervalli molto brevi non sono utili. Tramite un collettore remoto la chiave host va inserita a mano.
Passi successivi
- Disegnate i server su una mappa di rete accanto a router e switch — vedete la guida Un’alternativa moderna a MikroTik The Dude.
- Installate l’agente sui server dove potete e tenete i controlli senza agente per il resto.
- Aggiungete un trigger di previsione per i dischi più importanti.
Tutto ciò che fa WatchZit è nella pagina delle funzionalità; si scarica dalla pagina di download, e il riferimento completo è la documentazione. Le domande sono benvenute nelle GitHub Discussions. Le aziende possono ottenere supporto commerciale da MaxZit (solo in inglese).