鲲鹏社区首页
中文
注册
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
在线提单
论坛求助

功能说明

命令功能

生成鲲鹏自动调优的参数空间和应用程序场景模板的配置。配置生成后可运行“devkit kat train -t task.json -f param.json”开始自动调优。

命令格式

1
devkit kat template [-h] [-l {0,1,2,3}] [-g] [-o <dir>]

参数说明

表1 参数说明

参数

参数选项

说明

-h/--help

-

获取帮助信息。

-l/--log-level

0/1/2/3

设置日志级别,默认为2。
  • 0:日志级别为DEBUG。
  • 1:日志级别为INFO。
  • 2:日志级别为WARNING。
  • 3:日志级别为ERROR。

-g/--generate

-

进入模板配置交互界面,生成对应应用的简易模板文件,仅包含任务必须参数。

-c/--convert

-

将简易模板文件转换为全参数的通用模板文件。

-o/--output

-

设置生成的模板文件的输出路径。

使用示例

  • 生成简易模板:
    1
    devkit kat template -g  -o /opt/template
    

    命令中使用参数“-g”将进入交互界面,用户可选择模板文件需要的基本参数,参数“-o /opt/template”为生成的模板文件存放目录。

  1. 选择应用。

    使用“↑”、“↓”键选择,按“Enter”键选中应用。

    图1 选择应用
  2. 选择应用版本。

    按“Enter”键进入版本列表选择需要的版本,按“Esc”键返回上一级目录,按“Space”键切换选中与否

    图2 选择版本
  3. 选择参数类型。

    按“Space”键切换选项前的[Y/N]表示是否启用此项参数;OS选项为系统参数调优,uarch为微架构参数调优。

    图3 选择需要配置的参数类型
  4. 选择应用参数。
    按“Enter”键进入应用参数配置界面,选择需要启用的参数。
    图4 选择spark应用参数
  5. 保存配置,生成简易模板文件。

    配置完成后按“S”键保存简易模板文件至指定目录下,如果未指定保存目录,将在命令运行目录下生成名为“kat-template-YMD-HMS”格式的模板文件。

    图5 生成简易模板文件
  6. 退出配置交互界面。

    按“Q”键选择退出,再按“Y”键确认退出;将在终端显示模板文件保存目录。

    返回信息如下:

    1
    [2024-12-30 09:46:49 UTC] [KAT] [message] - The path of the saved file is as follows:: ['/home/kat_show/DevKit-CLI-xx.xx.xx-Linux-Kunpeng/template_Spark_20241230_094556']
    
  7. 查看简易模板文件。
    1
    ls /home/kat_show/DevKit-CLI-xx.0.xx-Linux-Kunpeng/template_Spark_20241230_094556
    

    返回信息如下:

    1
    param_Spark_uarch.json  task_Spark_uarch.json
    
  8. 查看应用参数文件。
    1
    vim /home/kat_show/DevKit-CLI-xx.0.xx-Linux-Kunpeng/template_Spark_20241230_094556/param_Spark_OS_uarch.json
    

    param_xxx_xxxx.json文件是交互界面中选择的应用参数。

    图6 应用参数文件
  9. 查看并完善任务参数文件。
    1
    vim /opt/template/template_spark_20241218_075615/task_Spark_OS_uarch.json
    

    该模板文件中一些任务必须参数值需用户根据实际情况填写,比如环境信息、应用所在服务器、性能测试工具所在服务器及压测指标等,参数详情可查看简易模板参数说明

    图7 任务模板文件
  10. 保存退出任务参数文件。

    完善好基本配置后按“Esc”键,键入“:wq”再按“Enter”键保存退出。

  • 转换为通用参数模板

    当简易模板无法满足用户对应用的参数调整时可转换为通用参数模板文件进行操作:

    1
    devkit kat template -c /home/kat_show_user/task_Rocksdb_OS.json
    

    返回信息:

    1
    [2024-12-19 13:53:27 UTC] [KAT] [ info  ] - /home/kat_show_user/task_Rocksdb_OS.json has been converted to /home/kat_show_user/task_Rocksdb_OS_custom.json
    
    图8 通用模板文件