该页面用于查看和分析broker系统中存储的所有会话。 包括当前在线的已连接会话(表示当前已连接到broker的客户端),以及持久化客户端的已断开会话。 通过该页面,用户可全面了解所有已存储会话,便于监控并管理客户端与broker的活跃及历史交互记录。
查看当前TBMQ会话的详细信息,请按以下步骤操作:
- 在左侧菜单打开 “Sessions” 页面。
- 点击会话表行,打开会话详情窗口。
在 “Session Details” 中,用户可以断开或移除客户端会话:
- 要断开客户端,点击 “Disconnect client” 按钮。请注意,仅可断开
Connected状态的客户端。 - 要移除客户端会话,点击 “Remove session” 按钮。请注意,仅可移除
Disconnected状态的客户端。
Session Details
Details 选项卡包含以下信息:
- Connected Status(Connected/Disconnected)。
- Connected At-客户端连接的时间戳。
- Disconnected At-对于已断开的持久化客户端,显示客户端断开的时间戳。
- Keep Alive(秒)- 表示broker与客户端在会话关闭前可无通信的持续时间。
- Node ID-客户端当前/曾经连接的broker节点。
- Clean Start(clean/persistent session)- 为true时,broker将丢弃所有可用的先前会话信息与消息,并启动新会话。
- Session expiry interval-对于已断开的持久化客户端,表示连接丢失后客户端会话信息保留的时长。
- Session end-对于已断开的持久化客户端,表示会话信息与消息何时被移除。
- Client ID-客户端标识符。
- Client IP-客户端IP地址。
- Client type(Device/Application)。
- 用于认证当前会话的 Client Credentials。
- MQTT version-指定使用的MQTT协议版本:MQTT3.1 (3)、MQTT3.1.1 (4) 或MQTT5.0 (5)。
Subscriptions
在 Subscriptions 选项卡中,用户可查看与会话关联的订阅的详细信息,例如:
- Topic filter(主题过滤器)。MQTT主题过滤器。
- QoS。订阅的服务质量。
- Retain as Published。为true时,通过此订阅转发的消息保留其发布时的RETAIN标志。
- Retain Handling(保留消息处理)。该选项决定客户端订阅主题时broker如何处理保留消息。
- 0 - 在订阅时发送保留消息;
- 1 - 若订阅尚不存在,则在订阅时发送保留消息;
- 2 - 在订阅时不发送保留消息。
- No local。为true时,broker不会将来自此客户端的消息转发回进行该订阅的连接。
- Subscription Identifier(订阅标识符)。分配给订阅的唯一数值,用于客户端区分不同订阅的消息。
会话详情通常为只读,但用户可在会话内有效管理订阅,包括添加、删除和编辑。 管理订阅的可用操作如下:
- 要添加新订阅,点击 “Add Subscription” 按钮。
- 要删除订阅,点击该订阅旁的 “Delete” 图标。
- 要编辑已有的主题过滤器或QoS,在表单中修改后点击 “Update” 按钮。
Metrics
Metrics 选项卡提供该会话内MQTT消息流转的详细洞察,有助于监控消息投递的性能与可靠性:
- Received PUBLISH Messages。 客户端接收的PUBLISH消息总数。
- Received QoS 0 Messages。 接收的QoS 0(”AT_MOST_ONCE”)消息数量。
- Received QoS 1 Messages。 接收的QoS 1(”AT_LEAST_ONCE”)消息数量。
- Received QoS 2 Messages。 接收的QoS 2(”EXACTLY_ONCE”)消息数量。
- Sent PUBLISH Messages。 客户端发送的PUBLISH消息总数。
- Sent QoS 0 Messages。 发送的QoS 0(”AT_MOST_ONCE”)消息数量。
- Sent QoS 1 Messages。 发送的QoS 1(”AT_LEAST_ONCE”)消息数量。
- Sent QoS 2 Messages。 发送的QoS 2(”EXACTLY_ONCE”)消息数量。