查看运行日志
华为云物联网平台支持记录平台与设备端，周边应用系统之间的对接情况，并以日志的形式上报到云日志服务（LTS），由LTS提供实时查询、海量存储、结构化处理和可视化图表分析能力，LTS每月免费赠送500M额度，超过后按需收费。LTS服务介绍和计费说明参见云日志服务LTS。
目前仅支持记录MQTT设备的业务运行日志，详细请参考下表。
业务类型 |
业务流程 |
|---|---|
设备状态 |
设备上线 |
设备下线 |
|
设备消息 |
应用侧下发设备消息API |
物联网平台给设备下发消息 |
|
设备给物联网平台上报消息 |
|
设备命令 |
应用侧下发设备命令API |
物联网平台给设备下发命令 |
|
设备属性 |
应用侧修改设备属性API |
设备属性上报 |
|
网关批量上报设备属性 |
|
平台设置设备属性 |
运行日志格式如下表，各字段之间以"|"分割。
字段 |
说明 |
|---|---|
时间 |
日志采集时间，时间格式为yyyy-MM-dd'T'HH:mm:ss,SSS'Z'， 例如：2020-06-16T09:24:45,708Z |
设备Id |
设备的deviceId |
业务类型 |
对应业务类型： 设备状态：device.status 设备消息：device.message 设备命令：device.command 设备属性：device.property |
操作 |
对应的操作名称，例如：API url，MQTT消息的Topic。 |
请求参数 |
操作的请求参数，例如：API的请求体。 |
结果信息 |
操作的结果，例如：API的响应体，错误信息等。 |
执行状态 |
操作状态码。 |
操作步骤
- 访问设备接入服务，单击“管理控制台”，进入设备接入控制台。
- 选择左侧导航栏的，单击“配置日志开关”。
图1 配置日志开关
- 在弹出的页面，勾选需要启动采集的业务类型，然后单击“确认”。
图2 配置日志开关
- 创建运行日志转发规则，将采集的日志数据转发到其他云服务，以便您查看和处理，建议把日志数据转发至云日志服务LTS。以下以转发到云日志服务为例。
- 选择左侧导航栏的，单击“创建规则”。
- 参考下表参数说明，填写规则内容，填写完成后单击“创建规则”。
表3 创建规则 参数名
参数说明
规则名称
创建的规则名称。
规则描述
对该规则的描述。
数据来源
选择“运行日志”
触发事件
选择数据来源后，自动匹配触发事件。
资源空间
您可以选择单个资源空间或所有资源空间。
- 单击“设置转发目标”页签，单击“添加”，设置转发目标。
表4 设置转发目标 参数名
参数说明
转发目标
选择“云日志服务（LTS）”
区域
当前仅支持转发至同区域的云日志服务。
日志组/日志流
云日志服务创建的日志组默认存储时间为7天，超出存储时间的日志将被自动删除，您可以按需将日志数据转储至OBS桶中长期存储，具体步骤参考日志转储至OBS。
云日志服务每月免费赠送500M额度，默认超额继续采集，超过的部分按需收费，如果您需要关闭超额继续采集开关，登录云日志服务管理控制台，单击"配置中心"进行修改。
- 单击“设置完成”，然后单击“启动规则”，实现运行日志转发至云日志服务。
- 登录云日志服务管理控制台，单击“日志管理”。
- 选择3创建的日志组和日志流，查看IoTDA上报的日志信息。可参考搜索日志，对原始日志进行搜索，搜索目标日志。例如可以按照设备Id和业务类型搜索。
图3 查看日志
图4 查看日志
- 在日志流详情页面，单击左侧导航栏的“可视化”，进入日志结构化配置页面，单击“分隔符”，推荐使用“分隔符 | ”作为日志提取方法。
图5 日志可视化
- 在选择示例日志页面，选择一条示例日志，日志结构依次为时间、设备ID、业务类型、操作、请求参数、结果信息、执行状态。选择指定分隔符"|",单击“智能提取”，修改智能提取的字段名称，如：accessTime、deviceId、serviceType、operate、request、response、status，修改字段类型为string。单击“保存”，完成日志的结构化配置，具体操作方法可参考结构化日志。
图6 结构化日志
图7 结构化日志
- 对原始日志结构化后，触发响应业务。在“日志管理”页面，选择3创建的日志组和日志流，单击“可视化”，即可查看可视化之后的日志。可参考SQL分析对日志进行SQL查询。例如按照设备Id和业务类型查询：select * where deviceId = '5ebac4b54d9b0202c5d8ef0c_test_log' and serviceType = 'device.property'
图8 日志可视化
