MQTT-Clientdienstprogramm verwenden
Testen Sie Ihre Telemetriekonfiguration mit mindestens einem MQTT-Clientdienstprogramm. Im Rahmen dieser Task wird ein Clientdienstprogramm zum Veröffentlichen und Subskribieren von Nachrichten verwendet.
Vorbereitende Schritte
- Stellen Sie sicher, dass der Telemetrieservice (MQXR) aktiv ist.
- Es muss mindestens ein Telemetriekanal ausgeführt werden, damit das MQTT-Clientdienstprogramm erfolgreich verwendet werden kann.
Informationen zu diesem Vorgang
PlainText
gestartet, der vom Assistenten Musterkonfiguration definieren erstellt wurde.Die MCA-Benutzer-ID des Kanals
PlainText
wird unter Windows standardmäßig auf
guest
und unter Linux® auf
nobody
gesetzt.
Diese Standardwerte sind für die Subskription von Themen erforderlich.
Vorgehensweise
- Klicken Sie mit der rechten Maustaste auf den Telemetriekanal
PlainText
und klicken Sie anschließend auf MQTT-Clientdienstprogramm ausführen. Das Fenster für das Clientdienstprogramm wird geöffnet. Die Felder Host und Port werden automatisch mit den Werten aus dem ausgewählten Telemetriekanal gefüllt. - Geben Sie im Feld Client-ID eine Client-ID ein. Bei jedem Start eines MQTT-Clientdienstprogramms aus einem Telemetriekanal wird eine neue Client-ID generiert. Sie können die generierte ID verwenden oder einen beliebigen Namen eingeben. Wenn Sie mehrere Clientdienstprogramme in einem Telemetriekanal ausführen, müssen Sie sicherstellen, dass Sie für jedes Clientdienstprogramm eine andere Client-ID verwenden. Wenn zwei MQTT-Clientdienstprogramme die gleiche Client-ID verwenden, erzwingt das aktuellste Clientdienstprogramm das Trennen der Verbindung vom vorherigen Clientdienstprogramm. Wenn mehrere MQTT-Clientdienstprogramme aus einem Telemetriekanal ausgeführt werden, enthält die generierte Client-ID ein numerisches Suffix, das bei jedem Start eines neuen Clientdienstprogramms erhöht wird.
- Klicken Sie auf Optionen, um das Fenster Verbindungsoptionen zu öffnen. Sie können das Clientdienstprogramm mit einer bereinigten Sitzung starten oder die Last Will and Testament-Option konfigurieren.
- Klicken Sie auf Verbinden, um eine Verbindung zum Telemetriekanal
PlainText
herzustellen. Im Fenster Clientprotokoll wird ein neuer Ereigniseintrag alsVerbunden
angezeigt. - Geben Sie im Feld für das Thema der Subskription einen Themennamen ein.
Der Standardthemenname lautet
testTopic
und wird in der gesamten Task verwendet. - Wählen Sie im Menü QoS anfordern die Servicequalität der Subskription aus.
- Klicken Sie auf Subskribieren, um das Thema
testTopic
zu subskribieren. Im Clientprotokoll wird ein neuer Ereigniseintrag alsSubskribiert
angezeigt, zusammen mit den Themennamen, der Servicequalität und dem Zeitpunkt der Subskription. - Akzeptieren Sie im Feld für das Thema der Veröffentlichung den Standardthemennamen
testTopic
. Stellen Sie allgemein sicher, dass die Themen für die Subskription und Veröffentlichung übereinstimmen, damit der MQTT-Client Nachrichten aus dem korrekten Thema empfängt. - Geben Sie im Feld Nachricht eine Nachricht ein.
Der standardmäßige Nachrichtentest lautet
Testnachricht
. - Wählen Sie im Menü QoS anfordern die Servicequalität der Veröffentlichung aus.
- Wählen Sie Beibehalten aus, um die aktuellste ständige Veröffentlichung zu diesem Thema an neue Subskribenten zu senden.
- Klicken Sie auf Veröffentlichen, um die Nachricht im Thema
TestThema
für interessierte Subskribenten zu veröffentlichen. Im Clientprotokoll wird ein neuer Ereigniseintrag alsVeröffentlicht
angezeigt, zusammen mit dem Themennamen, der Servicequalität und Informationen dazu, ob die Nachricht beibehalten wird, sowie dem Zeitpunkt der Subskription. Im empfangenden Clientdienstprogramm wird im Clientprotokoll ein neuer Ereigniseintrag alsEmpfangen
angezeigt. - Wählen Sie im Clientprotokoll die empfangene Nachricht aus und klicken Sie auf Nachricht anzeigen, um die vollständige Nachricht im Fenster Nachrichtenanzeige anzuzeigen. Alternativ dazu können Sie die Nachricht auswählen und anschließend die Eingabetaste drücken bzw. doppelt auf die empfangene Nachricht klicken.
Ergebnisse
Das Veröffentlichen von Nachrichten und die Anzeige der Nachrichten aus subskribierten Themen zeigt, dass Ihr Warteschlangenmanager korrekt für Telemetry eingerichtet wurde.