サブスクリプション管理

このページでは、EMQX ダッシュボードでクライアントのサブスクリプションおよび接続されているトピックの確認方法について説明します。

サブスクリプション

サブスクリプションページでは、クライアントIDとトピックごとにマッピングされた接続によってサブスクライブされているすべてのトピックを表示します。各サブスクリプションの基本情報として、クライアントID、トピック、QoS（サービス品質）が提供されます。さらに、MQTT v5でサポートされている新しいサブスクリプション機能もリストに含まれています。

• No Local: MQTT v3.1.1では、自分がパブリッシュしたメッセージをサブスクライブしているトピックに対しても受信します。MQTT v5では、このオプションを1に設定すると、サーバーが自身のパブリッシュしたメッセージをクライアントに転送しないようにできます。
• Retain as Published: このオプションは、サーバーがクライアントにメッセージを転送する際にRETAINフラグを保持するかどうかを指定します。ただし、これは保持メッセージのRETAINフラグには影響しません。したがって、Retain As Publishが0に設定されている場合、クライアントはメッセージのRETAINフラグのみを参照して、通常のパブリッシュメッセージか保持メッセージかを判断します。
• Retain Handling: このオプションは、サーバーがサブスクライブ時に保持メッセージをクライアントに送信するタイミングを指定します。
  • Retain Handlingが0の場合：クライアントがサブスクライブに成功するとすぐに保持メッセージを送信します。
  • Retain Handlingが1の場合：このサブスクリプションが以前に存在しなかった場合のみ保持メッセージを送信します。
  • Retain Handlingが2の場合：サブスクリプションの状態に関わらず、保持メッセージをクライアントに送信しません。

上部の検索バーにはデフォルトで3つのフィルター項目が表示されます：ノード、クライアントID、トピック。ノードはドロップダウン選択ボックスで、特定のノードに接続しているクライアントによるサブスクリプションをフィルタリングできます。クライアントIDとトピックはサブスクリプションリストのあいまい検索に使用可能です。検索バー右側の矢印ボタンをクリックすると、QoSおよびShared Nameのフィルター入力欄も表示され、Shared Nameの厳密なマッチングに対応します。

トピック

トピックページでは、複数のノードにまたがる接続によってサブスクライブされているすべてのトピックを表示します。同一ノード内で異なる接続が同じトピックをサブスクライブしている場合は重複排除が行われます。ユーザーはトピックに基づくあいまい検索でリストを絞り込むことができます。

注意：サブスクリプションリストはクライアント単位の情報ですが、トピックリストは現在サブスクライブされているすべてのトピックを表示します。同じトピックが異なるクライアントによってサブスクライブされている場合があります。

「アクション」列のCreate Monitorをクリックすると、診断 -> トピックメトリクスページに遷移します。ここで、特定のトピックに対するメッセージ数、レートなどのトピックメトリクスを作成して追跡できます。