---
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}] [-l {0,1}] [--remote] [-s] [-c COMMAND] {system,os,bios,software,cpu,numa,memory,network,storage,pcie,ascend,bmc,ub,config,server_config,cluster,all,report,domain} ...
```


#### 使用示例

```
./kspect -h
```

返回信息如下：

```
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,server_config,cluster,all,report,domain} ...

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

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

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

    bios
    BIOS信息，包括启动类型，缓存模式，PCIE速率等。
    注：此特性需用户具有ipmitool运行权限或配置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等。

    bmc
    显示使用BMC方式获取的信息。此功能需用户具有ipmitool使用权限或配置BMC信息（包括BMC的IP地址，用户名和密码），不输入BMC相关信息将不采集SEL日志信息。

    ub
    灵衢数据采集。

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

    server_config
    交互式加密集群采集配置文件里的认证凭据。

    cluster
    集群远端采集并回传报告。若想使用Ansible进行集群远端采集，可参考'Kspect远端采集指导文档 - Ansible方式'文档。

    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) 默认为 4(notset)。

    -l {0,1}, --language {0,1}
    指定打印语言，0(en) | 1(zh), 默认为 1(zh)。
    提示: 如果当前环境不支持所选语言，则会使用 0(en)。

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

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

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