设备消息
设备与平台之间的每一次交互都会产生一条消息日志。在项目控制台的左侧导航「维护」中点击「消息日志」,可以按设备查看消息日志,用于排查设备是否上报成功、平台是否回复、上下线是否正常。

支持按设备码、消息类型和时间段筛选。列表中每一行显示时间、设备码、消息类型和消息内容,点击「详情」可查看完整的报文数据。
消息类型
平台按消息类型记录日志,常见的类型包括:
| 类型 | 说明 |
|---|---|
| 1 / 2 | 属性上报 / 属性上报回复 |
| 3 / 4 | 事件上报 / 事件上报回复 |
| 5 / 6 | 属性设置(平台下发)/ 属性设置回复 |
| 7 / 8 | 功能调用(平台下发命令)/ 功能调用回复 |
| 9 / 10 | 连接事件 / 断开连接事件 |
| 11 | 心跳 |
| 12 / 13 | 设备获取平台属性 / 回复 |
| 14 / 15 | 上线 / 下线 |
| 16 / 17 | 属性采集 / 属性采集回复 |
| 18 / 19 | 批量上报 / 批量上报回复 |
| 20 / 21 | 自定义上报 / 自定义下发回复 |
| 22 / 23 | 获取期望值 / 回复 |
| 24 / 25 | 清除期望值 / 回复 |
每一类消息都区分「请求」和「回复」两条日志。设备上报后如果长时间看不到对应的回复日志,通常是设备端没有应答,可以从这里入手排查。
上下线日志
设备的每次上线和下线都会记录:
- 上线:设备与平台建立连接,记录上线时间。
- 下线:设备断开连接,记录下线时间和下线原因,例如设备主动断开、心跳超时、连接被平台踢出等。
频繁出现"心跳超时"下线时,请检查设备网络稳定性或在线超时时间设置(设备类型中的在线超时时间)。
属性消息
设备上报属性后,可以在属性消息中查看本次上报的原始数据,包括属性标识、属性值和时间戳。属性的展示与图表分析请浏览设备详情中的属性页签。
平台向设备下发属性(例如在控制台或 App 中修改可写属性)会产生「属性设置」消息;设备执行后回复「属性设置回复」,其中包含设备返回码,用于判断本次下发是否被设备成功执行。
命令消息
通过控制台或 API 向设备下发命令时,会产生「功能调用」与「功能调用回复」消息。命令消息记录了命令标识、入参和设备返回的出参,是排查设备控制问题的主要依据。
TIP
接口下发属性或命令时,外层接口返回 200 只代表平台已受理;设备是否执行成功,要以「属性设置回复」「功能调用回复」消息中的设备返回码为准。
自定义数据流消息
设备类型开启自定义数据流后,设备上报的自定义数据(JSON / HEX / 文本)会以「自定义上报」类型记录。
