Guida MikroTik
Diagnostica e monitoraggioIntermedio

Netwatch: monitoraggio host e automazione

Usare Netwatch per monitorare la raggiungibilità di host critici (gateway, server, CPE clienti) ed eseguire script automatici al cambio di stato, abilitando reazioni proattive ai guasti.

Netwatch (/tool/netwatch) esegue probe periodici verso host di rete e, al cambio di stato (up→down o down→up), esegue script RouterOS. È lo strumento ideale per implementare failover automatico, inviare notifiche via log, o attivare azioni correttive senza intervento umano.

Tipi di probe disponibili in v7

  • icmp — serie di ping ICMP con soglie su latenza media, massima, jitter e packet loss
  • tcp-conn — testa il three-way handshake TCP verso una porta specifica (es. 22, 443, 8728)
  • http-get / https-get — esegue una richiesta HTTP e valida il codice di risposta
  • dns — interroga un resolver DNS e valida la risposta
  • simple — ping base, compatibile con configurazioni pre-v7

Esempio 1 — Monitorare il gateway internet con failover su log

Netwatch ICMP sul gateway con script up/down
# Monitora il gateway primario ogni 30 secondi
# Se offline per più di 3 probe consecutivi → scrive warning nel log
/tool/netwatch/add   name=gateway-primario   host=203.0.113.1   type=icmp   interval=30s   timeout=3s   thr-avg=100ms   thr-loss-percent=50   startup-delay=1m   up-script=":log warning "Gateway primario TORNATO online""   down-script=":log error "Gateway primario OFFLINE - verificare uplink""

# Verifica stato attuale
/tool/netwatch/print

Esempio 2 — Monitorare la porta API MikroTik di un AP remoto

Probe TCP verso porta 8728 (RouterOS API)
# Controlla ogni 60s che l'AP remoto risponda sulla porta API
/tool/netwatch/add   name=ap-campo-nord   host=10.20.5.1   type=tcp-conn   port=8728   interval=1m   timeout=5s   down-script={
    /log error "AP Campo Nord non raggiungibile - porta 8728 chiusa"
    # Qui si può aggiungere: invia email, apri ticket via HTTP, ecc.
  }

Esempio 3 — Probe HTTP per monitorare un portale captive

Probe HTTP-GET con validazione codice risposta
# Verifica ogni 5 minuti che il portale risponda con HTTP 200
/tool/netwatch/add   name=portale-hotspot   host=10.0.0.10   type=http-get   port=80   http-codes=200   interval=5m   timeout=10s   down-script=":log critical "Portale hotspot NON risponde""
Gli script Netwatch vengono eseguiti con l'utente *sys che ha politiche limitate (read, write, test, reboot). Non possono usare comandi che richiedono policy sensitive o password. Per azioni avanzate (es. chiamate HTTP esterne) usa /tool/fetch dentro lo script. Il parametro startup-delay (default 5 minuti) evita falsi allarmi durante il boot del router.
  • In un WISP è utile monitorare: gateway upstream, server RADIUS, server NTP, apparati CPE critici, server di monitoraggio stesso
  • Con thr-loss-percent=20 Netwatch segnala problemi anche prima del down completo
  • Per failover WAN reale combinare Netwatch con routing ricorsivo o policy routing
  • Usare comment su ogni entry per documentare cosa si monitora e perché
netwatchhost monitoringup-scriptdown-scripticmptcphttpprobefailoveralertdisponibilità

Configura senza fatica con l'AI

In WispOS l'agente AI genera la configurazione RouterOS dalle tue parole e un tutor ti guida passo passo.

Prova WispOS