云端运行日志

更新时间:2024-09-08 13:29:49下载pdf

云端运行日志是物联网平台运维监控的核心组成部分,包含云端、设备、APP等多端之间交互通信记录。通过日志记录的消息内容、业务类型、操作类型、状态码等信息,可以了解设备状态、通信情况,并定位操作失败原因。

日志业务类型说明

上行消息的日志业务类型如下图所示。
云端运行日志

1、物联网平台接收设备上报数据,并打印设备到物联网平台的消息日志,包含消息的Topic。
2、对于数据处理的不同业务模块,分别打印各模块的日志。
3、如果消息通过服务端订阅(AMQP、KAFKA),对外发送给客户,将打印务端订阅模块的日志。

下行消息的日志业务类型如下图所示。
云端运行日志
1、用户通过API调用产生消息,打印API调用日志,包含API名称。
2、对于数据处理的不同业务模块,分别打印各模块的日志。
3、如果有消息发送到设备侧,物联网平台打印云端到设备的消息日志,包含消息的Topic。

查询云端运行日志
1、登录物联网平台控制台。
2、在左侧导航栏,选择监控运维>日志服务,进入日志服务页面
3、输入搜索条件,然后单击搜索按钮

搜索条件 说明
时间 选择要查询日志的时间范围。
业务类型 选择要查询日志所属业务类型。
状态 查询某种结果状态的日志。可选择:全部状态,成功:状态码为200,失败:其他状态码。
设备ID 输入设备ID。根据设备ID,搜索该设备的相关日志。
TraceID 输入追踪ID,搜索串联模块日志。
内容关键字 输入消息内容关键字,根据消息内容关键字检索相关内容
MessageId 消息ID,物联网平台为消息生成的唯一标识符。仅上、下行消息分析支持根据MessageID搜索日志。

日志字段说明
日志中包含的字段说明如下表

参数 含义 备注
时间 日志打印时间 无。
TraceId 追踪ID,可用于搜索串联模块。 无。
MessageID 消息ID。 无。
消息内容 消息内容。 无。
设备ID 设备ID。 无。
业务类型 OTA升级、物模型、设备行为、设备到云消息、云到设备消息、API调用、服务端订阅、订阅、取消订阅、安全隧道、其他 。 无。
操作 显示相应的操作名称、API名称、服务的method或消息的Topic 业务二级区分符。
状态 结果码。200表示成功,其他表示失败。API调用产生的错误码请参见错误码,其他错误码请参见下文。 无。

设备行为错误码

错误码 含义 原因 排查
200 OK 无。
acl_fail 无权限 鉴权失败。 查看授权数据
auth_fail 认证失败 认证失败 查看认证数据
push_mqtt_fail 推送MQTT消息失败 推送消息失败 查看应用日志