MQTT クライアント・ユーティリティーの使用
MQTT クライアント・ユーティリティーを 1 つ以上使用して、遠隔測定セットアップをテストします。 このタスクの範囲では、1 つのクライアント・ユーティリティーを使用してメッセージをパブリッシュおよびサブスクライブします。
始める前に
- 遠隔測定 (MQXR) サービスが実行中であることを確認してください。
- MQTT クライアント・ユーティリティーを正常に使用するには、実行中の遠隔測定チャネルが少なくとも 1 つ必要です。
本タスクについて
PlainText
遠隔測定チャネルから開始されます。デフォルトでは、 PlainText
チャネルの MCA ユーザー ID は、Windows では guest
に、 Linux®では nobody
に設定されます。 トピックにサブスクライブするためには、これらのデフォルト値が必要です。
手順
-
PlainText
テレメトリー・チャネルを右クリックして、 「MQTT クライアント・ユーティリティーの実行」をクリックします。 クライアント・ユーティリティー・ウィンドウが開きます。 「ホスト」フィールドと「ポート」フィールドは、選択した遠隔測定チャネルの値を使用して自動的に設定されます。 - 「 クライアント ID 」フィールドにクライアント ID を入力します。 遠隔測定チャネルから MQTT クライアント・ユーティリティーを起動するたびに、新しいクライアント ID が生成されます。 この生成された ID を使用するか、または任意の名前を入力することができます。 遠隔測定チャネル上で複数のクライアント・ユーティリティーを実行する場合は、必ずクライアント・ユーティリティーごとに異なるクライアント ID を使用してください。 2 つの MQTT クライアント・ユーティリティーのクライアント ID が同じ場合、後から接続するクライアント・ユーティリティーが、前のクライアント・ユーティリティーを強制的に切断します。 遠隔測定チャネルから複数の MQTT クライアント・ユーティリティーを実行すると、生成されたクライアント ID に数値の接尾部が付加されます。この接尾部は、新しいクライアント・ユーティリティーを開始するたびにインクリメントされます。
- 「オプション」 をクリックして、 「接続オプション」 ウィンドウを開きます。 クリーン・セッションでクライアント・ユーティリティーを開始するか、遺言オプションを構成することができます。
-
PlainText
テレメトリー・チャネルとの接続を確立するには、 「接続」 をクリックします。Connected
の新規イベント項目が 「クライアント・ヒストリー」に表示されます。 - 「サブスクリプション トピック」 フィールドにトピック名を入力します。 デフォルトのトピック名は
testTopic
で、この名前はこのタスク全体で使用されます。 - 「要求」 QoS メニューからサブスクリプションのサービス品質を選択します。
- トピック
testTopic
にサブスクライブするには、 「サブスクライブ」 をクリックします。 「クライアント・ヒストリー」に、Subscribed
の新規イベント項目が、トピック名、 QoS、およびサブスクリプションの時刻とともに表示されます。 - 「パブリケーション」 の 「トピック」 フィールドで、デフォルトのトピック名
testTopic
を受け入れます。 通常は、MQTT クライアントが正しいトピックのメッセージを受信できるように、サブスクリプション・トピックとパブリケーション・トピックを一致させておく必要があります。 - 「メッセージ」 フィールドにメッセージを入力します。 デフォルトのメッセージ・テストは
Test Message
です。 - 「要求」 QoS メニューから、パブリケーションのサービス品質を選択します。
- このトピックの最新の保存パブリケーションを新規サブスクライバーに転送するには、 「保存」 を選択します。
- 関心のあるサブスクライバーの
testTopic
トピックにメッセージをパブリッシュするには、 「パブリッシュ」 をクリックします。 「クライアント・ヒストリー」に、Published
の新規イベント項目が、トピック名 QoS、メッセージが保持されるかどうか、およびサブスクリプションの時刻とともに表示されます。 受信側クライアント・ユーティリティーで、Received
という新しいイベント項目が 「クライアント・ヒストリー」に表示されます。 - 「クライアント履歴」で受信したメッセージを選択し、 「メッセージの表示」 をクリックして、 「メッセージ・ビューアー」 ウィンドウにメッセージ全体を表示します。 あるいは、メッセージを選択して Enter を押すか、受信メッセージをダブルクリックします。
結果
メッセージをパブリッシュでき、サブスクライブしたトピックのメッセージを表示できるということは、キュー・マネージャーが Telemetry 用に正しくセットアップされていることを示しています。