设备(包括网关和子设备)可以上报日志到云端。您可以在物联网平台控制台日志服务页,查询设备本地日志,进行故障分析。

前提条件

  • 设备已使用Android SDK或C SDK开发完成,并上报日志。具体请参见设备日志上报
  • 如果设备通过SDK开发实现了日志上报开关功能,则需要在设备管理 > 设备的设备列表,单击设备对应的查看按钮,进入设备详情页,开启设备本地日志上报开关;设备未实现日志上报开关功能的,无需开启开关。

查询设备本地日志

  1. 登录物联网平台控制台
  2. 在左侧导航栏,单击监控运维 > 日志服务
  3. 选择产品,选择设备本地日志页签。
  4. 输入搜索条件,然后单击搜索图标。

    支持的搜索条件如下表。

    搜索条件 说明
    DeviceName 输入设备名称。根据设备名称,搜索该设备的相关日志。
    TraceId 输入追踪ID,搜索串联模块日志。
    模块名关键字 输入模块名,搜索该模块产生的日志。
    内容关键字 输入日志内容关键字搜索日志。支持的关键字:ProductKeyDeviceName、结果状态码Code、日志级别LogLevel、模块Module、设备IDIotId、日志内容LogContent、上下文追踪信息TraceContextTraceId的值。
    时间范围 选择要查询日志的上报时间范围。

日志字段说明

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

参数 含义
上报时间 设备端上报日志的时间。
采集时间 设备端采集日志的时间。
TraceId 追踪ID,可用于搜索串联模块。
DeviceName 设备名称。
日志级别 默认显示所有级别的日志,您可以仅查询某一级别的日志。除OTHER级别外,日志级别从高到低为:
  • FATAL
  • ERROR
  • WARN
  • INFO
  • DEBUG
  • OTHER:其他日志级别
模块名 产生日志的模块名称。
  • 当设备端使用Android SDK时,模块名称为ALK-LK。
  • 当设备端使用C SDK时,为自定义的模块名称。
内容 日志内容详情。

设备日志分析

日志内容中包含结果状态码Code。根据结果状态码进行日志分析。
  • 当设备端使用Android SDK时,请参见Android SDK错误码
  • 当设备端使用C SDK时,请参见C SDK状态码
  • 当设备端使用自行开发的SDK时,可以自定义结果状态码,也可以为空。