Skip to content

订阅管理

本页介绍在 EMQX Dashboard 中查看连接到 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,客户端订阅成功且该订阅此前不存在,服务端才发送保留消息。毕竟有些时候客户端重新发起订阅可能只是为了改变一下 QoS,并不意味着它想再次接收保留消息。
    • Retain Handling 等于 2,即便客户订阅成功,服务端也不会发送保留消息。

顶部搜索栏默认显示节点、客户端 ID 和 Topic 3 个过滤搜索字段。其中节点为下拉选择框,可以选择查看连接到某个节点的客户端订阅,或使用客户端 ID 和 Topic 对订阅列表进行模糊搜索。点击搜索栏右侧箭头按钮还将显示 QoS 和共享名称过滤输入框,共享名称支持的是精确匹配。

subscriptions

主题

主题列表页面根据主题与节点的映射关系,展示了所有连接在各个节点订阅的主题,如果在相同节点中,不同连接订阅了同一主题,列表将进行去重处理。用户可根据主题对列表进行模糊搜索过滤查看。

注:订阅列表是根据客户端来区分的,而主题是当前所有已经订阅过的主题,相同的主题可能包含在不同的客户端。

点击操作列中的创建监控,将跳转到问题分析 -> 主题监控页面。您可以为该主题创建主题监控,用来统计该主题下的消息收发数量、速率等指标。

主题