MQTT 设备追踪

用一个真实 MQTT 客户端完成连接、上行、追踪阅读、订阅实收、断开和恢复。本篇使用的 FMQX 为 FastBee 自研客户端工具，与第三方 MQTTX 不同。

页面导读

适用场景适合 MQTT 设备出现连接、收发或解析异常时，用设备追踪收集证据并定位排查入口的运维人员。

前置条件具备设备追踪查看及相应运行操作权限，准备一个 FMQX MQTT 客户端用于产生真实数据，预计 15 分钟。

验收点时间线出现本次设备事件，事件证据、报文追踪与综合诊断可读取，断开和恢复都能在时间线中对齐。

阅读方法

先确认入口、权限和目标对象，再按编号完成操作。每一步都包含预期结果；详细字段和选项收在可展开的参考表中。

截图说明

截图来自原始操作手册。公开版会隐藏真实节点地址、连接地址和凭据；示例中的状态、时间和数据不代表当前生产环境。

开始前准备

项目	说明
能做什么	用一个真实 MQTT 客户端完成连接、上行、追踪阅读、订阅实收、断开和恢复。
从哪里进入	追踪 → 设备追踪
需要权限	设备追踪查看及相应运行操作权限
预计时间	15 分钟

操作步骤

1. 在 FMQX 建立设备连接

操作位置： FMQX→连接会话

确认设备会话名称、协议、端点和连接状态。

图：MQTT 会话已经连接，设备侧身份和收发统计可见。

2. 让设备产生真实数据

操作位置： FMQX→发布消息

向本次属性上报 Topic 连续发送可识别数据。

图：FMQX MQTT 操作区保留本次真实上行数据和发送入口。

3. 在工作台定位对象

操作位置： 追踪→设备追踪

输入设备标识并使用打开追踪对象。

图：输入客户端 ID、设备编号或追踪键，再打开同一个追踪对象。

字段说明

字段 / 控件	说明
标识输入	可输入客户端 ID、IP、设备编号、deviceKey、sessionId 或完整追踪键。
打开追踪对象	解析输入并打开同一个对象，不用于创建设备档案。

4. 读取对象状态和入口操作

操作位置： 追踪→设备追踪→追踪对象列表

只查看当前协议对象的状态、协议和风险结论，再进入详情。

图：当前 MQTT 对象卡片集中显示追踪状态、协议、风险结论，并提供删除和查看详情。

字段说明

字段 / 控件	说明
追踪状态	区分未开始、追踪中和已结束；追踪中才继续收集新证据。
协议	说明当前对象按哪种通信方式解析和展示。
风险结论	平台根据当前证据给出的排查优先级，不等同于最终故障原因。
追踪键	当前追踪对象的唯一运行标识，用于避免同名对象串线。

5. 先看懂追踪详情完整页面

操作位置： 追踪→设备追踪→追踪详情

先从整页确认顶部工具、对象摘要、左侧时间线和右侧三个详情页签的位置关系。

图：追踪详情由顶部工具、对象摘要、左侧时间线和右侧分析区组成；先选事件，再切换证据页签。

6. 掌握详情顶部工具

操作位置： 追踪详情→顶部工具栏

确认返回、追踪开关、下载、刷新、搜索和预留入口。

图：顶部工具栏用于返回、切换追踪、下载证据、刷新、搜索其他对象；AI 深度追踪当前为预留入口。

字段说明

字段 / 控件	说明
返回工作台	返回对象列表，不会停止追踪。
开启/关闭追踪	开启十分钟实时采集，或停止继续采集新事件。
下载证据	下载当前对象的证据文本，适合交接排查。
刷新	立即读取最新状态；页面也会每三秒自动刷新。
AI 深度追踪	当前仅为预留入口，不能当作诊断已完成。
全局搜索	不返回工作台即可切换到另一个追踪对象。

7. 读取对象状态摘要

操作位置： 追踪详情→对象摘要

核对身份、在线状态、剩余时间、证据数量和重点问题。

图：先确认对象身份、追踪剩余时间、时间线数量、来源证据和重点问题，再继续看单条事件。

字段说明

字段 / 控件	说明
对象身份	区分已建档设备和运行时发现对象；身份未确认不等于通信失败。
运行状态	表示当前是否在线或是否正在采集，与单条报文结果分开判断。
剩余时间	本次实时追踪距离自动结束还有多久。
时间线数量	当前对象已经聚合出的可读事件数量。
来源证据	说明这条结论依据哪个运行来源。
重点问题	需要优先查看的异常或身份问题数量。
采集模式	Live 表示正在采集，Standby 表示只读已有证据。

8. 从时间线选择一条事件

操作位置： 追踪详情→时间线列表

按阶段筛选并选择本次真实通信事件。

图：时间线按发生顺序展示连接、上行、下行、离线和恢复；左侧负责选事件，右侧负责看证据。

字段说明

字段 / 控件	说明
发生时间	事件进入追踪时间线的时间，用于与 FMQX 设备时间对齐。
阶段	说明事件位于连接、上报、解析、输出还是恢复阶段。
事件类型	运行时原始事件的稳定类型，用于精准定位。
流向状态	说明后续链路是否已捕获、等待或缺少证据。
阶段筛选	只改变当前列表范围，不删除证据。

9. 查看事件来源证据

操作位置： 追踪详情→事件证据

确认事件来源、时间、协议上下文和关联证据。

图：事件证据回答这条记录何时发生、来自哪里、属于哪一阶段，以及平台掌握了哪些上下文。

字段说明

字段 / 控件	说明
来源证据	说明这条结论依据哪个运行来源。
协议上下文	MQTT 使用 Topic 与 QoS；本例订阅功能下行 Topic，设备端完成一次收发自检。
来源时间	证据产生的时间，用于核对是否属于本次操作。
查看全部来源证据	展开当前对象全部来源，不改变运行状态。

10. 完整读取报文和流向

操作位置： 追踪详情→报文追踪

从上到下核对链路结论、设备侧Topic与原始报文、MQ 转发报文、转发过程和技术字段。

图：完整报文追踪从链路结论开始，依次展示设备原始报文、MQ 转发报文、转发过程和技术字段。

字段说明

字段 / 控件	说明
链路类型	说明当前对比的是设备上报与 MQ 转发，还是一次设备命令或 Modbus 轮询。
事件时间	当前选中事件发生的时间，应与设备侧发送或回复时间接近。
设备上报状态	已捕获表示平台保留了设备进入 FMQ 的原始报文；非上报事件不代表通信失败。
平台规则或连接器状态	说明当前事件是否找到了匹配的上行规则和连接器流向证据。
MQ 转发状态	已转发表示连接器已经提交；等待或未捕获时继续检查规则与连接器。
链路结论	链路完整只证明追踪已看到设备报文和转发证据，业务系统是否消费仍需单独确认。
设备协议	设备上报卡中的协议，应与当前追踪对象一致。
来源 Topic 或地址	MQTT 显示 Topic，TCP 显示远端地址，Modbus TCP 显示轮询端点或响应线索。
设备事件类型	平台记录的原始事件类型，用于区分连接、上报、解析和回复。
运行节点	处理这条报文的 FMQ 节点，用于排查集群节点差异。
traceId	设备侧事件的关联标识，用于和日志、规则或下游记录交叉核对。
设备原始报文	设备进入 FMQ 时保留的原始 Payload 或十六进制帧，是判断设备实际发送内容的依据。
输出目标	说明这条上行消息准备投递到哪个连接器或外部目标。
投递地址	展示 Topic、Exchange/RoutingKey 或其他实际投递地址，用于核对目标是否选对。
flowId	一次平台转发过程的关联标识，用于把各处理阶段串成同一条链路。
MQ 转发报文	平台经过规则处理后交给连接器的消息体，可与设备原始报文对照字段变化。
转发过程与耗时	展开后按阶段显示规则匹配、动作提交和连接器执行时间；失败时先找第一个异常阶段。
技术字段	展开后列出报文、节点、异常和关联标识，供实施和研发进一步定位。

11. 理解综合诊断和协议动作

操作位置： 追踪详情→综合诊断

阅读结论、原因和建议动作，只执行当前协议与会话支持的按钮。

图：综合诊断给出当前结论、可能原因和建议动作；动作是否出现取决于协议、会话和所选事件。

字段说明

字段 / 控件	说明
诊断结论	对当前选中事件的通俗结论。
可能原因	平台根据现有证据列出的排查方向，不代表已经确认根因。
建议动作	与当前事件、协议和会话上下文匹配的下一步。
动作条件	发送测试指令、重试最近下发和断开会话只对当前在线 MQTT 会话生效；断开后必须由设备重新连接。

12. 用设备侧计数核对动作

操作位置： FMQX→会话摘要

比较上下行计数和连接代数，确认本轮动作产生了新的设备通信。

图：FMQX MQTT 会话恢复后仍可收发；下行计数用于核对平台测试指令是否到达设备侧。

13. 在设备侧确认真实实收

操作位置： FMQX→实时消息

核对订阅 Topic 的 TX、RX、QoS 和 Payload。

图：设备侧显示真实 Topic、QoS、方向和消息体；本次为订阅链路自检，不能冒充平台追踪按钮已完成下发。

14. 对齐断开、异常和恢复

操作位置： 追踪详情→时间线列表

查看断开或超时记录，再定位恢复后的新事件。

图：断开和重连位于同一追踪时间线，恢复必须以重连后的新上行或下行证据为准。

字段说明

字段 / 控件	说明
异常时间	故障或断开被记录的时间。
异常阶段	说明失败发生在连接、发送、等待回复、解析或输出。
异常原因	本次可观察到的错误或离线原因。
恢复后新事件	FMQX 主动断开并重连后再次上报，新的 TRANSPORT_MESSAGE 出现在时间线中。

15. 完成恢复判断

操作位置： 追踪详情→综合诊断

把设备侧实收、恢复后新事件和当前诊断放在一起确认。

图：最终把设备侧实收、平台新事件和综合诊断放在一起判断；历史异常仍保留，不代表当前通信仍失败。

字段说明

字段 / 控件	说明
当前结论	基于最新证据形成的当前判断。
历史异常	已保留的旧故障记录；出现历史异常不代表当前仍失败。
恢复信号	FMQX 主动断开并重连后再次上报，新的 TRANSPORT_MESSAGE 出现在时间线中。
下一检查点	当前证据不足时，建议优先核对的位置。

客户端页面字段说明

以下按客户端列表和详情页签的阅读顺序说明页面字段；协议不适用的区域会明确标注，不把技术日志当作页面字段。

完整参考

字段 / 单位	通俗含义	数据方向 / 来源	正常判断	异常信号与第一检查点
定位追踪对象
标识输入-	可输入客户端 ID、IP、设备编号、deviceKey、sessionId 或完整追踪键。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
打开追踪对象-	解析输入并打开同一个对象，不用于创建设备档案。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
读取工作台对象状态
追踪状态-	区分未开始、追踪中和已结束；追踪中才继续收集新证据。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
协议-	说明当前对象按哪种通信方式解析和展示。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
风险结论-	平台根据当前证据给出的排查优先级，不等同于最终故障原因。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
追踪键-	当前追踪对象的唯一运行标识，用于避免同名对象串线。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
掌握详情工具栏
返回工作台-	返回对象列表，不会停止追踪。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
开启/关闭追踪-	开启十分钟实时采集，或停止继续采集新事件。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
下载证据-	下载当前对象的证据文本，适合交接排查。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
刷新-	立即读取最新状态；页面也会每三秒自动刷新。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
AI 深度追踪-	当前仅为预留入口，不能当作诊断已完成。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
全局搜索-	不返回工作台即可切换到另一个追踪对象。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
读取对象状态摘要
对象身份-	区分已建档设备和运行时发现对象；身份未确认不等于通信失败。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
运行状态-	表示当前是否在线或是否正在采集，与单条报文结果分开判断。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
剩余时间-	本次实时追踪距离自动结束还有多久。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
时间线数量-	当前对象已经聚合出的可读事件数量。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
来源证据-	说明这条结论依据哪个运行来源。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
重点问题-	需要优先查看的异常或身份问题数量。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
采集模式-	Live 表示正在采集，Standby 表示只读已有证据。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
读取时间线
发生时间-	事件进入追踪时间线的时间，用于与 FMQX 设备时间对齐。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
阶段-	说明事件位于连接、上报、解析、输出还是恢复阶段。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
事件类型-	运行时原始事件的稳定类型，用于精准定位。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
流向状态-	说明后续链路是否已捕获、等待或缺少证据。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
阶段筛选-	只改变当前列表范围，不删除证据。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
核对协议上下文
来源证据-	说明这条结论依据哪个运行来源。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
协议上下文-	MQTT 使用 Topic 与 QoS；本例订阅功能下行 Topic，设备端完成一次收发自检。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
来源时间-	证据产生的时间，用于核对是否属于本次操作。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
查看全部来源证据-	展开当前对象全部来源，不改变运行状态。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
读取完整报文追踪
链路类型-	说明当前对比的是设备上报与 MQ 转发，还是一次设备命令或 Modbus 轮询。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
事件时间-	当前选中事件发生的时间，应与设备侧发送或回复时间接近。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
设备上报状态-	已捕获表示平台保留了设备进入 FMQ 的原始报文；非上报事件不代表通信失败。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
平台规则或连接器状态-	说明当前事件是否找到了匹配的上行规则和连接器流向证据。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
MQ 转发状态-	已转发表示连接器已经提交；等待或未捕获时继续检查规则与连接器。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
链路结论-	链路完整只证明追踪已看到设备报文和转发证据，业务系统是否消费仍需单独确认。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
设备协议-	设备上报卡中的协议，应与当前追踪对象一致。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
来源 Topic 或地址-	MQTT 显示 Topic，TCP 显示远端地址，Modbus TCP 显示轮询端点或响应线索。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
设备事件类型-	平台记录的原始事件类型，用于区分连接、上报、解析和回复。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
运行节点-	处理这条报文的 FMQ 节点，用于排查集群节点差异。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
traceId-	设备侧事件的关联标识，用于和日志、规则或下游记录交叉核对。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
设备原始报文-	设备进入 FMQ 时保留的原始 Payload 或十六进制帧，是判断设备实际发送内容的依据。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
输出目标-	说明这条上行消息准备投递到哪个连接器或外部目标。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
投递地址-	展示 Topic、Exchange/RoutingKey 或其他实际投递地址，用于核对目标是否选对。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
flowId-	一次平台转发过程的关联标识，用于把各处理阶段串成同一条链路。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
MQ 转发报文-	平台经过规则处理后交给连接器的消息体，可与设备原始报文对照字段变化。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
转发过程与耗时-	展开后按阶段显示规则匹配、动作提交和连接器执行时间；失败时先找第一个异常阶段。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
技术字段-	展开后列出报文、节点、异常和关联标识，供实施和研发进一步定位。	MQTT 设备 ↔ FMQ	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
理解诊断与协议动作
诊断结论-	对当前选中事件的通俗结论。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
可能原因-	平台根据现有证据列出的排查方向，不代表已经确认根因。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
建议动作-	与当前事件、协议和会话上下文匹配的下一步。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
动作条件-	发送测试指令、重试最近下发和断开会话只对当前在线 MQTT 会话生效；断开后必须由设备重新连接。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
识别异常与恢复事件
异常时间-	故障或断开被记录的时间。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
异常阶段-	说明失败发生在连接、发送、等待回复、解析或输出。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
异常原因-	本次可观察到的错误或离线原因。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
恢复后新事件-	FMQX 主动断开并重连后再次上报，新的 TRANSPORT_MESSAGE 出现在时间线中。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
确认恢复状态
当前结论-	基于最新证据形成的当前判断。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
历史异常-	已保留的旧故障记录；出现历史异常不代表当前仍失败。	页面运行状态	可以保留旧记录；应同时出现恢复后的新证据。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
恢复信号-	FMQX 主动断开并重连后再次上报，新的 TRANSPORT_MESSAGE 出现在时间线中。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。
下一检查点-	当前证据不足时，建议优先核对的位置。	页面运行状态	与本次设备操作时间、对象身份和协议一致。	数据为空、时间不属于本次操作、协议不一致，或页面提示等待但设备已执行。第一检查点：先核对对象标识和追踪是否开启，再让 FMQX 产生一条新数据并刷新。

FMQX MQTT 会话

完整参考

字段/控件	用途说明	默认/推荐/示例	选项说明	作用与影响	生效条件
连接/重新连接	在 FMQX 建立当前协议的真实设备会话。	默认：—推荐：—示例：—	不适用	在 FMQX 建立当前协议的真实设备会话。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
发送	从 FMQX 向 FMQ 发送真实设备数据。	默认：—推荐：—示例：—	不适用	从 FMQX 向 FMQ 发送真实设备数据。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要

设备追踪工作台

完整参考

字段/控件	用途说明	默认/推荐/示例	选项说明	作用与影响	生效条件
打开追踪对象	解析输入标识并进入对应追踪详情。	默认：—推荐：—示例：—	不适用	解析输入标识并进入对应追踪详情。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
状态/协议筛选	缩小工作台列表范围，不改变追踪状态。	默认：—推荐：—示例：—	全部：全部；仅显示全部范围。未开始：未开始；仅显示未开始范围。追踪中：追踪中；仅显示追踪中范围。已结束：已结束；仅显示已结束范围。MQTT：MQTT；仅显示MQTT范围。	缩小工作台列表范围，不改变追踪状态。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
删除	从工作台移除当前对象；活动对象会同时关闭追踪。	默认：—推荐：—示例：—	不适用	从工作台移除当前对象；活动对象会同时关闭追踪。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
清空列表	清空工作台对象并关闭其中仍在活动的追踪。	默认：—推荐：—示例：—	不适用	清空工作台对象并关闭其中仍在活动的追踪。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
查看详情	打开当前对象的追踪详情。	默认：—推荐：—示例：—	不适用	打开当前对象的追踪详情。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要

MQTT 追踪详情

完整参考

字段/控件	用途说明	默认/推荐/示例	选项说明	作用与影响	生效条件
返回工作台	返回设备追踪工作台。	默认：—推荐：—示例：—	不适用	返回设备追踪工作台。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
开启/关闭追踪	开启十分钟实时采集或停止继续采集；已展示证据保留。	默认：—推荐：—示例：—	不适用	开启十分钟实时采集或停止继续采集；已展示证据保留。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
下载证据包	下载当前对象的文本证据，供线下排查。	默认：—推荐：—示例：—	不适用	下载当前对象的文本证据，供线下排查。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
刷新	立即重新读取当前对象的最新状态和证据。	默认：—推荐：—示例：—	不适用	立即重新读取当前对象的最新状态和证据。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
AI 深度追踪	当前为预留入口，不代表已经执行 AI 诊断。	默认：—推荐：—示例：—	不适用	当前为预留入口，不代表已经执行 AI 诊断。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
详情页全局搜索	输入其他对象标识后切换追踪对象。	默认：—推荐：—示例：—	不适用	输入其他对象标识后切换追踪对象。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
时间线筛选	按阶段或轮询状态缩小时间线范围。	默认：—推荐：—示例：—	设备上线：设备上线；仅显示设备上线范围。设备离线：设备离线；仅显示设备离线范围。数据上报：数据上报；仅显示数据上报范围。数据解析：数据解析；仅显示数据解析范围。消息输出：消息输出；仅显示消息输出范围。异常与恢复：异常与恢复；仅显示异常与恢复范围。	按阶段或轮询状态缩小时间线范围。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
事件证据	查看选中事件的来源和上下文。	默认：—推荐：—示例：—	不适用	查看选中事件的来源和上下文。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
报文追踪	查看原始报文、流向和处理层级。	默认：—推荐：—示例：—	不适用	查看原始报文、流向和处理层级。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
综合诊断	查看结论、原因和建议动作。	默认：—推荐：—示例：—	不适用	查看结论、原因和建议动作。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
查看全部来源证据	展开当前对象的全部来源证据。	默认：—推荐：—示例：—	不适用	展开当前对象的全部来源证据。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
发送测试指令	向当前MQTT会话发送一次测试数据；只有可执行会话存在时出现。	默认：—推荐：—示例：—	不适用	向当前MQTT会话发送一次测试数据；只有可执行会话存在时出现。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
重试最近下发	重发最近一条可安全重放的下行消息；没有可重放消息时不出现。	默认：—推荐：—示例：—	不适用	重发最近一条可安全重放的下行消息；没有可重放消息时不出现。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要
断开会话	断开当前运行会话，设备需要自行重新连接。	默认：—推荐：—示例：—	不适用	断开当前运行会话，设备需要自行重新连接。	范围：当前追踪对象发布：不需要 · 重启：不需要 · 重连：不需要

常见问题

FastBee 的设备追踪怎么定位一台 MQTT 设备？

进入追踪 → 设备追踪，输入客户端 ID、IP、设备编号、deviceKey、sessionId 或完整追踪键，打开同一个追踪对象即可开始查看证据。

设备追踪开启后会采集多长时间？

开启追踪进行十分钟实时采集，页面每三秒自动刷新；关闭追踪只停止继续采集新事件，已展示的证据保留，还可以下载证据文本用于交接排查。

追踪详情里的风险结论就是最终故障原因吗？

不是。风险结论是平台根据当前证据给出的排查优先级，不等同于最终故障原因，需要结合事件证据、报文追踪和综合诊断继续确认。

这里的 FMQX 和 MQTTX 是同一个工具吗？

不是。FMQX 是 FastBee 自研客户端工具，与第三方 MQTTX 不同；本篇用 FMQX 建立 MQTT 会话并产生真实上行数据。

生产操作提示

截图和示例用于说明操作位置与判断方法，不代表当前生产状态。涉及发布、启停、重绑、重试或删除时，应先确认目标环境、影响范围和恢复方案，并由授权人员执行。

蜂信物联（FastBee） · FMQ 操作手册