# 查看运行日志（旧版） 华为云物联网平台支持记录平台与设备端，周边应用系统之间的对接情况，并以日志的形式上报到云日志服务（LTS），由LTS提供实时查询、海量存储、结构化处理和可视化图表分析能力，LTS每月免费赠送500M额度，超过后按需收费。LTS服务介绍和计费说明参见[云日志服务LTS](https://support.huaweicloud.com/productdesc-lts/lts-03201.html)。 目前仅支持记录MQTT设备的业务运行日志，详细请参考下表。 表1业务类型 | 业务类型 | 业务流程 | |:---|:---| | 设备状态 | 设备上线：[MQTT设备连接鉴权](https://support.huaweicloud.com/api-iothub/iot_06_v5_3009.html) | | 设备状态 | 设备下线 | | 设备消息 | 物联网平台接收应用侧下发消息的请求：[下发设备消息](https://support.huaweicloud.com/api-iothub/iot_06_v5_0059.html) | | 设备消息 | 物联网平台向设备下发消息：[平台消息下发](https://support.huaweicloud.com/api-iothub/iot_06_v5_3017.html) | | 设备消息 | 物联网平台接收设备上报的消息：[MQTT协议设备消息上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3016.html) | | 设备命令 | 物联网平台接收应用侧下发设备命令的请求：[下发同步设备命令](https://support.huaweicloud.com/api-iothub/iot_06_v5_0038.html) | | 设备命令 | 物联网平台向设备下发命令：[平台命令下发](https://support.huaweicloud.com/api-iothub/iot_06_v5_3014.html) | | 设备命令 | 物联网平台接收设备回复的命令响应：[平台命令下发](https://support.huaweicloud.com/api-iothub/iot_06_v5_3014.html) | | 设备属性 | 物联网平台接收应用侧修改设备属性的请求：[修改设备属性](https://support.huaweicloud.com/api-iothub/iot_06_v5_0035.html) | | 设备属性 | 物联网平台向设备修改属性：[平台设置设备属性](https://support.huaweicloud.com/api-iothub/iot_06_v5_3008.html) | | 设备属性 | 物联网平台接收设备上报的属性：[MQTT协议属性上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3010.html) | | 设备属性 | 物联网平台接收网关批量上报的设备属性：[网关批量属性上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3006.html) | | 设备事件 | 物联网平台通知网关设备新增的事件：[平台通知网关子设备新增](https://support.huaweicloud.com/api-iothub/iot_06_v5_3019.html) | | 设备事件 | 物联网平台通知网关设备删除的事件：[平台通知网关子设备删除](https://support.huaweicloud.com/api-iothub/iot_06_v5_3020.html) | | 设备事件 | 物联网平台接收网关同步子设备列表的事件：[网关同步子设备列表](https://support.huaweicloud.com/api-iothub/iot_06_v5_3021.html) | | 设备事件 | 物联网平台接收网关更新子设备状态的事件：[网关更新子设备状态](https://support.huaweicloud.com/api-iothub/iot_06_v5_3022.html) | | 设备事件 | 物联网平台接收网关新增子设备请求的事件：[网关新增子设备请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_30181.html) | | 设备事件 | 物联网平台下发新增子设备请求响应的事件：[网关新增子设备请求响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_30182.html) | | 设备事件 | 物联网平台接收网关删除子设备请求的事件：[网关删除子设备请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_30183.html) | | 设备事件 | 物联网平台下发删除子设备请求响应的事件：[网关删除子设备请求响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_30184.html) | | 设备事件 | 物联网平台接收网关更新子设备请求的事件：[网关更新子设备状态](https://support.huaweicloud.com/api-iothub/iot_06_v5_3022.html) | | 设备事件 | 物联网平台下发更新子设备请求响应的事件：[网关更新子设备状态响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_30233.html) | | 设备事件 | 物联网平台下发获取版本信息的事件：[平台下发获取版本信息通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_3028.html) | | 设备事件 | 物联网平台接收设备上报软固件版本的事件：[设备上报软固件版本](https://support.huaweicloud.com/api-iothub/iot_06_v5_3029.html) | | 设备事件 | 物联网平台下发升级通知的事件：[平台下发升级通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_3030.html) | | 设备事件 | 物联网平台接收设备上报升级状态的事件：[设备上报升级状态](https://support.huaweicloud.com/api-iothub/iot_06_v5_3031.html) | | 设备事件 | 物联网平台接收设备上报获取文件上传URL请求的事件：[设备上报获取文件上传URL请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_3033.html) | | 设备事件 | 物联网平台下发文件上传临时URL的事件：[平台下发文件上传临时URL](https://support.huaweicloud.com/api-iothub/iot_06_v5_3034.html) | | 设备事件 | 物联网平台接收设备上报文件上传结果的事件：[设备上报文件上传结果](https://support.huaweicloud.com/api-iothub/iot_06_v5_3035.html) | | 设备事件 | 物联网平台接收设备上报获取文件下载URL请求的事件：[设备上报获取文件下载URL请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_3036.html) | | 设备事件 | 物联网平台下发文件下载临时URL的事件：[平台下发文件下载临时URL](https://support.huaweicloud.com/api-iothub/iot_06_v5_3037.html) | | 设备事件 | 物联网平台接收设备上报文件下载结果的事件：[设备上报文件下载结果](https://support.huaweicloud.com/api-iothub/iot_06_v5_3038.html) | | 设备事件 | 物联网平台接收设备时间同步请求的事件：[设备时间同步请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_3040.html) | | 设备事件 | 物联网平台下发时间同步响应的事件：[设备时间同步响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_3041.html) | | 设备事件 | 物联网平台接收设备信息上报的事件：[设备信息上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3042.html) | | 设备事件 | 物联网平台下发日志收集通知的事件：[平台下发日志收集通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_1303.html) | | 设备事件 | 物联网平台接收设备上报日志内容的事件：[设备上报日志内容](https://support.huaweicloud.com/api-iothub/iot_06_v5_1302.html) | | 设备事件 | 物联网平台下发配置的通知的事件：[平台下发配置通知](https://support.huaweicloud.com/api-iothub/iot_0802.html) | | 设备事件 | 物联网平台接收设备上报配置响应的事件：[设备上报配置响应](https://support.huaweicloud.com/api-iothub/iot_0803.html) | | 设备事件 | 物联网平台接收设备下载升级包的事件 | | 批量任务 | 批量任务的子任务执行结果，详细请参考[表2](https://support.huaweicloud.com/usermanual-iothub/iot_01_0030_8.html#ZH-CN_TOPIC_0000001575569149__table17371435153215) | | 设备自注册 | 设备自动注册的结果，详细请参考[设备自注册](https://support.huaweicloud.com/usermanual-iothub/iot_01_0115.html) | | 设备鉴权 | 设备自定义鉴权结果，详细请参考[自定义鉴权](https://support.huaweicloud.com/usermanual-iothub/iot_01_0212.html)，[自定义模板鉴权](https://support.huaweicloud.com/usermanual-iothub/iot_01_0217.html) | 表2批量任务运行日志格式 | 字段 | 说明 | |:---|:---| | appId | 应用ID | | deviceId | 设备ID | | categoryName | 日志类型：batch.task | | operation | 动作，这里为批量任务的task_id，详情参考[创建批量任务](https://support.huaweicloud.com/api-iothub/iot_06_v5_0045.html) | | 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. 访问[设备接入服务](https://www.huaweicloud.com/product/iothub.html)，单击"管理控制台"进入设备接入控制台。选择您的实例，单击实例卡片进入。 2. 选择左侧导航栏的"监控运维 \> 运行日志"，单击"配置日志开关"。 图1运行日志-旧版配置 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001983742069.png "点击放大") 3. 在弹出的页面，勾选需要启动采集的业务类型，然后单击"确定"。 图2运行日志-旧版配置日志开关 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001983902529.png) 4. 创建运行日志转发规则，将采集的日志数据转发到其他云服务，以便您查看和处理，建议把日志数据转发至云日志服务LTS。以下以转发到云日志服务为例。 1. 选择左侧导航栏的"规则 \> 数据转发"，单击"创建规则"。 2. 参考下表参数说明，填写规则内容，填写完成后单击"创建规则"。 表4创建规则 | 参数名 | 参数说明 | |:---|:---| | 规则名称 | 创建的规则名称。 | | 规则描述 | 对该规则的描述。 | | 数据来源 | 选择"运行日志" | | 触发事件 | 选择数据来源后，自动匹配触发事件。 | | 资源空间 | 您可以选择单个资源空间或所有资源空间。 | 3. 单击"设置转发目标"页签，单击"添加"，设置转发目标。 表5设置转发目标 | 参数名 | 参数说明 | |:---|:---| | 转发目标 | 选择"云日志服务（LTS）" | | 区域 | 当前仅支持转发至同区域的云日志服务。 | | 日志组/日志流 | 选择LTS的日志组和日志流，未创建则访问[创建日志组](https://support.huaweicloud.com/usermanual-lts/lts_04_0003.html)和[创建日志流](https://support.huaweicloud.com/usermanual-lts/lts_04_0004.html)进行创建。 | ![](https://support.huaweicloud.com/usermanual-iothub/public_sys-resources/note_3.0-zh-cn.png) 云日志服务创建的日志组默认存储时间为7天，超出存储时间的日志将被自动删除，您可以按需将日志数据转储至OBS桶中长期存储，具体步骤参考[日志转储至OBS](https://support.huaweicloud.com/usermanual-lts/lts_04_0041.html)。 云日志服务每月免费赠送500M额度，默认超额继续采集，超过的部分按需收费，如果您需要关闭超额继续采集开关，登录云日志服务管理控制台，单击"配置中心"进行修改。 4. 单击"确定"，然后单击"启动规则"，实现运行日志转发至云日志服务。 5. 登录[云日志服务管理控制台](https://console.huaweicloud.com/lts/#/cts/manager/groups)，单击"日志管理"。 6. 选择[4.c]创建的日志组和日志流，查看IoTDA上报的日志信息。可参考[搜索日志](https://support.huaweicloud.com/usermanual-lts/lts_05_0005.html)，对原始日志进行搜索，搜索目标日志。例如可以按照设备Id和业务类型搜索。 图3运行日志-查看日志列表 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002039912152.png "点击放大") 图4运行日志-搜索运行日志 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002040071948.png "点击放大") 7. 在日志流详情页面，单击"日志分析"，进入日志结构化配置页面，单击"JSON"。 图5运行日志-日志分析 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002076234241.png "点击放大") 8. 在选择示例日志页面，选择一条示例日志，日志结构依次为时间、设备ID、请求ID、业务类型、操作、请求参数、结果信息、执行状态。单击"智能提取"，修改智能提取的字段名称，如：recordTime、requestId、deviceId、categoryName、operation、request、response、result，修改字段类型为string。单击"保存"，完成日志的结构化配置，具体操作方法可参考[结构化日志](https://support.huaweicloud.com/usermanual-lts/lts_0822.html#section1)。 图6运行日志-配置结构化 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002039919224.png "点击放大") 9. 对原始日志结构化后，触发响应业务。在"日志管理"页面，选择[4.c]创建的日志组和日志流，单击"日志分析"，即可查看结构化之后的日志。可参考[SQL分析](https://support.huaweicloud.com/usermanual-lts/lts_04_0051.html)对日志进行SQL查询。例如按照设备Id和业务类型查询：select \* where deviceId = '***{{deviceId}}*** ' and categoryName = 'device.status' 图7运行日志-日志分析搜索 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000002076243757.png "点击放大")