远端采集集群信息

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

图1 示例流程图

前提条件

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

操作步骤

解压并进入工具目录。

        
             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无其他混合条件”的解决方法进行处理。

使用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时必填。

进行服务器集群采集。

        
             ./kspect cluster -i /home/server-config-xxxxxxx-xxxx.xlsx

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

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

返回信息如下：

        
             成功读取配置文件: /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 个服务器。

查看采集结果。

        
             ./kspect report -h

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

返回信息：

        
             ...
...
    -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>
...
...

查看第一个采集报告。

        
             ./kspect report -r 1

图3 报告信息

对比两个报告的差异。

报告中将标红显示超过阈值的数据项和不同的配置项，便于后续统一服务器配置等操作。

         
              ./kspect report -d 1,2

图4 内存部分

父主题： 鲲鹏健康检测使用示例