1 非商用声明

该文档提供的内容为参考实践，仅供用户参考使用，用户可参考实践文档构建自己的软件，按需进行安全、可靠性加固，但不建议直接将相关Demo或镜像文件集成到商用产品中。

2 概述

KAOT（Kunpeng Auto Optimization Tool）是一款系统性能调优工具，其核心目标是通过自动化操作提升调优效率与易用性。相较于传统人工调优，KAOT可根据用户指定的应用场景，自动完成调优配置文件生成、调优配置执行及鲲鹏BoostKit加速库安装等一系列操作，同时用户可以指定特定的调优手段进行快速使能，有效降低手动操作的复杂性和出错风险。

KAOT新增支持金仓数据库、openGauss数据库2个数据库场景的自动化调优能力，2个数据库的调优参考实践详见如下两个文档：

表1 数据库调优参考实践

3 数据库调优端到端使用指导

本章节基于数据库调优场景，给出该工具使用的最佳实践。

工具详细使用参考实践参考文档：https://www.hikunpeng.com/zh/developer/techArticles/20251222-1

步骤1    调优前测试环境上的基线性能数据（可选，用来对比调优前后的效果）

             根据业务场景进行测试即可。

步骤2    生成当前环境上的基线文件

             执行以下命令生成所有调优项的基线文件：

         python kaot.py basecfg

步骤3    根据场景生成调优配置文件

             执行以下命令生成该场景下的配置文件

             (1) openGuass数据库场景

         python kaot.py generate -s opengauss_database --configfile opengauss_database:/opt/openGuass/data/postgresql.conf -o feature_config.yaml

             (2) KingBase金仓数据库场景

         python kaot.py generate -s kingbase_database --configfile kingbase_database:/opt/Kingbase/ES/V8/data/kingbase.conf -o feature_config.yaml

             示例中提供的kingbase.conf路径为KingBase默认路径，用户可使用默认路径，若有指定，则使用自定义的路径。

             postgresql.conf一般没有默认路径，安装目录由用户指定，用户必须使用用户指定的postgresql.conf路径。

             根据执行成功后的日志回显，可查看生成的配置文件feature_config.yaml是否完整。

步骤4    使能生成的调优配置文件

             执行以下命令使能调优项：python kaot.py execute -tp feature_config.yaml

             根据执行打屏日志，可查看生成的基线文件base_config.yaml是否完整、调优项是否执行成功，以及生成的配置文件备份是否完整

步骤5    重启数据库服务使得配置参数调整生效。

步骤6    测试调优后的性能（可选，用来对比调优前后的效果）按照步骤1的测试方法进行测试。

步骤7    回退不需要执行的调优配置（可选）

             若要回退指定的调优项，需将基线文件的deploy字段修改为Y，并按调优项使能新生成的配置文件，以回退config_nic_affinity为例，使用方式如下：

             1. 修改基线文件

           python kaot.py generate -bp base_config.yaml -o target_config.yaml

                 得到新生成的配置文件target_config.yaml，执行前注意拷贝基线文件base_config.yaml至./output目录下。

             2. 使能新生成的配置文件中的调优项

           python kaot.py generate -s opengauss_database --configfile opengauss_database:/opt/openGuass/data/postgresql.conf -o feature_config.yaml

步骤8    测试最终性能（可选，用来对比调优前后的效果）

             按照步骤1的测试方法进行测试。

             ----结束

4 附录：数据库调优场景下的自动调优项汇总

表1 KAOT工具支持的KingBase金仓数据库调优项总览

表2 KAOT工具支持的openGuass金仓数据库调优项总览

表3 KAOT工具调优KingBase金仓数据库配置参数参考

表4 KAOT工具调优openGuass数据库配置参数参考