【CANN文档速递15期】了解与使用日志

01 了解日志分类及产生流程

根据工程运行过程中日志产生的场景不同，日志通常被分为以下两类：

√ 应用类日志：用户进程在Host侧和Device侧产生的日志。例如，一个推理/训练任务下发后，通常与本次推理/训练直接相关的日志都存放在应用类日志中。

√ 系统类日志：非用户进程在Device侧产生的日志，即Device侧常驻进程运行产生的日志通常都在存放在系统类日志中。

 

上述两类日志在系统中产生过程如图所示：

02 如何获取日志文件

当运行工程出现异常时，需要到哪里查看日志呢？本节来揭秘。

昇腾AI处理器具有EP和RC两种形态，针对不同的硬件形态，日志文件存放位置不同，需根据实际硬件形态获取。

▶ EP场景日志获取

√ 应用类日志

这类日志默认存放在“$HOME/ascend/log”路径下，格式如下：

log
├── plog
│   └── plog-pid_*.log     //用户进程在Host侧产生的日志  
└── device-id
    └──device-pid_*.log    //用户进程在Device侧产生的日志

样例：

√ 系统类日志

这类日志生成时默认存放在Device侧/var/log/npu/slog路径下，需要在Host侧通过msnpureport工具将其导出到Host侧再进行查看。命令举例：

$Driver_HOME/driver/tools/msnpureport -a

通过msnpureport工具导出到Host侧后，日志按Device侧文件夹存放，格式如下：

dev-os-id
├── device-os
│   └── device-os_*.log         // Device侧Control CPU上的系统类日志
├── device-id
│   └── device-id_*.log         // Device侧非Control CPU上的系统类日志
└── slogd
    └──slogdlog                       //日志工具自身的运行日志

slog
├── device-os
│   └── device-os_*.log
├── device-id
│   └── device-id_*.log
├── device-app-pid
│   └── device-app-pid_*.log
└── slogd
    └── slogdlog

日志内容严格按照日志规范打印，每条日志格式一致、字段含义明确，便于阅读。日志格式、字段含义如下：

日志内容可以通过cat、grep等命令查看。

04 如何设置日志级别

▶ 日志级别定义

不同日志级别打印的日志内容详细程度不同，因此，问题定位时可以使用最详细日志（DEBUG）打印，而验证性能时使用最简日志（ERROR）打印即可。日志功能提供了5种级别供大家选择使用：

说明

各级别日志详细程度：DEBUG > INFO > WARNING > ERROR

 

▶ 设置日志级别

通过上面日志级别介绍，我们了解到可以根据自己需求设置不同的日志级别、打印不同详细程度的日志。那应该如何设置呢？

√ 应用类日志级别设置，通过在Host侧设置ASCEND_GLOBAL_LOG_LEVEL环境变量实现，例如设置INFO级别：

export ASCEND_GLOBAL_LOG_LEVEL=1

#note, 0:debug, 1:info, 2:warning, 3:error, 4:null(no output log), default(1)
global_level=1
# Event Type Log Flag, 0:disable, 1:enable, default(1)
enableEvent=1
# note, 0:debug, 1:info, 2:warning, 3:error, 4:null(no output log), 5:invalid(follow global_level)
SLOG=5                                     # Slog
IDEDD=5                                    # ascend debug device agent
DVPP=5                                     # DVPP
CCE=5                                      # CCE