参数说明

[-h, --help]

查看ascend-log-collect.sh脚本帮助信息。

是

[-v, --version]

查看ascend-log-collect.sh脚本版本信息。

是

--output-file=<FILENAME>

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

否

--safe

调用Ascend DMI工具执行设备健康状态检查，此时不会执行功耗测试。

此选项默认开启。

否

--extra

调用Ascend DMI工具执行全部检查项的检查，仅当--modules取值为ascend或不指定--modules时，--extra参数才生效。此时执行功耗测试，会引起AI core占用率增加和芯片温度升高，收集结束后恢复正常。

否

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

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

指定--modules=all时，上述可选模块均进行收集。

否

--ascend-path=<PATH>

指定已安装的昇腾软件路径，收集安装软件的版本信息，默认为“/usr/local/Ascend”。

否

--user=<USERNAME>

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

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

否

--user-log=<USERLOG>

指定收集CANN日志的目录位置。该参数仅支持root用户使用，且不支持在Atlas 200 AI加速模块（RC场景）和Atlas 200I SoC A1 核心板上使用。

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

否

--sdk-log-path=<PATH>

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

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

否

--mindie-log-path=<MINDIELOGPATH>

用于指定MindIE日志路径，收集MindIE日志。默认/var/log/ascend_log/app_log/mindie。

否

[-q, --quiet]

指定该参数，将不再进行防呆提示，用户将默认允许该操作。只有收集ascend模块日志，且指定了--extra参数时，-q参数才生效。

否

system

system-report.log.gz。

-

ascend

ascend-report.log.gz、npu_log_collect_YYYYMMDDhhmmss.tar.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。