本文档讲述如何远程查看分析设备日志。

背景信息

通过日志来调试分析诊断设备的行为,是我们解决设备问题的基本方式。设备的日志通常是由串口输出的。查看设备日志需要把设备串口连接到开发调试的电脑上。对于已经规模生产,散步到各个地方的IoT设备来说,串口日志分析几乎不可能完成-开发者很难将海量设备的串口都实时监控起来。

为了解决这种问题,AliOS Things通过uAgent模块+运程调试运维控制台的配合,把设备的日志按需上传到了云上,并提供网页帮助开发者分析查看日志。这种方式能方便开发运维人员大规模远程地抓取设备日志,快速高效地分析解决问题。

前置条件

远程查看分析设备日志操作步骤

步骤1. 访问调试运维服务页面,点击需要运维产品的“调试运维”按钮,进入其调试运维页面

步骤2. 在左边的设备列表中,找到你要操作的设备,单击打开其操控页面

Tips: 如果设备数量较多,可以在设备列表上方的搜索框里输入设备名称,来快速找到你要操作的设备。

步骤3. 在操控页面中,点击“远程日志”选项卡,进入远程日志查看分析页面

步骤4. 熟悉远程日志查看分析页面

远程日志页面主要有两个功能区:

  • 日志上报/显示控制区:控制设备的日上报行为;设置日志的显示方式;操作日志的拉取/下载/保存
  • 日志显示/筛选/分析区:提供日志查看/筛选/分析等功能

步骤5. 在页面操控区,控制日志上报 / 显示/保存/拉取等行为

操作A. 调整日志上报等级

点击“调整上报等级”选择框,可以在弹出的下拉列表中选择期望的设备日志上报筛选等级。比如我们选中如下图所示的INFO等级,则设备会上报等级<=INFO(INFO/NOTICE/WARNING/ERROR/CRITICAL/ALERT/EMERGENCY)的所有日志。选择的上报等级数值越大,设备会上报越详细的日志。

操作B. 控制日志持续上报行为

点击“持续上报”开关,可以控制设备是否持续上报日志到运维服务云后台。默认情况下,设备仅在远程日志页面打开时才会上传日志。在远程日志页面退出后,设备即会停止日志上传。如果需要设备持续地上传日志,以便将来拉取分析,请点击开启持续上报功能。开启持续上报后,请注意留意设备的消息流量消耗。

操作C. 控制日志实时更新显示行为

点击“实时更新”开关,可以控制日志的实时刷新行为。受限于浏览器渲染性能,在开启实时更新显示时,页面仅显示收到的最新数条日志,以保证显示的流畅性。如果用户需要查看分析目前收到的所有日志,可以关闭实时更新。关闭实时更新后,最新收到的日志将不会更新到页面。

操作D. 控制日志显示方式

点击“显示原始内容”开关,可以切换日志的显示方式。默认情况下,页面会解析收到的日志,并以下图所示的易读的方式显示出来。如果开发者更习惯阅读分析原始日志,可以打开“显示原始日志”开关,看到如下图所示的原始日志显示。

操作E. 下载保存收到的日志到本地

点击“保存到本地”按键,可以将页面目前收到的所有日志下载保存到本地,以便用其它工具做进一步分析。

操作F. 拉取历史日志

点击“拉取历史日志”按键,可以拉取设备上传的历史日志。您可以拉取选定时间段的日志。对于拉取的日志,您可以选择在当前页面显示分析 或者 保存下载到本地做进一步分析。

步骤6. 在页面日志显示分析区,查看筛选分析设备日志

操作A. 控制日志排序方式
操作B. 筛选日志等级
操作C. 筛选日志来源模块
操作D. 筛选日志来源文件名
操作E. 筛选日志内容