我要评分

文档获取效率

文档正确性

内容完整性

文档易理解

在线提单

论坛求助

子命令及参数说明

支持全量信息采集显示和单个模块采集显示，可对内存插法进行识别推荐，存在多份报告时可对比分析；对可能存在问题的部分将提供诊断意见和现象描述。

直接使用“kspect 子命令”可查看该子命令模块的全部信息（cpu子命令不支持）。

表1 子命令功能简介
子命令	说明
system	显示全部系统信息，包括服务器、厂商和主板等信息。
os	显示操作系统信息，包括操作系统名称、版本、内核版本和开机启动参数。
bios	显示BIOS信息，包括启动类型、缓存模式、PCIe速率等。此特性需用户具有ipmitool运行权限或配置BMC（需输入账号和密码）方式获取。
software	显示软件信息，包括BIOS、操作系统和软件版本等。
cpu	显示CPU信息，包括型号、CPU列表等。
numa	显示NUMA信息，包括CPU、内存、PCIe、网络和nvme等。
memory	显示内存信息，包括内存信息和DIMM等。
network	显示网络信息，包括网络驱动、网络中断等信息。
storage	显示存储信息，包括硬盘信息和分区信息等。
pcie	显示PCIe信息，包括PCIe驱动信息和PCIe的IRQ信息。
ascend	显示昇腾NPU信息，包括npu-smi、ascend-dmi等。
bmc	显示使用BMC方式获取的信息。注：此功能需用户具有ipmitool使用权限或配置BMC信息（包括BMC的IP地址，用户名和密码），不输入BMC相关信息将不采集SEL日志信息。
config	检查和展示各个模块的依赖关系。
all	显示系统的全量信息，包含所有软硬件信息（部分信息需配置BMC才可采集）。
report	显示历史报告或分析报告差异。

表2 kspect命令参数
参数	参数选项	参数说明
-h/-H/--help	-	获取帮助信息。
-L	0/1/2/3/4	设置日志级别，默认为4。 0：日志级别为DEBUG。 1：日志级别为INFO。 2：日志级别为WARNING。 3：日志级别为ERROR。 4：日志级别为NOTSET。
-l/--language	0/1	设置报告语言类型，默认为1；若环境不支持中文将以选项0（英文）展示。 0：英文 1：中文
--remote	-	指定是否开启收集远程节点信息。工具将传输到远程节点的/tmp目录下。采集完成后，该工具将被删除。该功能需要获取远程节点的SSH登录信息，包括IP地址、端口（格式为“IP:port”，不输入端口号默认使用22）、用户名和密码。
-s/--skip-bmc	-	跳过配置BMC信息的步骤，默认使用ipmitool采集。
-c/--bmc-command	-	执行用户自定义BMC信息采集命令。

表3 system子命令参数
参数	参数选项	参数说明
-h/--help/-H	-	获取帮助信息。
-o/--host	-	显示主机名和服务器时间、操作系统、主板和机箱信息等。
-p/--product	-	显示产品名、版本、序列号和UUID。
-b/--baseboard	-	显示主板厂商、产品名、版本和序列号等。

表4 software子命令参数
参数	参数选项	参数说明
-h/--help/-H	-	获取帮助信息。
-s/--software_version	-	显示软件版本信息。
-k/--kvm	-	显示KVM信息。
-d/--docker	-	显示Docker信息。

表5 cpu子命令参数
参数	参数选项	参数说明
-h/--help/-H	-	获取帮助信息。
-G/--general	-	显示CPU的全量信息。
-c/--cpu	n n,m n-m all	显示指定CPU核的详细信息（CPU核数根据实际动态显示）。参数示例：采集CPU核1，参数输入“-c 1”；采集CPU核0和2，参数输入“-c 0,2”；采集CPU核0到3，参数输入“-c 0-3” 采集全部CPU核，参数输入“-c all”。

表6 memory子命令参数
参数	参数选项	参数说明
-h/--help/-H	-	获取帮助信息。
-G/--general	-	显示内存的全量信息。
-D/--DIMM	-	显示所有插槽（SOCKET，CHANNEL，DIMM）上的内存信息，包括内存插槽的拓扑结构和建议的内存插入方式。

表7 network子命令参数
参数	参数选项	参数说明
-h/--help/-H	-	获取帮助信息。
-n/--nic	-	显示网卡信息。
-i/--irq	-	显示网络IRQ映射信息。
-T/--tuner	-	显示网卡调优信息。
-r/--route	-	显示路由信息。
-a/--arp	-	显示ARP信息。

表8 storage子命令参数
参数	参数选项	参数说明
-h/--help/-H	-	获取帮助信息。
-d/--disk	-	显示硬盘信息。
-f/--filesystem	-	显示文件系统信息。
-b/--bmc	-	显示bmc里的硬盘信息。

表9 ascend子命令参数
参数	参数选项	参数说明
-h/--help/-H	-	获取帮助信息。
-n/--npu	-	显示NPU拓扑信息。
-d/--dmi	-	显示ascend-dmi基本信息。
-b/--band	-	显示ascend-dmi带宽信息。

**表10** report子命令参数
参数	参数选项	参数说明
-h/--help/-H	-	获取帮助信息，显示报告的历史记录。
-r/--report	报告序号	在历史记录中选择需展示的报告或输入报告路径（支持工具采集报告和使用diff/diff_x86后生成的对比报告），历史记录仅显示最近10个报告。
-d/--diff	0 N N,M <INPUT_PATH> <INPUT_PATH_A>,<INPUT_PATH_B>	选择需对比的两份报告，使用格式如下： 0：生成新的报告，并和上一个报告比较。 N：生成新报告，与历史报告<N>比较。 N,M：比较历史报告<N>和报告<M>。 <INPUT_PATH>：生成新报告并与指定报告比较。 <INPUT_PATH_A>,<INPUT_PATH_B>：比较报告<A>和报告<B>。
--diff_x86	<X86_PATH> N,<X86_PATH> <INPUT_PATH>,<X86_PATH>	选择需要和x86报告对比的报告，当前支持perfspect report --all生成的x86报告（perfspect获取地址：https://github.com/intel/PerfSpect），使用格式如下： <X86_PATH>：生成新报告并与输入的x86报告对比。 N,<X86_PATH>：比较历史报告号<N>和x86报告。 <INPUT_PATH>,<X86_PATH>：比较输入的采集报告和输入的x86报告。
-t/--threshold	非负数值	两份报告相同参数的数值差别程度，用户可自定义，系统默认为20%（输入时无需添加“%”），只支持--diff/--diff_x86。

父主题： 鲲鹏健康检测