鲲鹏社区首页
开发者
资源
支持
积分兑换 NEW
文档评分
获取效率
正确性
完整性
易理解
提交关闭
在线提单
论坛求助

远端采集集群信息基线对比诊断

支持用户自定义基线文件作为服务器性能基准，利用鲲鹏健康检测工具采集服务器实际运行数据，通过基线对比完成服务器诊断与状态判断。

图1 示例流程图

前提条件

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

操作步骤

  1. 进入工具目录。
    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. 查看基线模板文件。
    ll documents

    返回信息如下：

    total 32
-rw-------. 1 root root 12519 Feb 24 20:04 base.xlsx
-rw-------. 1 root root  9005 Feb 24 20:04 collect_commands.txt
-rw-------. 1 root root   458 Feb 24 20:04 server_config.xlsx
drwx------. 2 root root  4096 Feb 24 20:04 templates
  3. 编辑基线文件。

    可使用Excel编辑base.xlsx文件，依据base.xlsx文件中的使用说明编写基线文件，以下为基线文件自定义内容示例：

    • 表格内容请根据用户需求填写，未填写的影响和修改方法在对比报告不一致时将以“--”显示。
    • 工具在“devkit-kspect-x.x.x-Linux-aarch64/documents/templates”目录下提供灵衢相关模板文件，分别为光组网模板文件（jd_ub_optics.xlsx）、电组网模板文件（jd_ub_electric.xlsx）和版本信息模板文件（jd_ub_version_415.xlsx和jd_ub_version_429.xlsx）。
    表1 基线文件示例

    路径

    基线值

    采集项

    影响

    修改方法

    Software->Library Info->libstdc++

    installed

    GCC提供的C++标准库。

    若缺少，ubse启动运行失败。

    		   

    Software->Library Info->libboundscheck

    installed

    C语言安全函数库。

    若缺少，ubse启动运行失败。

    		   

    Software->Library Info->libxml2

    installed

    C语言XML解析库。

    若缺少，ubse启动运行失败。

    		   

    Software->Library Info->libtpsa

    not installed

    libtpsa库。

    若缺少，ubse启动运行失败。

    		   

    Software->Library Info->tar

    installed

    tar命令基础库。

    若缺少，ubse启动运行失败。

    		   

    memory->OS Memory Info->Transparent Huge Pages Defrag

    madvise

    动态复合页的内存规整。

    后台不做内存规整，避免背景底噪干扰。

    		   

    memory->OS Memory Info->Transparent Huge Pages

    always

    透明大页开关。

    打开THP可能会导致系统的自动页面管理，设置为always后对用户/应用完全透明的将4K小页自动合并成2M大页，提高TLB命中率；缺点是存在背景CPU底噪，收益不稳定，透明大页不能保证总是分配到2M大页，尤其是系统运行时间较长碎片较多时。

    		   

    memory->OS Memory Info->Automatic NUMA Balancing

    Disabled

    numa_balancing。

    必须关闭numa平衡，避免因numa平衡影响UB通信。对于业务容器已经绑定了NUMA，且单NUMA内存满足业务诉求，同时追求时延性能场景建议关闭该特性，以避免后台扫描的底噪开销。

    		   

    OS->Operating System->Printk Loglevel(console | default | min | boot)

    7 | 4 | 1 | 7

    printk的输出等级。

    console_loglevel值（第一个参数值）会限制输出到终端的日志等级；优先级高于该值的消息将被打印至控制台。

    		   

    bios->BIOS detail Info->Memory Frequency

    Auto

    设置核节能模式。

    LPI优化功耗管理与资源分配，关闭LPI可以提升CPU性能。

    		   

    bios->BIOS detail Info->Custom Refresh Rate

    Auto

    高性能模式。

    如果不开启性能模式，中断发包性能会从us级别劣化成ms级别。

    		   

    bios->BIOS detail Info->Custom Power Policy

    Performance

    设置超频模式。

    如果不开启性能模式，中断发包性能会从us级别劣化成ms级别。

    		   

    bios->BIOS detail Info->Die Interleaving

    Disabled

    开启HiBoost该选项默认为Auto。

    如果不开启性能模式，中断发包性能会从us级别劣化成ms级别。

    		   
  4. 编辑服务器配置文件。

    可使用Excel编辑server.config.xlsx文件，依据server.config.xlsx文件中的配置说明编写服务器配置文件。

    • 服务器配置文件的密码以明文形式存储在Excel文件中，存在信息泄露风险。
    • 建议使用完毕后清空文件内容或妥善保存。
    • 建议在使用完Excel配置后，通过设置文件访问权限来保护敏感信息。
    表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时必填。
  5. 将编辑好的基线文件base.xlsx和服务器配置文件server_config.xlsx上传至服务器的/home下。
  6. 采集报告并进行基线比对。
    ./kspect cluster -i /home/server_config.xlsx --diff_base /home/base.xlsx
    • 若不想自定义编辑基线文件，可直接使用工具提供的基线模板进行对比，使用光组网基线模板文件的命令示例如下：
      ./kspect cluster -i /home/server_config.xlsx --diff_base /home/devkit-kspect-x.x.x-Linux-aarch64/documents/templates/jd_ub_optics.xlsx
    • 若出现服务器集群采集失败的情况，请参见高并发采集时部分连接失败的解决方法进行处理。

    返回信息如下：

    采集结束后，是否清理服务器配置文件中的密码信息？(Y/N) [默认: N]: n
以下服务器开始采集数据：xxx.xxx.xxx.xxx:22(server_3);  xxx.xxx.xxx.xxx:22(server_4);  xxx.xxx.xxx.xxx:22(server_5)
基线文件包含BMC/BIOS参数，但以下服务器未填写BMC信息, 将跳过BMC采集：xxx.xxx.xxx.xxx:22(server_4)
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已成功生成。
xxx.xxx.xxx.xxx:22(server_5)采集成功。
归档文件/home/devkit-kspect-x.x.x-Linux-aarch64/output/kspect-report-xxxxxxxx-xxxxxx-xxx.xxx.xxx.xxx-22.tar.gz已成功生成。
xxx.xxx.xxx.xxx:22(server_4)采集成功。
归档文件/home/devkit-kspect-x.x.x-Linux-aarch64/output/kspect-report-xxxxxxxx-xxxxxx-xxx.xxx.xxx.xxx-22.tar.gz已成功生成。
采集完成: 成功 3/3 个服务器。
Cluster Baseline Comparison Result
───────────────────────────────────────────────────────────────────
  Node        Connection                 Status    Mismatch/Total
───────────────────────────────────────────────────────────────────
  server_3    root@xxx.xxx.xxx.xxx:22    一致      0/13
  server_5    root@xxx.xxx.xxx.xxx:22    不一致    6/13
  server_4    root@xxx.xxx.xxx.xxx:22    不一致    6/13
───────────────────────────────────────────────────────────────────
总计: 3 节点 | 匹配: 1 | 不匹配: 2 | 采集失败: 0
报告已生成: /home/devkit-kspect-x.x.x-Linux-aarch64/output/cluster_diff_report_20260814-163036737884.xlsx
[WARNING] 服务器配置文件 /home/devkit-kspect-x.x.x-Linux-aarch64/documents/server_config.xlsx 中包含明文密码，请务必妥善保管或在使用后及时清理。

    基线比对支持正则及区域（[a,b]）匹配，区域匹配支持单位，如“[50,]Mib”匹配大于等于50Mib。

  7. 根据比对报告中的不一致项，对服务器进行自定义修改。
我们使用cookie来确保您的高速浏览体验。继续浏览本站，即表示您同意我们使用cookie。查看详情