收集日志

日志相关参数说明参见表1。日志参数(如配置的文件名、参数等)仅支持大小写字母、数字和特殊字符(-._,/=)的组合。基于安全性考虑,表1涉及的路径需要所在组织的安全要求。

表1 参数说明

参数

说明

是否必选

--output-file=<FILENAME>

指定收集日志的输出路径和输出文件的名称,文件的扩展名建议为.tar.gz。不指定“--output-file”参数时,默认在当前路径生成名称为ascend-report-<hostname>-<YYYYMMDDhhmmss>.tar.gz的文件。只指定输出文件的名称,不指定输出路径时,默认在当前路径生成指定名称的文件。收集日志的输出路径请勿含有大量其他文件。

--safe

调用ascend-dmi工具执行设备健康状态检查,此时不会执行功耗测试。如需了解ascend-dmi的更多信息,执行命令ascend-dmi -h

此选项默认开启。

--extra

调用ascend-dmi工具执行全部检查项的检查。此时执行功耗测试,会引起AI core占用率增加和芯片温度升高,收集结束后恢复正常。如需了解ascend-dmi的更多信息,执行命令ascend-dmi -h

--modules=<MODULE>[,<MODULE>]…

指定信息收集的模块,多个模块之间用逗号分隔。可选的模块有:system、ascend和mindx。指定模块与收集文件的对应关系请参见表2

默认收集所有模块,等同module=all,但是要带额外参数的文件必须要指定参数才会收集。

--ascend-path=<PATH>

指定昇腾软件安装路径,默认为“/usr/local/Ascend”。在Atlas 500 智能小站中若使用--extra参数,则必须配置--ascend-path=/opt/ascend/用于指定CANN安装路径。

--user=<USERNAME>

指定收集CANN日志的用户。该参数步骤仅支持root用户使用,且不支持在Atlas 200 AI加速模块(RC场景)上使用。

此参数与“--user-log”互斥,不可同时使用。“--user”和“--user-log”都不指定时,默认收集当前用户的用户态日志,路径为“$HOME/ascend/log”“/var/log/ascend_seclog”

说明:

“--user”和“--user-log”,推荐使用“--user”。

--user-log=<USERLOG>

指定收集CANN日志的目录位置,支持指定的目录为“/root/ascend/log”或“/home/xxx/ascend/log”。该参数仅支持root用户使用,且不支持在Atlas 200 AI加速模块(RC场景)上使用。

此参数与“--user”互斥,不可同时使用。“--user”和“--user-log”都不指定时,默认收集当前用户的用户态日志,路径为“$HOME/ascend/log”“/var/log/ascend_seclog”

说明:

“--user”和“--user-log”,推荐使用“--user”。

--sdk-log-path=<PATH>

指定收集SDK日志的目录,请用户输入生成的SDK日志的实际存放路径。

建议指定为需要收集日志所在的最小目录,否则指定目录过大,将会收集该目录下的所有可读文件,包含很多冗余信息。

表2 模块与文件对应关系

modules

收集的文件

备注

system

system-report.log.gz。

-

ascend

ascend-report.log.gz、ascend_user_log.tar.gz、device_log.tar.gz、ascend_user_install_log.tar.gz、YYYY-MM-DD-HH-MM-SS文件夹。

  • 昇腾软件日志存在,才会收集并生成ascend_user_log.tar.gz。
  • Device的系统级日志存在,才会收集并生成YYYY-MM-DD-HH-MM-SS文件夹。

mindx

alog.tar.gz、plog.tar.gz、mindx_sdk_info_*.tar.gz。

边缘设备的日志存在,才会收集并生成alog.tar.gz、plog.tar.gz;指定了需要收集的SDK日志的路径,才会收集并生成mindx_sdk_info_*.tar.gz。

使用实例