クライアント

EMQXに接続してパブリッシュおよびサブスクライブするクライアントとして、MQTTX を使用できます。あるいは、各種言語で提供されているクライアントライブラリ を利用して、EMQXへのクライアント接続を素早く実装することも可能です。クライアントページでは、現在サーバーに接続中のクライアントや、セッションが有効期限切れでないクライアントの詳細およびメトリクス統計を確認できます。

クライアント一覧

クライアント一覧では、現在接続中のクライアントに関する基本情報を以下のように確認できます。

• EMQXに接続する際に設定されたクライアントIDおよびユーザー名
• 現在の接続状態
• クライアントのIPアドレス
• 接続に設定されたハートビート間隔および最大アイドル時間
• セッションがクリアされているかどうかやセッション有効期限間隔などの接続セッション情報
• クライアントがEMQXに接続した時刻

クライアントのIPアドレスは、クライアントのIPアドレスとEMQXに接続する際に使用したポート番号を連結したものです。

画面上部のフィルター条件欄では、デフォルトでクライアントID、ユーザー名、IPアドレスのみが表示されます。クライアントIDやユーザー名を使ったあいまい検索で接続リストの絞り込みが可能です。検索バー横の右矢印ボタンをクリックすると、利用可能なすべてのフィルター条件が表示されます。接続状態や接続時間の範囲を選択して絞り込んだり、クライアントのIPアドレスを入力して対象IPで絞り込むこともできます。

一覧上部の列選択ボタンから表示する列を選択可能です。更新ボタンを押すとすべてのフィルター条件がリセットされ、接続リストが再読み込みされます。クライアントを選択してキックアウトをクリックすると、そのクライアントを手動で切断できます。

クライアント詳細

クライアント一覧のクライアントIDをクリックすると、クライアント詳細ページが開きます。このページでは、選択したクライアントの接続情報、セッションデータ、ランタイムメトリクスの詳細を確認できます。画面上部の操作でデータを手動更新したり、クライアントセッションをクリアすることも可能です。

クライアント一覧に表示される基本項目に加え、情報タブではMQTTプロトコルバージョンやクリーンセッション設定、（切断済みクライアントの場合は）最終切断時刻などの拡張接続情報を表示します。セッション情報パネルでは、セッション有効期限間隔、作成時刻、ヒープサイズ、サブスクリプション数、メッセージキュー使用状況、インフライトウィンドウサイズ、QoS 2受信キュー長などのセッション関連データを確認できます。

メトリクスタブには、クライアント接続のランタイム統計情報が表示され、送受信したバイト数やパケット数、QoSレベル別のメッセージ数、ドロップされたメッセージ統計などが含まれます。

サブスクリプションタブでは、クライアントが現在サブスクライブしているすべてのトピックが一覧表示されます。新規サブスクリプションから新たにサブスクライブを追加したり、特定トピックのサブスクライブ解除をクリックして削除することも可能です。