文档首页/ 设备接入 IoTDA/ 用户指南/ 监控运维/ 查看运行日志(旧版)
更新时间:2024-10-10 GMT+08:00

查看运行日志(旧版)

华为云物联网平台支持记录平台与设备端,周边应用系统之间的对接情况,并以日志的形式上报到云日志服务(LTS),由LTS提供实时查询、海量存储、结构化处理和可视化图表分析能力,LTS每月免费赠送500M额度,超过后按需收费。LTS服务介绍和计费说明参见云日志服务LTS

目前仅支持记录MQTT设备的业务运行日志,详细请参考下表。

表1 业务类型

业务类型

业务流程

设备状态

设备上线

设备下线

设备消息

物联网平台接收应用侧下发消息的请求

物联网平台向设备下发消息

物联网平台接收设备上报的消息

设备命令

物联网平台接收应用侧下发设备命令的请求

物联网平台向设备下发命令

物联网平台接收设备回复的命令响应

设备属性

物联网平台接收应用侧修改设备属性的请求

物联网平台向设备修改属性

物联网平台接收设备上报的属性

物联网平台接收网关批量上报的设备属性

设备事件

物联网平台通知网关设备新增的事件

物联网平台通知网关设备删除的事件

物联网平台接收网关同步子设备列表的事件

物联网平台接收网关更新子设备状态的事件

物联网平台接收网关新增子设备请求的事件

物联网平台下发新增子设备请求响应的事件

物联网平台接收网关删除子设备请求的事件

物联网平台下发删除子设备请求响应的事件

物联网平台接收网关更新子设备请求的事件

物联网平台下发更新子设备请求响应的事件

物联网平台下发获取版本信息的事件

物联网平台接收设备上报软固件版本的事件

物联网平台下发升级通知的事件

物联网平台接收设备上报升级状态的事件

物联网平台接收设备上报获取文件上传URL请求的事件

物联网平台下发文件上传临时URL的事件

物联网平台接收设备上报文件上传结果的事件

物联网平台接收设备上报获取文件下载URL请求的事件

物联网平台下发文件下载临时URL的事件

物联网平台接收设备上报文件下载结果的事件

物联网平台接收设备时间同步请求的事件

物联网平台下发时间同步响应的事件

物联网平台接收设备信息上报的事件

物联网平台下发日志收集通知的事件

物联网平台接收设备上报日志内容的事件

物联网平台下发配置的通知的事件

物联网平台接收设备上报配置响应的事件

物联网平台接收设备下载升级包的事件

批量任务

批量任务的子任务执行结果,详细请参考表2 批量任务运行日志格式

设备自注册

设备自动注册的结果,详细请参考设备自注册

设备鉴权

设备自定义鉴权结果,详细请参考自定义鉴权自定义模板鉴权

表2 批量任务运行日志格式

字段

说明

appId

应用ID

deviceId

设备ID

categoryName

日志类型:batch.task

operation

动作,这里为批量任务的task_id,详情参考创建批量任务

request

请求内容,json格式,

{

"task_type" : "createDevices",// 任务类型

"package_id" : "f2303267a6e8f0053037c2a9",//软固件升级包

"package_ids" : ["65f3ebe2682b9f4bcc38baad"] //软固件升级包

}

说明:

当批量任务任务类型为softwareUpgrade或firmwareUpgrade,支持参数package_id和package_ids

response

响应内容,json格式,

成功的场景内容为

{

"output" : "xxxxxxxxxxxx"

}

失败的场景为

{

"error" : {

"error_code" : "IOTDA.XXXXX",

"error_msg" : "XXXXX."

}

}

status

执行结果,这里为子任务的状态,支持Success、Fail、Stopped和Removed

表3 非批量任务格式说明

字段

说明

recordTime

日志采集时间,时间格式为yyyy-MM-dd'T'HH:mm:ss,SSS'Z',

例如:2020-06-16T09:24:45,708Z

deviceId

设备的deviceId

requestId

请求ID

categoryName

对应业务类型:

设备状态:device.status

设备消息:device.message

设备命令:device.command

设备属性:device.property

设备事件:device.event

设备鉴权:device.auth

设备自注册:device.provisioning

operation

对应的操作名称,例如:API url,MQTT消息的Topic。

request

操作的请求参数,例如:API的请求体。

response

操作的结果,例如:API的响应体,错误信息等。

result

操作状态码。

操作步骤

  1. 访问设备接入服务,单击“管理控制台”,进入设备接入控制台。选择您的实例,单击实例卡片进入。
  2. 选择左侧导航栏的监控运维 > 运行日志,单击“配置日志开关”

    图1 运行日志-旧版配置

  3. 在弹出的页面,勾选需要启动采集的业务类型,然后单击“确定”

    图2 运行日志-旧版配置日志开关

  4. 创建运行日志转发规则,将采集的日志数据转发到其他云服务,以便您查看和处理,建议把日志数据转发至云日志服务LTS。以下以转发到云日志服务为例。

    1. 选择左侧导航栏的规则 > 数据转发,单击“创建规则”
    2. 参考下表参数说明,填写规则内容,填写完成后单击“创建规则”
      表4 创建规则

      参数名

      参数说明

      规则名称

      创建的规则名称。

      规则描述

      对该规则的描述。

      数据来源

      选择“运行日志”

      触发事件

      选择数据来源后,自动匹配触发事件。

      资源空间

      您可以选择单个资源空间或所有资源空间。

    3. 单击“设置转发目标”页签,单击“添加”,设置转发目标。
      表5 设置转发目标

      参数名

      参数说明

      转发目标

      选择“云日志服务(LTS)”

      区域

      当前仅支持转发至同区域的云日志服务。

      日志组/日志流

      选择LTS的日志组和日志流,未创建则访问创建日志组创建日志流进行创建。

      云日志服务创建的日志组默认存储时间为7天,超出存储时间的日志将被自动删除,您可以按需将日志数据转储至OBS桶中长期存储,具体步骤参考日志转储至OBS

      云日志服务每月免费赠送500M额度,默认超额继续采集,超过的部分按需收费,如果您需要关闭超额继续采集开关,登录云日志服务管理控制台,单击"配置中心"进行修改。

    4. 单击“确定”,然后单击“启动规则”,实现运行日志转发至云日志服务。

  5. 登录云日志服务管理控制台,单击“日志管理”。
  6. 选择3创建的日志组和日志流,查看IoTDA上报的日志信息。可参考搜索日志,对原始日志进行搜索,搜索目标日志。例如可以按照设备Id和业务类型搜索。

    图3 运行日志-查看日志列表
    图4 运行日志-搜索运行日志

  7. 在日志流详情页面,单击“日志分析”,进入日志结构化配置页面,单击“JSON”。

    图5 运行日志-日志分析

  8. 在选择示例日志页面,选择一条示例日志,日志结构依次为时间、设备ID、请求ID、业务类型、操作、请求参数、结果信息、执行状态。单击“智能提取”,修改智能提取的字段名称,如:recordTime、requestId、deviceId、categoryName、operation、request、response、result,修改字段类型为string。单击“保存”,完成日志的结构化配置,具体操作方法可参考结构化日志

    图6 运行日志-配置结构化

  9. 对原始日志结构化后,触发响应业务。在“日志管理”页面,选择3创建的日志组和日志流,单击“日志分析”,即可查看结构化之后的日志。可对日志进行SQL查询。例如按照设备Id和业务类型查询:select * where deviceId = '{{deviceId}}' and categoryName = 'device.status'

    图7 运行日志-日志分析搜索