# トピックメトリクス

EMQXのトピックメトリクス機能は、指定したトピックに関する詳細な統計情報を提供します。これには、送受信されたメッセージ数、メッセージレート、その他関連するメトリクスが含まれます。この機能にアクセスするには、EMQXダッシュボードの **Diagnose** -> **Topic Metrics** に移動してください。あるいは、REST APIを通じてトピックメトリクスを取得することも可能です。

## ダッシュボードでトピックメトリクスを表示する

トピックメトリクス機能を有効化した後、ページ右上の **Add Topic** ボタンをクリックして新しいトピック監視ルールを追加できます。なお、`+` や `#` といったワイルドカードを含むトピックフィルターは現時点でサポートされていません。特定のトピック名を指定してください。

<img src="./assets/topic-metrics-ee.png" alt="トピックメトリクス" style="zoom: 40%;" />

**Actions** 列の **View** ボタンをクリックすると、指定したトピックにおける1秒あたりの受信、送信、ドロップされたメッセージ数の詳細情報を確認できます。また、異なるQoSレベルごとにフィルタリングすることも可能です。

トピックメトリクス一覧には以下のフィールドが含まれます：

- **Topic**: 監視対象のトピック名
- **Incoming messages**: 現在のトピックにおける受信メッセージの合計数および1秒あたりの受信メッセージ数
- **Outgoing Messages**: 現在のトピックにおける送信メッセージの合計数および1秒あたりの送信メッセージ数
- **Dropped Messages**: 現在のトピックでドロップされたメッセージの合計数および1秒あたりのドロップ数
- **Start at**: このトピック監視レコードを作成した日時
- **Actions**: このトピック監視レコードに対して実行できる操作
  - **View**: 異なるQoSレベルごとのトピック詳細メトリクスを表示
  - **Reset**: 監視を再起動
  - **Delete**: レコードを削除

## REST APIでトピックメトリクスを取得する

APIを通じてトピックメトリクスを取得することも可能です。EMQXのAPIの使い方については、[REST API](../admin/api.md)をご参照ください。

<img src="./assets/topic-metrics-api-ee.png" alt="トピックメトリクスAPI" style="zoom:45%;" />