---
title: cluster子命令
description: "远端采集集群并回传报告。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengdevps/profiler/diagnosis/KunpengDevKitCli_0207.html
sourcePath: /source/zh/kunpengdevps/profiler/diagnosis/KunpengDevKitCli_0207.html
indexId: 59d693ca80b10cb7bcd411a5567c0fd78aee98d6f8e3a7f3d31e6f273665a8f069
---
# cluster子命令

#### 命令功能

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

- 若采集的服务器数量过多，可能导致带宽使用率升高。
- 要求工具所在服务器和待采集服务器均支持SSH连接。


#### 命令格式

```
./kspect cluster [-h] -i INPUT [--diff_base DIFF_BASE]
```


#### 参数说明


**表1 cluster子命令参数**

| 参数 | 参数说明 |
| --- | --- |
| \-h/\-\-help | 获取帮助信息。 |
| \-i/\-\-input | 必选参数，服务器配置文件Excel路径（绝对路径或相对路径）。 须知： 服务器配置文件的密码以明文形式存储在Excel文件中，存在信息泄露风险。 建议使用完毕后清空文件内容或妥善保存。 建议在使用完Excel配置后，通过设置文件访问权限来保护敏感信息。 |
| \-\-diff\_base | 可选参数，基线模板文件路径（绝对路径或相对路径）。集群采集后与基线模板进行比对，详细的使用示例请参见远端采集集群信息基线对比诊断。 |


#### 使用示例

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服务器配置模板文件，如图1所示。
  图1 server_config.xlsx模板

**表2 服务器配置文件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.xlsx

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

  返回信息如下：

```
采集结束后，是否清理服务器配置文件中的密码信息？(Y/N) [默认: N]: n
以下服务器开始采集数据：xxx.xxx.xxx.xxx:22(server_3)
xxx.xxx.xxx.xxx:22(server_3)采集成功。
归档文件/home/devkit-kspect-x.x.x-Linux-aarch64/output/kspect-report-xxxxxxxx-xxxxxx-xxx.xxx.xxx.xxx-22.tar.gz已成功生成。
采集完成: 成功 1/1 个服务器。
[WARNING] 服务器配置文件 /home/devkit-kspect-x.x.x-Linux-aarch64/documents/server_config.xlsx 中包含明文密码，请务必妥善保管或在使用后及时清理。
```