查看运行日志(旧版)
华为云物联网平台支持记录平台与设备端,周边应用系统之间的对接情况,并以日志的形式上报到云日志服务(LTS),由LTS提供实时查询、海量存储、结构化处理和可视化图表分析能力,LTS每月免费赠送500M额度,超过后按需收费。LTS服务介绍和计费说明参见云日志服务LTS。
目前仅支持记录MQTT设备的业务运行日志,详细请参考下表。
业务类型 |
业务流程 |
---|---|
设备状态 |
|
设备下线 |
|
设备消息 |
|
设备命令 |
|
设备属性 |
|
设备事件 |
|
物联网平台接收设备下载升级包的事件 |
|
批量任务 |
批量任务的子任务执行结果,详细请参考表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 |
字段 |
说明 |
---|---|
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 运行日志-旧版配置日志开关
- 创建运行日志转发规则,将采集的日志数据转发到其他云服务,以便您查看和处理,建议把日志数据转发至云日志服务LTS。以下以转发到云日志服务为例。
- 选择左侧导航栏的“创建规则”。 ,单击
- 参考下表参数说明,填写规则内容,填写完成后单击“创建规则”。
表4 创建规则 参数名
参数说明
规则名称
创建的规则名称。
规则描述
对该规则的描述。
数据来源
选择“运行日志”
触发事件
选择数据来源后,自动匹配触发事件。
资源空间
您可以选择单个资源空间或所有资源空间。
- 单击“设置转发目标”页签,单击“添加”,设置转发目标。
表5 设置转发目标 参数名
参数说明
转发目标
选择“云日志服务(LTS)”
区域
当前仅支持转发至同区域的云日志服务。
日志组/日志流
云日志服务创建的日志组默认存储时间为7天,超出存储时间的日志将被自动删除,您可以按需将日志数据转储至OBS桶中长期存储,具体步骤参考日志转储至OBS。
云日志服务每月免费赠送500M额度,默认超额继续采集,超过的部分按需收费,如果您需要关闭超额继续采集开关,登录云日志服务管理控制台,单击"配置中心"进行修改。
- 单击“确定”,然后单击“启动规则”,实现运行日志转发至云日志服务。
- 登录云日志服务管理控制台,单击“日志管理”。
- 选择3创建的日志组和日志流,查看IoTDA上报的日志信息。可参考搜索日志,对原始日志进行搜索,搜索目标日志。例如可以按照设备Id和业务类型搜索。
图3 运行日志-查看日志列表
图4 运行日志-搜索运行日志
- 在日志流详情页面,单击“日志分析”,进入日志结构化配置页面,单击“JSON”。
图5 运行日志-日志分析
- 在选择示例日志页面,选择一条示例日志,日志结构依次为时间、设备ID、请求ID、业务类型、操作、请求参数、结果信息、执行状态。单击“智能提取”,修改智能提取的字段名称,如:recordTime、requestId、deviceId、categoryName、operation、request、response、result,修改字段类型为string。单击“保存”,完成日志的结构化配置,具体操作方法可参考结构化日志。
图6 运行日志-配置结构化
- 对原始日志结构化后,触发响应业务。在“日志管理”页面,选择3创建的日志组和日志流,单击“日志分析”,即可查看结构化之后的日志。可对日志进行SQL查询。例如按照设备Id和业务类型查询:select * where deviceId = '{{deviceId}}' and categoryName = 'device.status'
图7 运行日志-日志分析搜索