日志相关参数说明参见表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日志的实际存放路径。 建议指定为需要收集日志所在的最小目录,否则指定目录过大,将会收集该目录下的所有可读文件,包含很多冗余信息。 |
否 |
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文件夹。 |
|
mindx |
alog.tar.gz、plog.tar.gz、mindx_sdk_info_*.tar.gz。 |
边缘设备的日志存在,才会收集并生成alog.tar.gz、plog.tar.gz;指定了需要收集的SDK日志的路径,才会收集并生成mindx_sdk_info_*.tar.gz。 |