Wenn Sensoren oder Schalter über MQTT Daten senden, möchtest du bei Fehlern genau wissen, welche Payloads auf dem Broker eingehen. Während man bei klassischen Serverinstallationen einfach den Befehl mosquitto_sub -v -t '#' im Terminal nutzt, stehen dir in Home Assistant mehrere Wege offen. Diese Anleitung zeigt dir, wie du den Datenverkehr deines Mosquitto Brokers mitliest.
Das brauchst du
- Zugriff auf dein Home-Assistant-System
- Einen eingerichteten Mosquitto Broker
- Je nach Methode: SSH-Zugang oder Tools wie MQTTLens bzw. MQTT Explorer
1. MQTT-Verkehr über das Terminal mit mosquitto_sub abfangen
Wenn du das SSH-Add-on installiert hast, kannst du dich per SSH auf deinem Home-Assistant-System einloggen und direkt den bekannten Mosquitto-Client aufrufen.
Führe auf der Konsole folgenden Befehl aus:
mosquitto_sub -v -t '#'2. Visuelle Überwachung mit dem MQTT Explorer oder MQTTLens
Um Topics und Nachrichten übersichtlich im Blick zu behalten, kannst du ergänzende Werkzeuge einsetzen. Hierfür bieten sich beispielsweise die Browser-Erweiterung MQTTLens oder der MQTT Explorer an, um den Nachrichtenverkehr live zu verfolgen.
3. MQTT-Meldungen in den Home-Assistant-Logs anzeigen
Alternativ lässt sich der MQTT-Verkehr auch direkt im Systemlog von Home Assistant protokollieren, ohne dass du ein Konsolenfenster geöffnet halten musst.
Füge dazu deiner Logger-Konfiguration (beispielsweise in der configuration.yaml oder einer separaten logger.yaml) die MQTT-Komponente mit der gewünschten Protokollierungsstufe hinzu:
logger:
logs:
homeassistant.components.mqtt: debugNach dem Neuladen der Konfiguration findest du die einlaufenden Meldungen im Frontend unter Entwicklerwerkzeuge im Bereich der Protokolle.
Funktioniert es?
Sobald ein Gerät Daten publiziert, siehst du im Terminalfenster oder in den Tools die entsprechenden Topics und Payloads. Du kannst den Datenfluss testen, indem du ein Thema abonnierst und eine manuelle Testnachricht an dasselbe Topic abschickst.
Wenn es nicht klappt
- Keine eingehenden Nachrichten: Überprüfe, ob das sendende Gerät tatsächlich mit der IP-Adresse des Brokers verbunden ist und der Mosquitto Broker aktiv läuft.
Mit der Überwachung erkennst du Übertragungsfehler rasch und kannst unerkannte MQTT-Payloads bei Bedarf weiterverarbeiten.
Quellen: Forum: Home Assistant Community, smarterkram.de, alkly.de