Cosa copre questa guida
WatchZit è un sistema di monitoraggio gratuito e open source (AGPLv3) per reti e server, con un’unica console web sul vostro server. Non ci sono chiavi di licenza né prezzi per host o per controllo; MaxZit vende supporto facoltativo. Questa guida non confronta prodotti. Tratta il lavoro di un team che sorveglia server e servizi e dice, per ciascuna parte, cosa fa WatchZit e dove si ferma. Rilevamento, modelli e soglie apprese sono nella guida all’alternativa a Zabbix; distribuzione su Windows e accesso tramite directory nella guida all’alternativa a PRTG.
- Installazione e primo host
- Controlli da scegliere in un elenco
- Server: agente oppure SSH e WinRM
- Applicazioni web, certificati e API
- I vostri trigger
- Notifiche, escalation e reperibilità
- Presa in carico, dipendenze e manutenzione
- Manutenzione e prese in carico dai vostri script
- Dashboard, rapporti e chi può modificare cosa
- Cosa WatchZit non fa
- WatchZit accanto al monitoraggio attuale
- Cosa fare dopo
Installazione e primo host
Importate l’appliance dalla pagina di download (OVA, qcow2, VHDX o ISO; 2 CPU, 2 GB di memoria, disco da 16 GB), oppure eseguite lo script di installazione su un server a 64 bit con Debian 12+, Ubuntu 22.04+, AlmaLinux o Rocky Linux 9+:
curl -fsSL https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh | sudo sh
Aprite https://<server>:8443, inserite il token di configurazione, create il primo amministratore e configurate l’accesso a due fattori. Poi aggiungete un host in Dispositivi → Aggiungi un dispositivo: un nome, un indirizzo IP o un nome host, il tipo e il gruppo, con Ping attivo. Ogni porta TCP che inserite lì diventa un controllo che si connette ogni minuto. Dipende da indica il router o lo switch attraverso cui l’host viene raggiunto.
Questa è tutta la configurazione: nessun file da modificare e niente da ricaricare. Ogni modifica viene scritta nel Registro di controllo, con chi l’ha fatta.
Controlli da scegliere in un elenco
Sulla pagina del dispositivo, Aggiungi un controllo offre questi tipi. Ognuno ha il suo Intervallo (secondi) (da 10 a 3.600; 60 per impostazione predefinita) e il suo Timeout (ms); password e token dei controlli vengono salvati cifrati e non vengono mai più mostrati.
| Controllo | Misura |
|---|---|
| Ping (ICMP), Porta TCP | tempo di risposta e perdita di pacchetti; se una porta accetta connessioni, e con quale rapidità |
| Pagina web (HTTP) | codice di stato, tempo di risposta, un testo che deve trovarsi sulla pagina, giorni alla scadenza del certificato |
| Certificato TLS | giorni alla scadenza e se è attendibile, su qualsiasi porta TLS, con un nome server per SNI |
| DNS | un server DNS deve risolvere un nome con un tipo di record e, facoltativamente, un valore atteso |
| PostgreSQL, MySQL / MariaDB | accesso con un utente di monitoraggio, versione, connessioni, tempo di risposta |
| Scenario web (più passi) | un accesso e le pagine dietro di esso, passo per passo, come farebbe un utente |
| Valore da API JSON | un numero da una qualsiasi API JSON |
| Linux tramite SSH (senza agente), Windows tramite WinRM (senza agente) | CPU, memoria, swap o file di paging, il disco più pieno e l’uptime |
| Percorso di rete (traceroute) | ogni router lungo il percorso con perdita e latenza, come MTR |
| Hypervisor (vSphere, Proxmox VE) | host, macchine virtuali e datastore |
| SNMP | interfacce, CPU, storage e qualsiasi OID numerico |
Per avere gli stessi controlli su molti host, un modello li aggiunge a tutti i dispositivi di un tipo o di un gruppo, anche a quelli aggiunti in seguito; con Modifica selezionati: nell’elenco dei dispositivi impostate il gruppo, la dipendenza o un modello per molti host in una volta.
Server: agente oppure SSH e WinRM
L’agente WatchZit per Windows (MSI) e Linux (deb, rpm; x86-64 e arm64) apre una sola connessione in uscita verso la porta 8444, quindi i server non hanno bisogno di porte aperte. Si registra con un codice monouso da Agenti e si aggiorna da solo dalla console. Ogni minuto riporta CPU, memoria, ogni disco e ogni interfaccia, e inoltre:
- Sorveglia servizi sulla pagina del dispositivo: un servizio che si ferma apre un problema.
- Controlla processi: nomi di programmi come
nginx,sqlservr.exeojava, con quanti ne sono in esecuzione, la loro CPU e memoria; quando non ne gira nessuno si apre un problema. - Gli eventi critici e di errore dei registri System e Application di Windows, e i messaggi con priorità err o più grave dal journal di systemd, in Log.
- I container Docker su Linux e le macchine Hyper-V su Windows, ogni cinque minuti.
Dove non si può installare nulla, Linux tramite SSH (senza agente) esegue un unico comando fisso che legge solo /proc, df e uname, e verifica la chiave dell’host a ogni esecuzione; Windows tramite WinRM (senza agente) accede con NTLMv2 e messaggi cifrati, oppure via HTTPS. I loro valori hanno gli stessi nomi di quelli dell’agente, quindi valgono gli stessi trigger. La guida Monitorare server Linux e Windows senza agente, tramite SSH e WinRM mostra la configurazione.
Applicazioni web, certificati e API
- Pagina web (HTTP) controlla lo stato di un URL, un testo sulla pagina e i giorni alla scadenza del suo certificato.
- Scenario web (più passi) percorre un’applicazione come farebbe un utente. Un passo per riga — il metodo e l’indirizzo, lo stato atteso, un testo che la pagina deve contenere e i dati del modulo; i cookie vengono mantenuti da un passo all’altro, e
{secret}è la password del controllo:
Misura il tempo di tutti i passi e quanti sono riusciti; l’avviso indica il passo che non è riuscito.GET /login | 200 | Sign in POST /login | 302 | | user=monitor&password={secret} GET /dashboard | | Welcome - Certificato TLS sorveglia la posta, LDAP o qualsiasi altra porta TLS. Valgono per esso i trigger integrati Il certificato scade presto (meno di 21 giorni) e Il certificato scade (meno di 7).
- Valore da API JSON legge un numero da un endpoint di salute o di stato dei vostri servizi: un indirizzo, un percorso come
results.cpu.0.currente, facoltativamente, un accesso Bearer o basic.
I vostri trigger
I trigger integrati sorvegliano già i dispositivi giù, i controlli giù, il carico CPU elevato, memoria e dischi pieni, la perdita di pacchetti e i certificati in scadenza. I vostri si creano in Problemi → Trigger:
- Valore fuori intervallo: un valore (carico CPU, tempo di risposta, connessioni …) sopra o sotto una soglia per almeno alcuni minuti, così un breve calo non apre un problema; con una Gravità e Si applica a tutti i dispositivi, un gruppo o un solo dispositivo.
- Un solo controllo: il pulsante con la campanella accanto a un controllo sulla pagina del dispositivo aggiunge un trigger solo per quel controllo, per esempio un disco importante o il tempo di risposta di una pagina web.
- Nessun dato nuovo: un controllo che non ha ricevuto nessun valore nuovo per i minuti impostati — un agente che ha smesso di inviare dati.
- Messaggio syslog o trap: un testo o un’espressione regolare nei messaggi syslog, nelle trap o nei log di sistema degli agenti.
Un problema si chiude da solo quando la condizione finisce. I trigger che imparano cosa è normale e le previsioni sono spiegati nella guida all’alternativa a Zabbix.
Notifiche, escalation e reperibilità
In Impostazioni → Notifiche gli amministratori aggiungono i canali: email tramite il vostro server SMTP, un webhook JSON (firmato con HMAC-SHA256 in X-WatchZit-Signature quando impostate una chiave), Slack, Microsoft Teams, Discord, Telegram, ntfy, PagerDuty (i problemi aprono e risolvono gli incidenti) e SMS tramite Twilio o un vostro gateway. Ogni canale ha una gravità minima e, con Anche alla risoluzione, segnala anche quando i problemi vengono risolti.
In Escalation e orari di reperibilità di un canale:
- Avvisa dopo (minuti): il canale viene a sapere solo dei problemi ancora aperti dopo quel tempo — il responsabile del team dopo 15 minuti, quando la prima linea non ha reagito.
- Ripeti ogni (minuti): avvisa di nuovo finché il problema resta aperto. I problemi presi in carico non passano all’escalation né vengono ripetuti, a meno che sia attivo Anche problemi già presi in carico.
- Solo alcuni giorni e orari (reperibilità): per esempio SMS al turno di notte dal lunedì al venerdì dalle 18 alle 08 e per tutto il fine settimana. Un problema che inizia fuori da quegli orari raggiunge il canale quando inizia il suo turno, se è ancora aperto.
- Una rotazione è un canale per persona o team, ognuno con i suoi giorni e orari.
Un canale che è stato avvisato di un problema viene avvisato anche quando è risolto; gli altri no.
Presa in carico, dipendenze e manutenzione
- Problemi elenca ciò che è aperto, dal più grave. Con Prendi in carico e una nota fate sapere agli altri che qualcuno se ne sta occupando. I problemi risolti restano nello storico per un anno.
- Dipendenze: con Dipende da impostato, un host dietro un router giù risulta solo irraggiungibile; i suoi problemi vengono registrati ma non inviati.
- Manutenzione in Problemi → Manutenzione per dispositivi o gruppi: vengono ancora misurati, ma non viene inviato nulla; i problemi ancora aperti alla fine della finestra vengono inviati in quel momento. Ripetizione ripropone la finestra ogni giorno, settimana o mese, facoltativamente fino a un ultimo giorno. I rapporti di disponibilità mostrano a parte il tempo di manutenzione.
Manutenzione e prese in carico dai vostri script
Create un token in Il mio account → Token API; agisce con il vostro ruolo e viene mostrato una sola volta. Uno script di deploy può così pianificare una finestra di manutenzione prima di riavviare i server:
curl -H "Authorization: Bearer wzat_…" -H "Content-Type: application/json" \
-d '{"name":"Deploy","starts_at":"2026-11-20T22:00:00+01:00","ends_at":"2026-11-20T22:30:00+01:00","group_ids":[3]}' \
https://monitor.example.com:8443/api/v1/maintenance
L’API legge anche lo stato, i dispositivi, i controlli, i grafici e i problemi, e prende in carico i problemi con POST /api/v1/problems/{id}/ack. Le modifiche fatte con un token vengono scritte nel registro di controllo con il nome del token.
Dashboard, rapporti e chi può modificare cosa
- Dashboard con grafici, valori attuali, stati dei dispositivi, problemi aperti, mappe e grafici da origini dati; si ricaricano ogni minuto per uno schermo a parete.
- Rapporti: la disponibilità per dispositivo per 7, 30 o 90 giorni o un mese, con i tempi di inattività e il numero di problemi, in CSV o PDF, con un Obiettivo SLA (%) per gruppo e per email ogni settimana o ogni mese.
- Ruoli: Amministratore, Operatore (dispositivi, controlli, mappe, trigger, manutenzione, dashboard) e Osservatore. Accesso con due fattori, Active Directory / LDAP o single sign-on (OpenID Connect, SAML 2.0).
Cosa WatchZit non fa
- Nessun file di configurazione e nessun importatore. Host, controlli e trigger si configurano nella console; le configurazioni esistenti non si possono importare, e lo storico inizia il giorno in cui aggiungete un host.
- Nessun controllo che esegua vostri script o plugin. I valori vostri arrivano da un controllo Valore da API JSON verso un vostro servizio, da un OID SNMP o da un’origine dati su un grafico.
- Nessun risultato inviato dall’esterno. L’API legge i dati, prende in carico i problemi e pianifica la manutenzione; non crea host, controlli né trigger.
- I controlli senza agente coprono le basi (CPU, memoria, swap o file di paging, il disco più pieno, uptime). Ogni unità, i servizi, i processi e i log richiedono l’agente.
- I controlli di database sono PostgreSQL e MySQL/MariaDB; uno scenario web ha da 1 a 10 passi.
- Il server funziona su Linux (x86-64) con PostgreSQL, oppure come appliance.
WatchZit accanto al monitoraggio attuale
- Installate WatchZit su una VM a parte; sul server di monitoraggio esistente non cambia nulla.
- Iniziate con un gruppo di host. Usate i controlli senza agente o installate l’agente WatchZit accanto a ciò che gira oggi sui server; l’agente ha bisogno solo della sua connessione in uscita verso la porta 8444.
- Date a WatchZit i suoi utenti di monitoraggio (SSH, WinRM, database, scenari web), così potete distinguere i suoi accessi e rimuoverli in seguito.
- All’inizio inviate i problemi di WatchZit a un canale di prova, non ai telefoni di reperibilità.
- Confrontate per qualche settimana quali problemi ha segnalato ciascun sistema e quali erano importanti, poi decidete quale dei due avvisa il team di reperibilità.
Cosa fare dopo
- Vedete tutto ciò che fa WatchZit nella pagina delle funzionalità e scaricatelo dalla pagina di download.
- Dispositivi di rete via SNMP: Un’alternativa a LibreNMS e Observium.
- Filiali dietro NAT: Monitorare le filiali con un collettore remoto.
- Il riferimento completo è la guida utente integrata nella console; vedete la documentazione.
Domande e idee sono benvenute nelle GitHub Discussions. Le aziende possono ottenere supporto commerciale da MaxZit (solo in inglese).
Nagios e Checkmk sono marchi dei rispettivi titolari. MaxZit non è affiliata ai titolari di Nagios o Checkmk né sponsorizzata o approvata da essi; i nomi sono usati solo per descrivere l’argomento di questa guida.