Korzystanie z programu narzędziowego klienta MQTT
W celu przetestowania konfiguracji pomiarowej można użyć jednego lub kilku programów narzędziowych klienta MQTT. W ramach tego zadania użyto jednego programu narzędziowego klienta w celu publikowania i subskrybowania komunikatów.
Zanim zaczniesz
- Należy sprawdzić, czy usługa telemetryczna (MQXR) działa.
- Konieczny jest co najmniej jeden działający kanał pomiarowy, aby pomyślnie użyć programu narzędziowego klienta MQTT.
Informacje o zadaniu
PlainText
utworzonego za pomocą kreatora Definiowanie przykładowej konfiguracji.Domyślnie ID użytkownika MCA kanału PlainText
jest ustawiony na wartość guest
w systemie Windows, a nobody
w systemie Linux®. Te wartości domyślne są potrzebne w celu zasubskrybowania tematów.
Procedura
- Kliknij prawym przyciskiem myszy kanał telemetryczny
PlainText
, a następnie kliknij opcję Uruchom program narzędziowy klienta MQTT. Zostanie otwarte okno programu narzędziowego klienta. Wartości pól Host i Port zostaną ustawione automatycznie przy użyciu wartości z wybranego kanału pomiarowego. - Wpisz identyfikator klienta w polu Identyfikator klienta . Przy każdym uruchomieniu programu narzędziowego klienta MQTT z kanału pomiarowego jest generowany nowy identyfikator klienta. Można użyć wygenerowanego identyfikatora lub wpisać nazwę wybranego identyfikatora. W przypadku uruchomienia więcej niż jednego programu narzędziowego klienta w kanale pomiarowym, należy pamiętać o użyciu różnych identyfikatorów klienta w każdym programie narzędziowym klienta. Jeśli dwa programy narzędziowe klienta MQTT mają taki sam identyfikator klienta, ten, który nawiązał połączenie jako ostatni, zostanie rozłączony z poprzednim w sposób wymuszony. W przypadku uruchamiania więcej niż jednego programu narzędziowego klienta MQTT z kanału pomiarowego wygenerowany identyfikator klienta posiada przyrostek liczbowy, który jest powiększany przy każdym uruchomieniu nowego programu narzędziowego klienta.
- Kliknij przycisk Opcje , aby otworzyć okno Opcje połączenia . Program narzędziowy klienta można uruchomić od wyczyszczonej sesji lub skonfigurować opcje ostatniej woli i testamentu.
- Kliknij opcję Połącz , aby nawiązać połączenie z kanałem telemetryczny
PlainText
. W polu Historia klientawyświetlana jest nowa pozycja zdarzeniaConnected
. - Wpisz nazwę tematu w polu Subskrypcja Temat . Domyślna nazwa tematu to
testTopic
, a ta nazwa jest używana w ramach tego zadania. - Wybierz jakość subskrypcji usługi z menu Żądaj usługi QoS .
- Kliknij opcję Subskrybuj , aby zasubskrybować temat
testTopic
. W polu Historia klientazostanie wyświetlona nowa pozycja zdarzeniaSubscribed
wraz z nazwą tematu, QoS i czasem subskrypcji. - Zaakceptuj domyślną nazwę tematu
testTopic
w polu Publikacja Temat . Należy upewnić się, że tematy subskrypcji i publikacji są zgodne, tak aby klient MQTT otrzymywał komunikaty z odpowiedniego tematu. - Wpisz komunikat w polu Komunikat . Domyślnym testem komunikatu jest
Test Message
. - Wybierz jakość usługi publikacji z menu Żądaj jakości usługi .
- Wybierz opcję Zachowana , aby przekazać najnowsze zachowaną publikację w tym temacie do nowych subskrybentów.
- Kliknij przycisk Publikuj , aby opublikować komunikat w temacie
testTopic
dla zainteresowanych subskrybentów. Nowa pozycja zdarzeniaPublished
jest wyświetlana w obszarze Historia klientawraz z nazwą tematu, QoS, czy komunikat jest zachowywany, a także czasem subskrypcji. W programie narzędziowym klienta odbierającego nowa pozycja zdarzeniaReceived
jest wyświetlana w polu Historia klienta. - Wybierz otrzymany komunikat w polu Historia klienta, a następnie kliknij opcję Wyświetl komunikat , aby wyświetlić pełny komunikat w oknie Przeglądarka komunikatów . Można także wybrać komunikat i nacisnąć klawisz Enter lub dwukrotnie kliknąć odebrany komunikat.
Wyniki
Możliwość publikowania i przeglądania komunikatów w zasubskrybowanych tematach świadczy o poprawnym skonfigurowaniu menedżera kolejek dla składnika Telemetry.