---
title: 远端采集集群信息
description: "使用鲲鹏健康检测工具对远端服务器硬件数据采集并下载报告，进行数据查看和对比。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengdevps/profiler/diagnosis/KunpengDevKitCli_0216.html
sourcePath: /source/zh/kunpengdevps/profiler/diagnosis/KunpengDevKitCli_0216.html
indexId: dba473794f08c51b1f85b599c5132cb8911b8d3165b6ebd1a06ea7f7e4d1cb4469
---
# 远端采集集群信息

使用鲲鹏健康检测工具对远端服务器硬件数据采集并下载报告，进行数据查看和对比。

图1 示例流程图

#### 前提条件

以鲲鹏健康检测工具安装路径“/home/devkit-kspect-x.x.x-Linux-aarch64”为例。


#### 操作步骤

1. 解压并进入工具目录。
  1 2 tar -zxvf /home/devkit-kspect-x.x.x-Linux-aarch64.tar.gz cd /home/devkit-kspect-x.x.x-Linux-aarch64

  使用示例时请将“/home/devkit-kspect-x.x.x-Linux-aarch64”替换为工具实际所在路径。 为确保SSH连接稳定，建议在执行采集前，确认本机（运行kspect的主机）的SSH客户端配置兼容。若您的系统为较新的Linux发行版（如RHEL/CentOS 8/9、Ubuntu 22.04以上），可能存在配置冲突导致采集失败。详情请参见采集报错“Match all无其他混合条件”的解决方法进行处理。

2. 使用Excel编辑“/home/devkit-kspect-x.x.x-Linux-aarch64/documents”目录下的server_config.xlsx服务器配置模板文件，如图2所示。
  服务器配置文件的密码以明文形式存储在Excel文件中，存在信息泄露风险。 建议使用完毕后清空文件内容或妥善保存。 建议在使用完Excel配置后，通过设置文件访问权限来保护敏感信息。

  图2 server_config.xlsx模板

**表1 服务器配置文件Excel参数**

| 参数 | 参数说明 |
| --- | --- |
| 服务器别名 | 可选参数，待采集服务器别名。 |
| IP地址 | 必选参数，待采集服务器的IP地址。 |
| 端口 | 可选参数，待采集服务器的端口号，缺省时默认为22。 |
| 用户名 | 必选参数，待采集服务器的操作系统用户。 |
| 认证方式 | 必选参数，登录服务器的方式，可选： password：密码方式，需填写“密码”参数。 private\_key：私钥方式，需填写“私钥路径”和“私钥密码”参数（可选）。 |
| 密码 | 可选参数，对应用户的密码，仅在认证方式选择为password时必填。 |
| 私钥路径 | 可选参数，仅在认证方式选择为private\_key私钥方式时必填。 |
| 私钥密码 | 可选参数，仅在认证方式选择为private\_key私钥方式且私钥文件有密码时必填，无密码时选填。 |
| BMC采集方式 | 可选参数，采集BMC的方式： password：使用BMC账号密码登录，需填写BMC IP、BMC用户名、BMC密码。 In\-band：需远程节点支持带内采集，否则会自动跳过。 缺省：不采集BMC。 |
| BMC IP | 可选参数，BMC的IP地址，仅在BMC采集方式选择为password时必填。 |
| BMC用户名 | 可选参数，BMC的用户名，仅在BMC采集方式选择为password时必填。 |
| BMC密码 | 可选参数，BMC的密码，仅在BMC采集方式选择为password时必填。 |


3. 进行服务器集群采集。
  1 ./kspect cluster -i /home/server-config-xxxxxxx-xxxx.xlsx

  使用示例时请将“/home/server-config-xxxxxxx-xxxx.xlsx”替换为Excel文件实际存放路径，支持绝对路径或相对路径。 若出现服务器集群采集失败的情况，请参见高并发采集时部分连接失败的解决方法进行处理。

  将逐个采集配置文件中的服务器，并回显采集成功与否，最后将返回采集详情和报告存放目录。

  返回信息如下：

  1 2 3 4 5 6 7 8 成功读取配置文件: /home/server-config-xxxxxxx-xxxx.xlsx 以下服务器开始采集数据：192.168.x.1:22(101); 192.168.x.2:22(102); 192.168.x.1:22(101)采集成功。 归档文件/home/devkit-kspect-x.x.x-Linux-aarch64/output/kspect-report-xxxxxxxx-xxxxxx-xxx.xxx.xxx.xxx-22.tar.gz已成功生成。 192.168.x.2:22(102)采集成功。 归档文件/home/devkit-kspect-x.x.x-Linux-aarch64/output/kspect-report-xxxxxxxx-xxxxxx-xxx.xxx.xxx.xxx-22.tar.gz已成功生成。 采集完成: 成功 2/2 个服务器。

4. 查看采集结果。
  1 ./kspect report -h

  采集到的压缩包将自动解压，解压文件包含全量信息文件（HTML/JSON/CSV）和dmesg日志文件，HTML文件可使用浏览器查看。

  返回信息：

  1 2 3 4 5 6 7 8 ... ... -r REPORT, --report REPORT 选择展示哪一份报告（或自行输入报告路径，支持工具采集报告和使用diff/diff_x86后生成的对比报告）： 1: /home/devkit-kspect-x.x.x-Linux-aarch64/output/kspect-report-xxxxxxxx-xxxxxx/kspect-json-xxxxxxxx-xxxxxx.json <xxxx-xx-xx xx:xx:xx> 2: /home/devkit-kspect-x.x.x-Linux-aarch64/output/kspect-report-xxxxxxxx-xxxxxx/kspect-json-xxxxxxxx-xxxxxx.json <xxxx-xx-xx xx:xx:xx> ... ...

5. 查看第一个采集报告。
  1 ./kspect report -r 1

  图3 报告信息

6. 对比两个报告的差异。
  报告中将标红显示超过阈值的数据项和不同的配置项，便于后续统一服务器配置等操作。 1 ./kspect report -d 1,2 图4 内存部分
