Kunpeng Health Inspector Functions
Prerequisites
- You have installed the tool. See Installing a Compressed Package (.tar.gz).
- The tool is contained in an independent package (devkit-kspect-x.x.x-Linux-aarch64.tar.gz). Decompress the package and switch to the tool directory.
Command Function
Collects hardware information such as CPU, memory, NIC, and PCIe data in a lightweight manner, generates health reports and tuning suggestions, and helps detect performance deterioration caused by hardware faults or configuration errors.
- This tool is suited for the Kunpeng hardware. It displays messages for some unsupported data.
- The tool can run on openEuler, CentOS, Debian, and Ubuntu. The OS version must be the same as that supported by the DevKit. For a non-openEuler OS, some fields may be missing when server hardware information is collected.
- OSs with kernel versions 4.19, 5.10, 6.6, and 5.15 are supported.
Syntax
1 | ./kspect [-h] [-L {0,1,2,3,4}] [-l {0,1}] [--remote] [-s] [-c COMMAND] {system,os,bios,software,cpu,numa,memory,network,storage,pcie,ascend,bmc,config,all,report} ... |
Example
1 | ./kspect -l 0 -h |
Command output:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 | NAME Kunpeng Health Inspector USAGE kspect [-h] [-L {0,1,2,3,4}] [-l {0,1}] [--remote] [-s] [-c COMMAND] {system,os,bios,software,cpu,numa,memory,network,storage,pcie,ascend,bmc,config,all,report} ... POSITIONAL ARGUMENTS {system,os,bios,software,cpu,numa,memory,network,storage,pcie,ascend,bmc,config,all,report} Select health check items. system Displays all system information, including the server, vendor, and mainboard information. os Displays the OS name, system version, kernel version, and boot parameters. bios Displays BIOS information, including the boot type, cache mode, and PCIe rate. Note: This feature requires the permission to run ipmitool. Alternatively, configure the BMC information (user name and password) to obtain the complete system information. software Displays software information, including GCC, glibc, Binutils, Python, KVM, and Docker. cpu Displays CPU information, including the CPU model and list. numa Displays NUMA information, including CPUs, memory, PCIe, networks, and NVMe. memory Displays memory information, including common memory information and DIMM information. network Displays network information, including NIC and IRQ information. storage Displays storage information, including drives and partitions. pcie Displays PCIe information, including the PCIe driver and IRQ information. ascend Displays Ascend NPU information, including npu-smi and ascend-dmi. bmc Displays information obtained using the BMC. This function requires the permission to run ipmitool. Alternatively, configure the BMC information (BMC IP address, user name, and password) to obtain the information. If you do not enter the BMC information, SEL logs will not be collected. config Checks and displays the dependency between modules. all Displays full system information. Note: Collecting all information relies on the BMC information (IP address, user name, and password). If you do not provide the BMC information, the IPMItool will be used for the collection, and the report will lack the information about the modules that strongly depend on the BMC. report Display historical reports or analyze the differences between reports. |
Parent topic: Kunpeng Health Inspector