新功能发布记录
查看客户端详情
本文介绍如何 MQTT 控制台上查看客户端信息包含基本信息、连接信息和订阅关系等，帮助您实时掌握客户端状态，针对相关问题进及时进行处理。
查看客户端详情
查看客户端信息有两个操作入口：
入口一：
1. 登录 MQTT 控制台。
2. 在左侧导航栏单击资源管理 > 集群管理，选择好地域后，单击目标集群的“ID”，进入集群基本信息页面。
3. 在左侧页签栏选择客户端管理，即可查看客户端列表。
说明：
客户端管理页面可根据输入的客户端 ID 进行检索，支持模糊查询。
未输入的情况下，随机展示最多1024个会话。
入口二：
1. 登录 MQTT 控制台。
2. 在左侧导航栏单击资源管理 > 客户端管理，选择好地域和集群，即可查看客户端列表。
查看客户端信息：单击客户端的 ID 或者点击目标客户端操作栏的查看详情，可以进一步查看该客户端相关信息。
客户端详情说明
基本信息
展示客户端基本信息，包含客户端的 ID、地址、连接状态、创建时间和 MQTT 协议版本等。
参数 | 说明 |
客户端 ID | 客户端的唯一身份标识符，通常以 paho或者hive开头， |
客户端地址 | 客户端与服务端建立连接的网络源地址，包含 IP 地址和端口号。 |
连接状态 | 客户端的在线状态，在线状态下，您可以在客户端列表的操作栏手动操作断开连接，断开连接后无法消费消息。 |
客户端创建时间 | 客户端被创建的时间。 |
MQTT 协议版本 | |
传播属性（可选） | 可选配置，通过接口给指定客户端配置传播属性后，传播属性后续会跟随消息传递，转化为客户端发送消息的 User Property。客户可以利用这一特性，结合业务的具体场景，给消息添加业务上下文信息。在对接函数 MQTT 触发器时，也可以根据指定过滤后的传播属性触发函数。 |
Session 详情
Session 详情块展示的内容为当前会话连接的内存态信息，该信息不做持久化，当网络连接断开重连后，数据会清零并重新计数。
参数 | 说明 |
Clean Session（MQTT V3.1.1） Clean Start（MQTT V5.0） | 用于决定客户端和服务端如何处理之前的会话： true(1)：客户端希望建立一个临时、无状态的会话，连接断开时服务端将丢弃之前为该客户端 ID 保存的会话状态（包括未确认的 QoS 1/2 消息、订阅信息等）。适用于临时性的数据采集客户端、不需要历史状态的设备、或者用户希望从一个清零状态重新启动。 false(0)：客户端希望建立一个持久、有状态的会话，连接断开后服务端将保留客户的订阅信息和未确认的 QoS 1/2 消息，以便客户端重连后恢复。适用于需要可靠接收所有消息的客户端，即使在断线期间错过的消息，在重连后也希望被重新投递。 |
连接时间 | 当前连接状态为“在线”的客户端展示此信息，记录当前会话建立成功的时间戳，即最近一次收到 CONNECT 报文并回复 CONNACK 成功的时间，指的是本次连接开始的时间。 |
上次连接时间 | 当前连接状态为“未连接”的客户端展示此信息，记录上一次会话建立成功的时间戳。 |
Session 创建时间 | 记录该会话最初被创建的时间戳。 Clean Session = False 时，第一次连接创建该会话的时间，即使客户端断开重连，只要会话未过期，这个创建时间保持不变。 Clean Session = True 时，每次连接都会创建一个临时的新会话，该会话的“创建时间”其实就是本次的连接时间，并在断开后销毁。 |
上次断开连接时间 | 记录该会话上一次正常或异常断开连接的时间戳，结合“连接时间”可以计算出设备的在线率和离线时长。 |
保持连接时间(Keep Alive) | 客户端在 CONNECT 报文中声明的心跳间隔时间。客户端向服务端承诺，任何两个连续报文发送的间隔时间，不会超过 Keep Alive * 1.5 ， 服务端据此判断客户端是否存活，如果超过Keep Alive * 1.5 未收到任何报文，服务端会认为客户端已离线并断开连接。 |
接收数据量 | 在当前本次连接中，服务端从该客户端接收到的网络字节总数，包括了所有类型的 MQTT 报文（如 CONNECT，PUBLISH，SUBSCRIBE，PINGREQ 等）以及底层的协议头开销。它衡量的是入站流量。 |
接收 Packet 详情 | 在当前本次连接中，服务端从该客户端接收到的 MQTT 报文包的数量。 CONNECT：连接请求次数。 DISCONNECT：断开连接请求次数。 PUBLISH: 收到的发布消息条数。 PUBACK：发布确认 (QoS 1)。客户端对服务端转发的 QoS 1 消息的确认。 PUBREC：发布已收到 (QoS 2 第一步)。客户端对服务端转发的 QoS 2 消息的首次确认。 PUBREL：发布释放 (QoS 2 第二步)。客户端对服务端的 PUBREC 进行响应，表示它准备完成消息传输。 PUBCOMP：发布完成 (QoS 2 第三步)。客户端对服务端的 PUBREL 报文的最终确认。 PINGREQ：心跳请求次数。 SUBSCRIBE/UNSUBSCRIBE: 订阅/取消订阅请求次数。 |
发送数据量 | 在当前本次连接中，服务端向该客户端发送的网络字节总数，包括了所有下行报文（如 CONNACK，PUBLISH，PINGRESP 等）以及底层协议开销。它衡量的是出站流量。 |
发送 Packet 详情 | 在当前本次连接中，服务端向该客户端发送的 MQTT 报文包的数量。 CONNACK：连接确认次数。 PUBLISH: 向该客户端转发的消息条数。 PUBACK：发布确认次数 PUBREC：发布已收到 (QoS 2 第一步)。服务端作为接收方，对客户端发布的 QoS 2 消息的首次确认。 PUBREL：发布释放 (QoS 2 第二步)。服务端作为发送方，在收到客户端的 PUBREC 后，发送此报文要求客户端完成最终确认。 PUBCOMP：发布完成 (QoS 2 第三步)。服务端作为接收方，对客户端 PUBREL 报文的最终确认，完成整个 QoS 2 消息流程。 SUBACK/UNSUBACK：订阅确认/取消次数。服务端对客户端 SUBSCRIBE 报文的响应，报文中包含为每个订阅授予的 QoS 等级。 PINGRESP: 对心跳请求的响应次数。 DISCONNECT：断开连接。 |
订阅关系
参数 | 说明 |
Topic 订阅 | 客户端订阅的主题过滤器（Topic Filter） 。 |
服务质量等级 | 指客户端在订阅某个主题指定的服务质量等级（QoS）。 |
未确认消息数量 | 已发送给客户端但尚未收到完整确认（ACK）的消息数量，主要针对 QoS 1 和 QoS 2 消息： QoS 1：代理已发送 PUBLISH，但尚未收到客户端的 PUBACK。 QoS 2：代理已发送 PUBLISH，但尚未走完 PUBREC > PUBREL > PUBCOMP 的完整流程。 对于 QoS 0 消息，由于没有确认机制，因此不存在“未确认”状态。 |
堆积消息数量 | 暂存在服务端中，等待发送给该客户端的消息总数。 |
订阅属性 | 展示不同 Topic Filter 订阅时传的订阅属性（SUBSCRIBE Properties 中的 User Property），便于运维人员追溯订阅来源，快速定位异常订阅行为。 |
客户端证书
客户端证书是由 CA 证书签发给客户端设备的数字证书，客户端在与服务端建立连接时，服务端会根据客户端证书对客户端的身份进行安全验证。验证成功后，双方可借助证书中内置的加密密钥实现安全通信；若验证未通过，服务端将拒绝该客户端的连接请求。
客户端证书完成注册后，您可以随时在本页面管理已注册的客户端证书，例如查看已经注册的证书的状态、筛选已失效和即将失效（30天内即将过期）的客户端证书、查看客户端的详细信息。客户端注册方法请参考步骤4：配置客户端证书。
客户端事件
客户端事件是指在 MQTT 协议通信过程中，客户端会触发的一系列状态变化和交互通知。通过追踪系统事件，可以帮助用户及时排查定位分析问题，保障系统稳定性。本页面支持指定时间内的证书事件和客户端多种行为事件展示和查询，例如上下线和连接等，详细介绍请参考查询客户端事件。
客户端消息轨迹
文档反馈