订阅主题树

订阅主题树是 EMQX Edge Dashboard Monitor 页面中的可视化功能。它以树状层级展示所有 MQTT 主题订阅，帮助你清晰查看主题关系、订阅数量以及客户端订阅详情。

功能

• 树状视图：按照 MQTT 主题层级结构展示所有已订阅主题。
• 订阅统计：显示每个主题节点下订阅客户端的数量。
• 可展开节点：支持展开和折叠主题分支，便于浏览多层主题结构。
• 主题详情：点击主题节点后，会打开详情面板，显示完整主题路径和已订阅客户端列表。
• 关键字过滤：支持按关键字快速搜索和过滤主题。

使用场景

订阅主题树功能适用于以下场景：

• 主题规划验证：验证系统中的主题层级设计是否符合预期。
• 订阅监控：实时监控每个主题的订阅客户端数量。
• 故障排查：快速定位指定主题的订阅详情，辅助问题诊断。
• 系统审计：了解整个 MQTT Broker 中主题订阅的分布情况。

使用订阅主题树

本节演示客户端订阅 MQTT 主题后，如何通过主题树查看并验证订阅情况。

订阅主题

为便于演示，你可以使用 EMQX Edge Dashboard 内置的 Tools 页面模拟 MQTT 客户端。

1. 打开 Edge Dashboard。

2. 进入 Tools。

3. 点击 Connect 建立默认连接。

4. 在 Subscription 区域，依次订阅以下主题：

   • t
   • t/1
   • t/1/2
   • t/1/2/test

   

5. 点击 Default 标签页旁边的 +，新建两个客户端连接，并让这两个客户端都订阅主题 t/1。

查看主题树结构

1. 进入 Monitor -> Subscriptions Topic Tree。

2. 找到根主题节点 t，它表示顶层主题。

3. 点击主题旁边的展开图标，查看其层级结构。你会看到相关主题以嵌套形式排列：

   t                    1 client subscribed
     └─ 1               3 clients subscribed
         └─ 2           1 client subscribed
             └─ test    1 client subscribed

   说明：

   • Topic Nodes：每一行表示一个主题层级。

   • Indentation Levels：表示主题之间的父子关系。

   • Subscription Count：显示在右侧，表示订阅该主题的客户端数量。

查看主题详情

点击任意主题节点，右侧会打开详情面板。该面板显示：

• Full Topic：完整主题路径
• Subscribed Clients：订阅该主题的客户端 ID 列表

如果订阅客户端较多，可使用分页控件浏览完整列表。

过滤主题

要快速定位指定主题：

1. 在页面顶部搜索框中输入关键字。
2. 点击搜索图标或按 Enter。
3. 树状视图只会显示匹配关键字的主题及其父路径。

刷新数据

点击页面右上角的刷新按钮，可重新加载并显示最新的主题订阅数据。