---
title: 鲲鹏健康检测功能说明
description: "鲲鹏健康检测工具Kspect（曾用名为KHC），能轻量快速收集CPU、内存、网卡、PCIe等硬件信息，输出健康报告及调优建议，排除由于硬件故障或者配置错误导致的性能劣化。支持报告横向对比与自定义基线数据对比，并可交互式完成场景化参数配置。支持基于鲲鹏920和鲲鹏950处理器的服务器，以及部分基于鲲鹏920新型号处理器的服务器。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengdevps/profiler/diagnosis/KunpengDevKitCli_0153.html
sourcePath: /source/zh/kunpengdevps/profiler/diagnosis/KunpengDevKitCli_0153.html
indexId: 481fe32db1dfefa9bcf6bb01ce4fe59ea3e83b7fe1347275f093e9fd8c3a825469
---
# 鲲鹏健康检测功能说明

鲲鹏健康检测工具Kspect（曾用名为KHC），能轻量快速收集CPU、内存、网卡、PCIe等硬件信息，输出健康报告及调优建议，排除由于硬件故障或者配置错误导致的性能劣化。支持报告横向对比与自定义基线数据对比，并可交互式完成场景化参数配置。支持基于鲲鹏920和鲲鹏950处理器的服务器，以及部分基于鲲鹏920新型号处理器的服务器。

#### 前提条件

- 已安装鲲鹏健康检测工具。
- 工具为独立压缩包（devkit-kspect-x.x.x-Linux-aarch64.tar.gz），请解压后切换至工具目录使用。


#### 命令功能

轻量准确的鲲鹏健康检测工具，可快速收集服务器硬件的各类信息，包括CPU、内存、网络、存储、PCIe、虚拟机、传感器、软件和模块依赖等；并给出一定的调优建议。

- 适用于鲲鹏硬件，支持在物理机、虚拟机和容器上使用，一些不支持的数据会给出提示信息（在虚拟机和容器获取到的部分硬件信息可能与物理机信息不一致）。
- 支持openEuler、CentOS、Debian、Ubuntu系列操作系统，操作系统版本与DevKit工具支持的操作系统版本保持一致。使用非openEuler系列的操作系统，在采集服务器硬件信息时可能会导致部分字段缺失。
- 支持4.19、5.10、6.6、5.15内核版本的操作系统。


#### 命令格式

```
./kspect [-h] [-l {0,1,2,3,4}] [-lang {0,1}] [--remote] [-s] [-c COMMAND]{system,os,bios,software,cpu,numa,memory,network,storage,pcie,ascend,ub,bmc,config,cluster,all,report,domain} ...
```


#### 使用示例

```
./kspect -h
```

返回信息如下：

```
NAME
    Kunpeng Health Inspector

USAGE
    kspect [-h] [-l {0,1,2,3,4}] [-lang {0,1}] [--remote] [-s] [-c COMMAND] {system,os,bios,software,cpu,numa,memory,network,storage,pcie,ascend,ub,bmc,config,cluster,all,report,domain} ...

POSITIONAL ARGUMENTS    
    {system,os,bios,software,cpu,numa,memory,network,storage,pcie,ascend,ub,bmc,config,cluster,all,report,domain}
    选择需要的健康检查项：

    system
    全部系统信息，包括服务器，厂商和主板等信息。

    os
    操作系统名称，版本，内核版本和开机启动参数。

    bios
    BIOS信息，包括启动类型，缓存模式，PCIe速率等。
    注：此特性需用户配置BMC登录信息（需输入账号和密码）方式获取。

    software
    显示软件信息，包括GCC, GLIBC, Binutils, Python, kvm, docker等。

    cpu
    CPU信息，包括 型号，CPU列表等。

    numa
    显示NUMA信息，包括CPU，内存，PCIe，网络，nvme等。

    memory
    显示内存信息，包括系统内存信息和DIMM等。

    network
    网络信息，包括NIC信息和IRQ信息。

    storage
    显示存储信息，包括硬盘和分区等。

    pcie
    PCIe信息，包括PCIe驱动和PCIe的IRQ信息。

    ascend
    昇腾NPU信息，包括npu-smi、ascend-dmi等。

    ub
    灵衢数据采集。

    bmc
    显示使用BMC信息。此功能需用户具有ipmitool使用权限或配置BMC登录信息（包括BMC的IP地址，用户名和密码）。

    config
    检查并展示各个模块的依赖关系。

    cluster
    集群远端采集并回传报告。

    all
    显示系统的全量信息。
    提示：采集全量信息需要提供BMC登录信息（IP地址、用户名和密码），若不提供将使用ipmitool进行采集，最后报告会缺少BMC强依赖模块的内容。为了您的账户安全，请勿在公共场合输入密码或在他人设备/公共设备保存此密码，并确保网络环境安全。

    report
    显示历史报告或分析两份报告间的差异。

    domain
    场景化参数配置。

OPTIONS
    -h, --help
    获取帮助信息并退出。

    -l {0,1,2,3,4}, --log-level {0,1,2,3,4}
    指定输出日志等级，0(debug) | 1(info) | 2(warning) | 3(error) | 4(notset) 默认为 1(info)。

    -lang {0,1}, --language {0,1}
    设置工具的显示语言。支持的语言：1（中文，默认值），0（英文）。For English, switch to 0(en).
    提示：如果当前环境不支持所选语言，将使用0（英文）。

    --remote
    指定是否开启收集远程节点信息。
    提示：工具将传输到远程节点的/tmp目录下。采集完成后，该工具将被删除。该功能需要获取远程节点的SSH登录信息，包括IP地址/端口（xxx.xxx.xxx.xxx:端口号，不输入端口号默认使用22）、用户名、密码。

    -s, --skip-bmc
    跳过BMC采集。

    -c COMMAND, --bmc-command COMMAND
    执行用户自定义BMC信息采集命令。
```