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