MQTT クライアント・ユーティリティーの使用

MQTT クライアント・ユーティリティーを 1 つ以上使用して、遠隔測定セットアップをテストします。 このタスクの範囲では、1 つのクライアント・ユーティリティーを使用してメッセージをパブリッシュおよびサブスクライブします。

作業を始める前に

  • 遠隔測定 (MQXR) サービスが実行中であることを確認してください。
  • MQTT クライアント・ユーティリティーを正常に使用するには、実行中の遠隔測定チャネルが少なくとも 1 つ必要です。

本タスクについて

MQTT クライアント・ユーティリティーを開始するには、いくつかの方法があります。 クライアント・ユーティリティーの実行について詳しくは、 MQTT クライアント・ユーティリティーの実行を参照してください。 このタスクの有効範囲内で、クライアント・ユーティリティーは、「サンプル構成の定義」ウィザードで作成された PlainText 遠隔測定チャネルから開始されます。

デフォルトでは、 PlainText チャネルの MCA ユーザー ID は、Windows では guest に、 Linux®では nobody に設定されます。 トピックにサブスクライブするには、これらのデフォルト値が必要です。

手順

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

結果

メッセージをパブリッシュでき、サブスクライブしたトピックのメッセージを表示できるということは、キュー・マネージャーが Telemetry 用に正しくセットアップされていることを示しています。