日志中心
大约 2 分钟
日志中心
平台从多个维度记录设备与消息的日志,用于运行监控与故障排查。设备侧排错时,建议与故障排查章节配合使用。
云端运行日志
记录平台处理设备消息的全过程,是排查「上报了但没数据」类问题的第一入口。
- 搜索条件:产品、deviceName、追踪 ID(traceId)、消息内容、业务类型(bizType)、操作、结果状态(成功 200 / 失败 0)、时间范围。
- 记录内容(bizType):
| 业务类型 | 记录内容 |
|---|---|
| 设备行为 | 上线 / 下线事件(content 含 clientId、clientIp、下线原因) |
| 上行消息 | 设备发布的消息接收记录 |
| 订阅 / 取消订阅 | 设备的订阅行为 |
| 物模型 | 属性 / 事件逐项校验结果:未定义的标识符(5092 / 2009000000)、类型不符(6308)、缺少 params(6208)等只写在此处 |
| ERROR | 处理异常与未知错误 |
注意
属性/事件上报回复的 code:200 只代表平台收到消息;逐属性的校验失败结果只记录在云端日志的「物模型」类型中,排查数据未入库问题时请到此按设备与时间筛选。
设备调试(消息流水)
入口:设备详情 → 设备调试页签。包含两部分:
- 消息流水:该设备上下行消息的卡片式列表(Topic、时间、payload),支持自动刷新与滚动加载,便于实时观察报文。
- 模拟发送:选择设备已订阅的 Topic、QoS 0/1/2、JSON 或 HEX 格式,向设备下发任意报文,用于验证设备的订阅与解析逻辑(走 EMQX REST 真实下发)。
设备本地日志
设备固件通过 /sys/{pk}/{dn}/thing/log/post 上报的日志,展示:时间、模块、追踪标识(traceContext)、代码、日志级别、日志内容。
- 入口:物联网 > 本地日志(独立页)或 设备详情 → 本地日志页签。
- 支持按模块、追踪标识、代码、日志级别、时间筛选,可导出,也可手动新增(模拟上报)。
- 设备端开启本地日志上报的说明见诊断、日志、信号与位置。
其他说明
- 诊断日志(信号强度 / 网络诊断)当前由平台内部记录(保留 30 分钟,供设备信息页 RSSI 展示),暂未提供独立查询页面。
- 消息流水与云端日志按时间存储,排查跨天问题时注意调整时间范围。