MQTT Retain und LWT richtig einsetzen
Ein Dashboard startet neu und zeigt sofort den letzten Sensorwert. Das kann eine retained MQTT-Nachricht sein. Die Anzeige sagt aber zunächst nichts darüber, ob der Sensor gerade lebt. Last Will and Testament, kurz LWT, erfüllt eine andere Aufgabe: Der Broker kann bei einem unerwarteten Verbindungsverlust eine vorher vereinbarte Statusmeldung veröffentlichen.
Retain ist kein Messwertarchiv
Der MQTT-5.0-Standard von OASIS beschreibt den Retain-Schalter: Der Server hält für ein Topic die letzte entsprechend veröffentlichte Nachricht vor und kann sie einem neuen Subscriber zustellen. Eine neue retained Nachricht ersetzt die alte; eine entsprechende leere Veröffentlichung kann den gespeicherten Wert entfernen. Das ist nützlich für zuletzt bekannte Zustände oder Konfigurationen, aber keine Historie und kein Beweis für Frische. Ein Temperaturwert von gestern darf nicht als aktuelle Messung dargestellt werden. Ergänze gegebenenfalls Zeitstempel oder eine kontrollierte Ablaufstrategie. [1]
Was ein Will tatsächlich meldet
Der Client hinterlegt beim Verbindungsaufbau Will-Topic und Will-Payload. Reißt seine Verbindung unerwartet ab, veröffentlicht der Broker diese Nachricht nach den Protokollregeln. Beim regulären Trennen soll kein Ausfallalarm entstehen. Home Assistant beschreibt für MQTT-Entitäten Availability-Topics und Payloads; daraus kann eine Oberfläche den Unterschied zwischen „letzter Wert“ und „online“ zeigen. Nach einer neuen Verbindung muss der Client seinen Online-Zustand selbst wieder passend veröffentlichen. Ein Will erkennt weder eine falsche Sensormessung noch zwangsläufig einen Gerätefehler bei weiter bestehender Brokerverbindung. [2]
Saubere Topic-Aufteilung
Lege für einen Sensor getrennte Topics wie messwert und availability fest und dokumentiere, welches davon retained ist. Schreibt ein Gerät regelmäßig Messwerte, überlege, ob Retain für den letzten Wert sinnvoll ist oder eine irreführende Daueranzeige erzeugt. Ein retained Offline-Will kann neue Abonnenten sofort vor dem Ausfall warnen; nach Reconnect muss ein retained Online-Status folgen. Prüfe, ob der Hersteller Availability bereits korrekt implementiert, bevor du eine zweite Automatisierung darüberlegst. Die Grundintegration erklärt Home Assistant und MQTT.
Wiederanlauf testen
Starte einen Testsubscriber erst nach der Veröffentlichung: Er sollte den letzten retained Wert erhalten. Trenne danach den Testclient unerwartet und beobachte, ob sein Will auf dem vereinbarten Status-Topic erscheint. Verbinde erneut und kontrolliere, ob eine frische Online-Meldung den Ausfallzustand ersetzt. Dokumentiere Broker-Neustart und persistente Speicherung getrennt; Retain-Verhalten hängt auch von Brokerkonfiguration und Laufzeit ab. Für eine allgemeine Alarmstrategie ist Alertmanager-Alarme eine Ergänzung, nicht automatisch ein Ersatz für saubere Zustandsdaten.
Bei einem Brokerwechsel kann ein alter retained Wert aus einer vorherigen Testinstallation erhalten bleiben, falls Datenbestände migriert werden. Räume Test-Topics gezielt auf und verwende verständliche Namen statt unstrukturierter Sammelpfade. Kontrolliere auch, welcher Client den Status veröffentlicht; ein Gateway kann online bleiben, während ein dahinterliegender Funksensor längst schweigt. Für diesen Sensor ist ein eigener Frischetest nötig. Die LWT-Meldung des Gateways beschreibt nur dessen Brokerverbindung. Wenn Home Assistant nach einem Neustart sofort „online“ anzeigt, prüfe, ob der Status wirklich nach dem Neustart neu gesendet wurde oder lediglich retained war. Ein eindeutiger Zeitstempel und eine dokumentierte Ablaufregel beseitigen diese Verwechslung.
Plane Will-Delay und Session-Laufzeit bewusst: Bei einem kurzzeitig unterbrochenen Testclient kann eine verzögerte Will-Meldung ausbleiben, wenn die Verbindung rechtzeitig wiederhergestellt wird. Miss daher im Test nicht nur, ob ein Offline-Status erscheint, sondern auch wann und unter welchen Broker-/Client-Einstellungen. Ein regulärer Disconnect und eine Netzunterbrechung sind unterschiedliche Testfälle; protokolliere beide getrennt.
Definiere für das Availability-Topic einen eindeutigen Startzustand: Der Client meldet nach erfolgreichem Verbindungsaufbau selbst „online“; sein Will beschreibt nur das unerwartete Verbindungsende. Wird die Online-Meldung retained veröffentlicht, prüfe beim Broker-Neustart bewusst, ob ein alter gespeicherter Zustand noch sichtbar ist. Der Zeitpunkt der letzten Sensor-Messung bleibt eine andere Information als die Erreichbarkeit der MQTT-Verbindung. In Home Assistant muss die Availability-Auswertung zum tatsächlich verwendeten Topic und zu den Payloads passen; ein optisch grüner Sensorwert allein belegt keinen frischen Messwert. [1] [2]
Offizielle Quellen
- [1] OASIS: MQTT Version 5.0 – OASIS MQTT 5.0: Abschnitte Retain Handling und Will Message/Will Delay; letzter retained Wert je Topic.
- [2] Home Assistant: MQTT-Integration und Availability – Home Assistant MQTT: Availability-Topics, Status-Payloads und retained Discovery-Nachrichten.

