MQTT 客户端接入与数据流程
使用真实 MQTTX 与 FMQ 客户端详情完成 MQTT 接入、定时上行、详情统计、最近消息、完整 RabbitMQ 消息流向、平台下发、MQTTX 实收、离线记录、重连和清理。
页面导读
适用场景适合需要用真实 MQTTX 客户端在 FMQ 控制台跑通 MQTT 接入、上行、下发、离线与重连全流程的实施和运维人员。
前置条件已能登录 FMQ 控制台并具备客户端查看和测试指令权限，准备一个可用的 MQTTX 客户端，预计 45 分钟。
验收点客户端列表显示会话在线，最近消息能看到上行记录，消息流向完整到达连接器，MQTTX 实收平台下发，断开后产生离线记录且重连后恢复。
阅读方法
先确认入口、权限和目标对象，再按编号完成操作。每一步都包含预期结果；详细字段和选项收在可展开的参考表中。
截图说明
截图来自原始操作手册。公开版会隐藏真实节点地址、连接地址和凭据；示例中的状态、时间和数据不代表当前生产环境。
开始前准备
| 项目 | 说明 |
|---|---|
| 能做什么 | 按协议完成设备接入、上行、客户端详情统计、平台下发、设备实收、断开重连和清理。 |
| 从哪里进入 | 登录 FMQ 控制台后进入设备 → 客户端。 |
| 需要权限 | 具备客户端查看和测试指令权限。 |
| 预计时间 | 45 分钟 |
操作步骤
1. 进入 MQTT 客户端页面
操作位置： FMQ 客户端页面
进入设备 → 客户端，使用协议筛选和刷新查看统一的 MQTT、TCP、UDP 客户端列表。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 客户端列表 | 统一查看 MQTT、TCP、UDP 客户端会话，先用筛选和搜索定位设备。 |
2. 查看客户端列表字段
操作位置： FMQ 客户端页面
核对客户端 ID、协议、状态、节点、远端地址、心跳时间、会话模式、订阅数、最后活跃和最近离线。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 客户端 ID | 设备唯一编号，用于精确定位一台设备。 |
| 协议 | 设备接入使用的 MQTT、TCP 或 UDP 协议。 |
| 状态 | 当前会话在线、离线或其他运行状态。 |
| 节点 | 设备当前归属的集群服务器节点。 |
| 远端地址 | 设备连接到平台时使用的地址和端口。 |
| 心跳时间 | 设备最近一次心跳或保活时间。 |
| 会话模式 | 会话当前采用的连接模式。 |
| 订阅数 | MQTT 会话当前订阅主题的数量。 |
| 最后活跃 | 最近一次收发数据的时间。 |
| 最近离线 | 最近一次离线时间和原因。 |
3. 操作客户端行
操作位置： FMQ 客户端页面
在目标行查看追踪、查看订阅和断开连接入口；追踪用于打开实时详情。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 搜索 | 按 clientId、sessionId、远端地址或节点缩小结果。 |
| 节点筛选 | 只查看指定集群节点上的会话。 |
| 协议筛选 | 只查看 MQTT、TCP 或 UDP 会话。 |
| 状态筛选 | 按在线或离线状态筛选。 |
| 刷新列表 | 重新读取当前运行面会话。 |
| 分页 | 浏览更多会话记录。 |
| 追踪 | 开启当前会话的详情采集。 |
| 查看订阅 | 进入 MQTT 主题订阅明细。 |
| 断开连接 | 主动结束设备会话并产生离线记录。 |
4. 查看追踪详情总览
操作位置： FMQ 客户端页面
打开目标客户端追踪，核对连接状态、节点、建立时间、最后活跃、写入/读取字节、消息数、失败数、订阅数和平均延迟。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 连接状态 | 当前设备连接是否有效。 |
| 节点 | 会话所在的集群节点。 |
| 建立时间 | 本次会话建立的时间。 |
| 最后活跃 | 最近一次活跃时间。 |
| 写入字节 | 平台向设备发送的累计字节。 |
| 读取字节 | 平台从设备读取的累计字节。 |
| 写入消息 | 平台向设备发送的消息数量。 |
| 读取消息 | 平台从设备读取的消息数量。 |
| 丢弃/失败 | 被丢弃或发送失败的消息数量。 |
| 订阅数 | 当前订阅数量。 |
| 平均延迟 | 消息处理平均耗时；仅在页面提供时显示。 |
5. 查看订阅主题
操作位置： FMQ 客户端页面
打开订阅主题页签，核对实际下行主题、QoS、Node、NL、RAP、RH。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| Topic | 设备接收下行消息的主题地址。 |
| QoS | 主题服务质量级别。 |
| Node | 订阅所属运行节点。 |
| NL | 是否禁止本地发布回送。 |
| RAP | 是否保持原始发布标志。 |
| RH | 保留消息处理策略。 |
6. MQTTX 定时发送上行数据
操作位置： MQTTX
保持 MQTTX 连接到 mqtt.example.com:1883，确认 /861234562606057/property/post 上行 JSON 包含 temperature、humidity、voltage。
公开版截图说明
截图包含原测试 Broker 地址，公开版以示例域名代替。操作方法和字段说明完整保留。
7. 查看最近消息
操作位置： FMQ 客户端页面
打开最近消息页签，按 JSON、原文、HEX 查看实时上行消息的时间、Topic、方向、消息 ID、大小和 payload。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 显示格式 | JSON、原文或 HEX 阅读方式。 |
| 上行/下行 | 区分设备上报和平台下发。 |
| 时间 | 消息进入详情记录的时间。 |
| Topic/地址 | 消息来源主题或网络地址。 |
| 消息 ID | 关联一次报文的唯一编号。 |
| Payload 格式 | 原始报文的编码类型。 |
| Payload 大小 | 报文占用的字节数。 |
| 字段识别 | JSON 对象及其字段摘要。 |
8. 查看完整消息流向
操作位置： FMQ 客户端页面
打开消息流向并展开查看过程，核对来源 Topic、RabbitMQ Queue、Alink JSON、规则处理、连接器和时间线。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 来源 Topic/地址 | 设备上行进入平台的来源。 |
| 方向 | 上行或下行方向。 |
| 处理节点 | 事件总线和协议处理位置。 |
| Alink 报文 | 平台统一组装后的业务消息。 |
| 规则处理 | 规则是否命中并执行动作。 |
| 连接器 | RabbitMQ/Kafka 等上报出口。 |
| 处理过程 | 可展开查看从接入到上报的时间线。 |
9. 查看最近异常
操作位置： FMQ 客户端页面
打开最近异常页签，说明连接、解析、路由、下发和超时异常；本次页面显示真实空状态。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 异常时间 | 异常发生时间，用于和设备动作对照。 |
| 异常类型 | 连接、解析、路由、下发或超时等类别。 |
| 异常消息 | 平台记录的具体异常信息。 |
| 空状态 | 没有记录时表示当前会话未产生详情异常。 |
10. 填写并发送测试指令
操作位置： FMQ 客户端页面
在发送测试指令页填写 /861234562606057/function/get，选择 JSON、QoS 0，保留 Retain/格式化/发送控件说明，并发送 {"command":"get"}。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| Topic | MQTT 下行主题；TCP/UDP 使用当前会话目标。 |
| QoS | 选择 0、1 或 2 级服务质量。 |
| Retain | 控制消息是否保留。 |
| Payload 类型 | 选择 JSON、原文或 HEX。 |
| 格式化 | 把 JSON 消息体整理为可读格式。 |
| 消息体 | 填写要发送到设备的内容。 |
| 发送测试指令 | 提交平台下发并等待设备 GUI 实收。 |
11. MQTTX 查看下行实收
操作位置： MQTTX
回到 MQTTX，确认订阅 /861234562606057/function/get 并查看平台下发消息的 Topic、Payload 和接收时间。
图：MQTTX 设备 GUI 截图：保留下行订阅主题和设备侧消息区域。
12. 查看最近离线记录
操作位置： FMQ 客户端页面
打开最近离线记录页签，核对时间和原因，区分 CLIENT_DISCONNECT、CONNECTION_CLOSED、超时或会话替换。
图：来自真实平台或设备 GUI 的独立区域截图。
字段说明
| 字段 / 控件 | 说明 |
|---|---|
| 离线时间 | 会话离线发生的时间。 |
| 离线原因 | 手动断开、心跳超时、通道关闭、会话替换或 UDP 超时等原因。 |
| 最近 10 条 | 页面最多保留最近十条内存记录。 |
| 重启清空 | 服务重启后这些记录会被清空。 |
13. 确认重连后的在线状态
操作位置： FMQ 客户端页面
刷新客户端列表与总览，确认 MQTTX 会话仍在线、最后活跃时间和收发统计持续更新。
图：来自真实平台或设备 GUI 的独立区域截图。
14. 清理本次手册证据
操作位置： FMQ 客户端页面
确认没有创建临时 MQTTX 连接或平台资源；停止本次追踪并刷新列表，保留用户原有 MQTTX 连接。
图：来自真实平台或设备 GUI 的独立区域截图。
客户端页面字段说明
以下按客户端列表和详情页签的阅读顺序说明页面字段；协议不适用的区域会明确标注，不把技术日志当作页面字段。
完整参考
| 字段 / 单位 | 通俗含义 | 数据方向 / 来源 | 正常判断 | 异常信号与第一检查点 |
|---|---|---|---|---|
| 客户端列表用途 | ||||
| 客户端列表页面字段 | 统一查看 MQTT、TCP、UDP 客户端会话，先用筛选和搜索定位设备。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 客户端列表重点字段 | ||||
| 客户端 ID页面字段 | 设备唯一编号，用于精确定位一台设备。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 协议页面字段 | 设备接入使用的 MQTT、TCP 或 UDP 协议。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 状态页面字段 | 当前会话在线、离线或其他运行状态。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 节点页面字段 | 设备当前归属的集群服务器节点。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 远端地址页面字段 | 设备连接到平台时使用的地址和端口。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 心跳时间页面字段 | 设备最近一次心跳或保活时间。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 会话模式页面字段 | 会话当前采用的连接模式。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 订阅数页面字段 | MQTT 会话当前订阅主题的数量。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最后活跃页面字段 | 最近一次收发数据的时间。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近离线页面字段 | 最近一次离线时间和原因。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 客户端列表操作 | ||||
| 搜索页面字段 | 按 clientId、sessionId、远端地址或节点缩小结果。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 节点筛选页面字段 | 只查看指定集群节点上的会话。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 协议筛选页面字段 | 只查看 MQTT、TCP 或 UDP 会话。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 状态筛选页面字段 | 按在线或离线状态筛选。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 刷新列表页面字段 | 重新读取当前运行面会话。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 分页页面字段 | 浏览更多会话记录。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 追踪页面字段 | 开启当前会话的详情采集。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 查看订阅页面字段 | 进入 MQTT 主题订阅明细。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 断开连接页面字段 | 主动结束设备会话并产生离线记录。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 追踪详情总览 | ||||
| 连接状态页面字段 | 当前设备连接是否有效。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 节点页面字段 | 会话所在的集群节点。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 建立时间页面字段 | 本次会话建立的时间。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最后活跃页面字段 | 最近一次活跃时间。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 写入字节页面字段 | 平台向设备发送的累计字节。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 读取字节页面字段 | 平台从设备读取的累计字节。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 写入消息页面字段 | 平台向设备发送的消息数量。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 读取消息页面字段 | 平台从设备读取的消息数量。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 丢弃/失败页面字段 | 被丢弃或发送失败的消息数量。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 订阅数页面字段 | 当前订阅数量。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 平均延迟页面字段 | 消息处理平均耗时；仅在页面提供时显示。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 订阅主题 | ||||
| Topic页面字段 | 设备接收下行消息的主题地址。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| QoS页面字段 | 主题服务质量级别。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Node页面字段 | 订阅所属运行节点。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| NL页面字段 | 是否禁止本地发布回送。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| RAP页面字段 | 是否保持原始发布标志。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| RH页面字段 | 保留消息处理策略。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近消息 | ||||
| 显示格式页面字段 | JSON、原文或 HEX 阅读方式。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 上行/下行页面字段 | 区分设备上报和平台下发。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 时间页面字段 | 消息进入详情记录的时间。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Topic/地址页面字段 | 消息来源主题或网络地址。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 消息 ID页面字段 | 关联一次报文的唯一编号。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Payload 格式页面字段 | 原始报文的编码类型。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Payload 大小页面字段 | 报文占用的字节数。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 字段识别页面字段 | JSON 对象及其字段摘要。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 消息流向 | ||||
| 来源 Topic/地址页面字段 | 设备上行进入平台的来源。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 方向页面字段 | 上行或下行方向。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 处理节点页面字段 | 事件总线和协议处理位置。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Alink 报文页面字段 | 平台统一组装后的业务消息。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 规则处理页面字段 | 规则是否命中并执行动作。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 连接器页面字段 | RabbitMQ/Kafka 等上报出口。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 处理过程页面字段 | 可展开查看从接入到上报的时间线。 | 设备 ↔ FMQ ↔ 上游 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 发送测试指令 | ||||
| Topic页面字段 | MQTT 下行主题；TCP/UDP 使用当前会话目标。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| QoS页面字段 | 选择 0、1 或 2 级服务质量。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Retain页面字段 | 控制消息是否保留。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| Payload 类型页面字段 | 选择 JSON、原文或 HEX。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 格式化页面字段 | 把 JSON 消息体整理为可读格式。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 消息体页面字段 | 填写要发送到设备的内容。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 发送测试指令页面字段 | 提交平台下发并等待设备 GUI 实收。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近异常 | ||||
| 异常时间页面字段 | 异常发生时间，用于和设备动作对照。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 异常类型页面字段 | 连接、解析、路由、下发或超时等类别。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 异常消息页面字段 | 平台记录的具体异常信息。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 空状态页面字段 | 没有记录时表示当前会话未产生详情异常。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近离线记录 | ||||
| 离线时间页面字段 | 会话离线发生的时间。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 离线原因页面字段 | 手动断开、心跳超时、通道关闭、会话替换或 UDP 超时等原因。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 最近 10 条页面字段 | 页面最多保留最近十条内存记录。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
| 重启清空页面字段 | 服务重启后这些记录会被清空。 | FMQ MQTT 客户端页面 | 字段在真实页面中可读取，并与当前会话身份一致。 | 字段缺失、停止更新或与设备动作不一致。第一检查点：刷新详情并回到对应页签核对会话状态、协议端口和设备 GUI。 |
客户端列表与详情
完整参考
| 字段/控件 | 用途说明 | 默认/推荐/示例 | 选项说明 | 作用与影响 | 生效条件 |
|---|---|---|---|---|---|
| 必填 客户端搜索 | 按客户端 ID、会话 ID、远端地址或节点过滤列表。 | 默认：空推荐：填写目标 Client ID示例：按当前环境填写 | 不适用 | 缩小列表范围，便于定位目标设备。 | 范围：当前页面筛选发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 节点筛选 | 按 FMQ 集群节点过滤会话。 | 默认：全部节点推荐：按详情节点选择示例：当前节点 | 全部节点：不限制运行节点。；在所有节点的客户端会话中查找目标。当前节点：只查看当前控制台连接节点。；缩小结果范围，便于核对节点归属。 | 只显示指定节点上的客户端。 | 范围：当前页面筛选发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 刷新列表 | 重新读取当前运行面客户端列表。 | 默认：—推荐：状态变化后刷新示例：刷新列表 | 不适用 | 显示最新在线状态、节点和活跃时间。 | 范围：当前页面数据发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 协议筛选 | 选择 MQTT、TCP 或 UDP 客户端协议。 | 默认：全部推荐：MQTT示例：MQTT | 不适用 | 只显示所选协议的会话。 | 范围：当前页面筛选发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 状态筛选 | 按在线或离线状态筛选会话。 | 默认：全部推荐：在线示例：在线 | 不适用 | 快速确认设备是否仍在线。 | 范围：当前页面筛选发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 分页 | 在多页客户端结果之间切换。 | 默认：第 1 页推荐：按结果翻页示例：下一页 | 不适用 | 查看当前筛选条件下的其他会话。 | 范围：当前页面数据发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 追踪 | 开启当前客户端的设备级追踪、最近消息和消息流向采集。 | 默认：关闭推荐：打开详情前开启示例：追踪 | 不适用 | 详情页开始显示收发统计、payload 和处理链路。 | 范围：当前客户端会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 打开详情 | 打开目标客户端详情抽屉。 | 默认：—推荐：确认目标行后打开示例：打开详情 | 不适用 | 查看总览、订阅、消息、流向、下发、异常和离线记录。 | 范围：当前页面发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 断开连接 | 主动关闭当前客户端运行会话。 | 默认：—推荐：仅在恢复或清理时使用示例：断开连接 | 不适用 | 设备变为离线并产生离线记录。 | 范围：当前运行会话发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 刷新详情 | 重新读取当前客户端详情和追踪快照。 | 默认：—推荐：上行或下发后刷新示例：刷新详情 | 不适用 | 更新字节、消息、异常和最后活跃等字段。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 总览 | 查看连接状态和收发监控指标。 | 默认：总览推荐：先查看示例：总览 | 不适用 | 判断会话是否建立以及上行/下行是否有活动。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 订阅主题 | 查看 MQTT 订阅主题及其 QoS 和属性。 | 默认：订阅主题推荐：MQTT 场景核对示例：订阅主题 | 不适用 | 确认设备能够接收下行主题。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 全局订阅页 | 跳转到全局订阅页面。 | 默认：—推荐：需要跨客户端查询时使用示例：全局订阅页 | 不适用 | 从单个客户端订阅扩展到全局主题检索。 | 范围：全局订阅页面发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近消息 | 查看当前会话最近收到和发出的消息。 | 默认：最近消息推荐：设备上行后查看示例：最近消息 | 不适用 | 核对实时方向、时间、主题、大小和 payload。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 JSON / 原文 / HEX | 切换消息 payload 的 JSON、原文或 HEX 展示。 | 默认：JSON推荐：JSON 优先，异常时看 HEX示例：HEX | 不适用 | 按可读性或原始字节需要阅读消息内容。 | 范围：当前页面展示发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 消息流向 | 查看消息经过协议、事件总线、规则和连接器的处理过程。 | 默认：消息流向推荐：上行消息后查看示例：消息流向 | 不适用 | 定位消息在哪个处理阶段成功或停留。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 发送测试指令 | 打开平台下发测试指令表单。 | 默认：发送测试指令推荐：确认订阅或会话目标后使用示例：发送测试指令 | 不适用 | 为当前设备准备一条可验证的下行消息。 | 范围：当前客户端会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 Payload 类型 | 选择下行消息按 JSON、原文或 HEX 发送。 | 默认：JSON推荐：按设备协议选择示例：JSON | 不适用 | 决定平台如何校验和编码消息体。 | 范围：当前下行请求发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 格式化 | 格式化 JSON 消息体。 | 默认：—推荐：发送前点击示例：格式化 JSON | 不适用 | 把紧凑 JSON 整理为可读结构，便于复核。 | 范围：当前下行请求发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 发送测试指令 | 提交当前下行测试指令。 | 默认：—推荐：参数核对后发送示例：发送测试指令 | 不适用 | 平台向目标客户端发送消息，并等待设备 GUI 实收验证。 | 范围：当前设备会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近异常 | 查看当前客户端最近记录的异常。 | 默认：最近异常推荐：异常排查时查看示例：最近异常 | 不适用 | 按时间和类型定位连接、解析、路由或超时问题。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近离线记录 | 查看当前客户端最近离线时间和原因。 | 默认：最近离线记录推荐：断开或重连后查看示例：最近离线记录 | 不适用 | 判断人工断开、超时、连接关闭或会话替换。 | 范围：当前客户端详情发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 关闭详情 | 关闭客户端详情抽屉。 | 默认：—推荐：完成核对后关闭示例：关闭详情 | 不适用 | 结束当前详情查看，页面会停止该窗口的追踪采集。 | 范围：当前页面发布：不需要 · 重启：不需要 · 重连：不需要 |
常见问题
FastBee 上怎么查看一台 MQTT 设备是否在线？
登录 FMQ 控制台进入设备 → 客户端，用协议筛选只看 MQTT，再用客户端 ID 搜索定位设备；在线状态要结合最后活跃时间一起判断会话是否仍在工作。
怎么确认平台下发的指令设备真的收到了？
在客户端详情的「发送测试指令」页填写下行 Topic、QoS 和消息体并发送，然后回到 MQTTX 查看对应订阅主题的实收消息、Payload 和接收时间，三者一致即为实收。
客户端详情里的最近离线记录能保留多久？
最多保留最近 10 条内存记录，服务重启后会被清空；离线原因可区分手动断开、心跳超时、通道关闭或会话替换。
怎么追踪一条 MQTT 上行消息在平台内的完整流向？
先在客户端行开启追踪，设备上行后打开详情的「消息流向」页签，逐段核对来源 Topic、RabbitMQ Queue、Alink 报文、规则处理和连接器，并可展开从接入到上报的时间线。
生产操作提示
截图和示例用于说明操作位置与判断方法，不代表当前生产状态。涉及发布、启停、重绑、重试或删除时，应先确认目标环境、影响范围和恢复方案，并由授权人员执行。
蜂信物联（FastBee） · FMQ 操作手册