Che cosa volevo sapere
«Internet non va» può voler dire quattro cose diverse: il router si è riavviato, l'operatore ha un problema, un access point ha perso l'alimentazione, oppure funzionano i collegamenti ma non la risoluzione dei nomi. Con un solo pulsante «c'è rete / non c'è rete» non si capisce quale. Il mio monitor lo dice, e scrive in un registro quando è successo e per quanto tempo.
Un limite va detto subito, perché sembra ovvio solo dopo. Quando il router è giù, anche Internet è giù: gli avvisi via WhatsApp, email e app partono dopo il ripristino, non durante. Serve a sapere che è successo, non a evitarlo.
Lo script netcheck.py
Lo script gira dentro il container di Home Assistant e usa solo la libreria standard di Python, più il comando ping. Lo lancio a ogni lettura con un sensore command_line ogni 20 secondi. Controlla quattro cose:
- Router: un ping all'indirizzo del router.
- Access point: un ping a ciascuno. Ogni access point può avere più indirizzi (nel mio caso due), ed è raggiungibile se ne risponde almeno uno.
- Internet: un ping a 1.1.1.1 e a 8.8.8.8.
- DNS: la risoluzione di un nome noto, per capire se il problema riguarda i nomi e non il collegamento.
Da questi risultati ricava la causa probabile con una regola semplice:
- router non raggiungibile: riavvio del router, mancanza di corrente, cavo o porta;
- router raggiungibile ma Internet no: problema dell'operatore o del collegamento 5G;
- router e Internet a posto ma un access point no: alimentazione, cavo o riavvio di quell'access point;
- Internet a posto ma DNS no: risoluzione dei nomi.
Per non riempire il registro di falsi allarmi ogni tipo di guasto ha una durata minima: sotto i 10 secondi per il router, 30 per un access point, 20 per Internet, 60 per il DNS, un'interruzione finisce solo nel registro e non genera avvisi. Se dopo il ritorno del router Internet non torna entro cinque minuti, l'avviso parte comunque.
C'è un'ultima cosa che mi piace: se il monitor stesso resta fermo per più di 90 secondi, lo scrive nel registro. Quel buco è la traccia che Home Assistant, quindi il mini PC, è stato spento o riavviato.
Ogni riga del registro config/logs/rete-eventi.log comincia con data e ora locali. I testi che lo script scrive ricalcano quelle regole: per esempio «Internet assente per ... ma il router rispondeva: problema dell'operatore o del collegamento 5G», oppure «... non raggiungibile per ... mentre router e Internet andavano: alimentazione o cavo dell'AP, oppure AP riavviato», oppure «MONITOR fermo per ... (Home Assistant o mini PC non attivo)». Se un'interruzione di un access point o di Internet coincide con quella del router, non genera un secondo avviso: è già spiegata da quella.
L'installazione
Lo script PowerShell trova da solo il router (il gateway predefinito di Windows), verifica che nel container esista ping, copia netcheck.py in config\scripts e fa una prova mostrandoti il risultato. Poi scrive packages\rete.yaml e aggiunge la scheda al dashboard. Gli access point si passano come NOME=IP1,IP2:
.\install-rete.ps1 -Router 192.168.1.1 -Aps 'AP-SALA=192.168.1.11,192.168.1.12','AP-STUDIO=192.168.1.13,192.168.1.14'
Gli indirizzi sono di esempio: sostituiscili con quelli della tua rete, riservati nel router. Il pacchetto contiene:
- il sensore principale «Rete dati», che legge lo script ogni 20 secondi con un limite di 25 secondi;
- i sensori derivati: router, Internet e DNS raggiungibili, latenza del router e di Internet, interruzioni di oggi;
- un'automazione che parte quando finisce un'interruzione e manda un avviso con il testo scritto dallo script;
- l'esclusione del sensore grezzo dalla cronologia, come per quello del Wi-Fi.
- alias: Rete interruzione rilevata
id: rete_evento
mode: queued
triggers:
- trigger: state
entity_id: sensor.rete_dati
attribute: evento
conditions:
- condition: template
value_template: >-
{% set nuovo = (trigger.to_state.attributes.evento if trigger.to_state else none) or {} %}
{% set vecchio = (trigger.from_state.attributes.evento if trigger.from_state else none) or {} %}
{{ trigger.from_state is not none
and trigger.from_state.state not in ['unavailable', 'unknown']
and nuovo.get('id', 0) | int(0) > 0
and nuovo.get('id', 0) != vecchio.get('id', 0) }}
actions:
- action: script.avviso
data:
titolo: "Rete: interruzione rilevata"
messaggio: "{{ trigger.to_state.attributes.evento.testo }}"
attesa: 10
La condizione serve a partire solo quando l'evento cambia davvero: ogni interruzione ha un numero progressivo, e l'avviso parte quando il numero è nuovo e lo stato precedente era valido.
La scheda «Rete»
- Collegamenti: router, Internet, DNS e interruzioni di oggi.
- Router, Internet e access point (48 ore): uno storico con anche gli access point letti dal controller Omada (vedi la guida sul Wi-Fi).
- Latenza (24 ore): router e Internet.
- Ultimo evento: il testo dell'ultima interruzione registrata.
I log del router con un ricevitore syslog
Il router sa raccontare cosa vede sulla rete (chi chiede un indirizzo, chi si collega), ma non conserva il registro a lungo. Con il protocollo syslog può mandarlo a un altro computer. Sul mini PC ho un piccolo ricevitore, syslog_listener.py, in ascolto sulla porta UDP 514.
- Orario di arrivo: ogni riga porta l'orario in cui il mini PC l'ha ricevuta. L'orologio del router si azzera a ogni riavvio, quindi non è affidabile.
- Rotazione: il file ruota a 5 MB e conserva cinque copie.
- Solo dal router: accetta i messaggi dall'indirizzo indicato (e da 127.0.0.1 per le prove), e il firewall di Windows apre la porta UDP 514 solo per quell'indirizzo.
- Un tetto: oltre 100 messaggi al secondo scarta quelli in eccesso e li conta.
- Sempre acceso: è un'attività pianificata all'avvio, con l'account di sistema, che si riavvia da sola ogni minuto se cade.
Al termine l'installazione manda un messaggio di prova a 127.0.0.1 e ti mostra che è stato registrato. Poi ti ricorda di impostare nel router l'indirizzo del mini PC come destinazione dei log. Il file finisce in config\logs\router-syslog.log.
Perché tanto lavoro per un file di testo? Perché è l'unica fonte per i dispositivi collegati via cavo o al Wi-Fi del router, che il controller Omada non elenca. L'inventario dei dispositivi parte proprio da qui.