In una smart home basata su MQTT (Zigbee2MQTT, Tasmota, ESPHome, Node-RED, Home Assistant) il broker diventa il sistema nervoso di tutta l'installazione: centinaia di messaggi che passano su decine di topic diversi. Quando qualcosa non funziona — un interruttore che non si accende, un sensore che non aggiorna il valore — il primo strumento da tirare fuori non è il log di Home Assistant, ma un client MQTT che permetta di vedere esattamente cosa transita sul broker. MQTT Explorer è l'applicazione desktop open-source più comoda per farlo.
Perché non basta il log di Home Assistant
Il log delle automazioni mostra solo quello che l'automazione ha effettivamente ricevuto e interpretato. Se il problema è a monte — un dispositivo che pubblica su un topic sbagliato, un payload in un formato inatteso, un messaggio che non viene mai inviato — il log non aiuta. Serve vedere il traffico MQTT grezzo, così come esce dal broker, prima che qualsiasi integrazione lo elabori.
Installazione
MQTT Explorer è disponibile per Windows, macOS e Linux, gratuito e open-source (mqtt-explorer.com). Su Linux si installa comodamente come AppImage o via snap:
sudo snap install mqtt-explorer
su macOS con Homebrew:
brew install --cask mqtt-explorer
oppure si scarica direttamente l'eseguibile per Windows dal sito ufficiale.
Connessione al broker
Alla prima apertura si crea una nuova connessione indicando:
- Host: l'indirizzo IP del broker (es. quello dove gira Mosquitto).
- Port: 1883 per connessione non cifrata, 8883 se si usa TLS.
- Username e password, se il broker li richiede.
- Topic di sottoscrizione: di default
#, cioè tutti i topic.
Una volta connesso, sulla sinistra compare l'intero albero dei topic, organizzato ad esempio in zigbee2mqtt/, tasmota/, homeassistant/, esattamente come i dispositivi li stanno pubblicando in quel momento.
Navigare l'albero dei topic
Cliccando su un topic nel pannello centrale si vede il valore corrente e, cosa molto utile, il pannello di destra mostra la cronologia dei valori nel tempo: per i topic numerici (temperatura, umidità, potenza istantanea) MQTT Explorer disegna automaticamente un grafico, utile per capire se un sensore sta davvero aggiornando i dati o è bloccato su un valore vecchio.
Per i payload in formato JSON, l'app li formatta automaticamente in modo leggibile, espandendo ogni campo, invece di mostrare una stringa compressa illeggibile.
Pubblicare messaggi di test
Dal pannello in basso si può comporre e pubblicare manualmente un messaggio su qualsiasi topic, utile per testare un dispositivo senza dover passare da Home Assistant o dall'automazione. Ad esempio, per forzare l'accensione di una presa Tasmota si può pubblicare direttamente:
Topic: cmnd/presa_soggiorno/POWER
Payload: ON
Se il dispositivo risponde correttamente, il problema non è nel firmware ma più a monte, nell'automazione o nell'integrazione che genera il comando.
Ripulire i messaggi retained
Molti dispositivi pubblicano messaggi con il flag retained, che restano memorizzati sul broker anche dopo il riavvio e vengono riconsegnati a ogni nuovo client che si sottoscrive. Con il tempo, dispositivi rimossi o riconfigurati lasciano topic "fantasma" che continuano ad apparire in Home Assistant. MQTT Explorer permette di cancellarli con un clic destro sul topic e "Delete", che di fatto pubblica un payload vuoto con il flag retained per ripulire il broker.
Filtrare il rumore
Su un'installazione con molti dispositivi Zigbee o ESPHome, l'albero completo può diventare enorme. La barra di ricerca in alto permette di filtrare per nome di topic, mentre la sottoscrizione può essere limitata a un ramo specifico invece di #, ad esempio sottoscrivendo solo zigbee2mqtt/+/availability per controllare rapidamente quali dispositivi Zigbee risultano online o offline.
Un caso d'uso tipico
Un sensore ESPHome smette di aggiornare la temperatura in Home Assistant. Aprendo MQTT Explorer e cercando il topic del sensore, si nota che l'ultimo messaggio risale a ore prima: il problema non è nell'integrazione MQTT di Home Assistant ma nel dispositivo stesso, che probabilmente ha perso la connessione Wi-Fi o si è bloccato. Senza uno strumento come questo, si perderebbe tempo a controllare configurazioni e automazioni che in realtà funzionano perfettamente.