One-click Driver Log Collection Tool
The one-click driver log collection tool is deployed on the host and can collect logs with one click.
- This section applies only to NPU 22.0.0 or later.
- This tool does not support container scenarios and cannot be run by multiple users at the same time.
- This tool must be run by the root user.
- The system does not automatically delete log files. To prevent log files from occupying drive space, you are advised to manually delete them after downloading them.
Procedure
- Log in to the host server.
- Obtain the one-click driver log collection tool.
The tool is in the driver_installation_directory/driver/tools/npu_log_collect.sh directory.
- Run the following command in the directory with the read, write, and execute permissions to run the one-click driver log collection tool:
Command: driver_installation_directory/driver/tools/npu_log_collect.sh [options]
Example: /usr/local/Ascend/driver/tools/npu_log_collect.sh
Table 10-151 lists the available command-line options.
Table 10-151 OptionsOption
Description
Example Value
None
Exports the collected default content in the execution directory.
driver_installation_directory/driver/tools/npu_log_collect.sh
--h or --help
Displays help information.
driver_installation_directory/driver/tools/npu_log_collect.sh -h
-p or --path
Specifies the directory of the generated file. The user must have the read, write, and execute permissions on the directory.
driver_installation_directory/driver/tools/npu_log_collect.sh -p /home/tmp/
--off
Disables the function of collecting specified content.
host_info: host environment information.
host_log: host log information.
device_log: full logs on the device side.
driver_info: driver running information.
install_info: driver installation information.
driver_installation_directory/driver/tools/npu_log_collect.sh --off host_info
After the execution is successful, a compressed file npu_log_collect_YYYYMMDDhhmmss.tar.gz is generated in the current path to store log information. The file name extension is the timestamp when the log collection is complete. Decompress the file to obtain the log storage directories and files shown in Table 10-152.
Table 10-152 Log storage directories and filesLog Storage Directory and File
Description
collect_scripts_running_log
Run logs of the log collection script.
mcu_log
MCU logs.
npu_info_log
NPU status information.
nputools_log
Run logs of the npu-smi tool.
ascend_log_YYYYMMDDhhmmss.tar.gz
Run logs of the Ascend AI Processor. The file name extension is the timestamp when the tool is invoked. For details about the directories and files obtained after the decompression, see Table 10-153.
Table 10-153 Decompressed directories and files of the Ascend AI Processor run logsLog Directory and File
Description
host_info
Host environment information.
host_log
Host log information.
device_log
Full logs on the device side.
driver_info
Driver running information.
install_info
Driver installation information.
script_running.log
Run logs of the tool.