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 rozpoczniesz

  • 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.

O tym zadaniu

Istnieje kilka metod uruchomienia programu narzędziowego klienta MQTT. Więcej informacji na temat uruchamiania programu narzędziowego klienta zawiera sekcja Uruchamianie programu narzędziowego klienta MQTT. W ramach tego zadania program narzędziowy klienta jest uruchamiany z kanału pomiarowego Jawny tekst utworzonego za pomocą kreatora Definiowanie przykładowej konfiguracji.

Domyślnie ID użytkownika agenta MCA kanału Jawny tekst jest ustawiony na wartość guest w systemie Windows i nobody w systemie Linux®. Te wartości domyślne są niezbędne w celu zasubskrybowania tematów.

Procedura

  1. Kliknij prawym przyciskiem myszy kanał pomiarowy Jawny tekst, 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.
  2. 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.
  3. 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.
  4. Kliknij opcję Połącz, aby nawiązać połączenie z kanałem pomiarowym Jawny tekst. W oknie Historia klienta zostanie wyświetlona pozycja nowego zdarzenia Połączono.
  5. Wpisz nazwę tematu w oknie Subskrypcja w polu Temat. Domyślną nazwą tematu jest Temat testowy i ta nazwa jest używana w całym zadaniu.
  6. Wybierz jakość usług subskrypcji z menu Żądaj jakości usług.
  7. Kliknij opcję Subskrybuj, aby zasubskrybować Temat testowy. W oknie Historia klienta zostanie wyświetlona pozycja nowego zdarzenia Zasubskrybowano wraz z nazwą tematu, jakością usługi i godziną zasubskrybowania.
  8. Zaakceptuj domyślną nazwę tematu Temat testowy w oknie Publikacja w polu Temat. Należy upewnić się, że tematy subskrypcji i publikacji są zgodne, tak aby klient MQTT otrzymywał komunikaty z odpowiedniego tematu.
  9. Wpisz komunikat w polu Komunikat. Domyślnym testem komunikatu jest Komunikat testowy.
  10. Wybierz jakość usług publikacji z menu Żądaj jakości usług.
  11. Wybierz opcję Zachowana, aby przekazać nowym subskrybentom najnowszą zachowaną publikację w tym temacie.
  12. Kliknij opcję Publikuj, aby opublikować komunikat w temacie Temat testowy dla zainteresowanych subskrybentów. W oknie Historia klienta zostanie wyświetlona pozycja nowego zdarzenia Opublikowano wraz z nazwą tematu, jakością usługi, informacją o zachowaniu komunikatu oraz godziną zasubskrybowania. W programie narzędziowym klienta w oknie Historia klienta jest wyświetlana pozycja nowego zdarzenia Odebrano.
  13. Wybierz odebrany komunikat w oknie 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.