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.