昇腾社区首页
中文
注册
开发者
下载

服务化调优工具

在服务化框架的性能测试中,由于其内部机制不透明(黑盒效应),常出现反直觉现象,例如并发量增加时吞吐量反而降低,或相同配置在不同硬件平台上呈现显著性能差异。msServiceProfiler服务化调优工具的核心价值在于实现服务化框架从“黑盒”到“白盒”的转变,通过全链路性能剖析(Profiling),清晰呈现服务化调度全过程的性能表现。

该工具提供对MindIE Motor推理服务的深度性能数据采集与解析能力:

  • 框架调度透视:全面采集服务化框架调度信息、模型推理状态及关键事件(如重计算)的精确时序。
  • 性能瓶颈定界:集成MSPTI与msprof能力,同时采集算子级性能数据,支持用户关联分析框架调度与纯模型推理性能,快速定界问题(框架侧或模型侧)。
  • 动态采集支持:提供动态性能数据采集能力,只关注核心采集时间段。

借助msServiceProfiler提供的全方位、可视化性能洞察,用户能够深刻理解服务化内部运行机制,从而高效进行性能优化。

工具操作如下:

以下仅提供服务化调优工具的快速入门,工具更多操作及接口、参数、字段等详细内容介绍请参见服务化调优工具

操作步骤

  1. 环境准备。

    请参见MindIE安装指南完成MindIE的安装和配置并确认MindIE Motor可以正常运行。

  2. 配置环境变量。

    msServiceProfiler的采集能力需要在部署MindIE Motor服务之前,通过设置环境变量SERVICE_PROF_CONFIG_PATH方能生效。如果环境变量拼写错误,或者没有在部署MindIE Motor服务之前设置环境变量,将无法使能msServiceProfiler的采集能力。

    以ms_service_profiler_config.json文件名为例,执行下列命令配置环境变量。

    1
    export SERVICE_PROF_CONFIG_PATH="./ms_service_profiler_config.json"
    

    SERVICE_PROF_CONFIG_PATH的值需要指定到json文件名,该json文件即为控制性能数据采集的配置文件,比如采集性能元数据存放位置、算子采集开关等,具体字段介绍参考4。若路径下无配置文件,工具将自动生成默认配置(采集开关默认为关闭状态)。

  3. 运行MindIE Motor服务。

    如果正确配置了环境变量,工具会在服务部署完成之前输出如下[msservice_profiler]开头的日志,说明msServiceProfiler已启动,如下所示。

    1
    2
    3
    4
    [msservice_profiler] [PID:225] [INFO] [ParseEnable:179] profile enable_: false
    [msservice_profiler] [PID:225] [INFO] [ParseAclTaskTime:264] profile enableAclTaskTime_: false
    [msservice_profiler] [PID:225] [INFO] [ParseAclTaskTime:265] profile msptiEnable_: false
    [msservice_profiler] [PID:225] [INFO] [LogDomainInfo:357] profile enableDomainFilter_: false
    

    如果SERVICE_PROF_CONFIG_PATH环境变量所指定的配置文件不存在,工具输出自动创建的日志。以2的配置为例,那么工具输出日志如下。

    1
    [msservice_profiler] [PID:225] [INFO] [SaveConfigToJsonFile:588] Successfully saved profiler configuration to: ./ms_service_profiler_config.json
    
  4. 数据采集。

    MindIE Motor服务部署成功之后,可以通过修改配置文件中的字段来进行精准控制采集行为。

    1
    2
    3
    4
    5
    6
    {
    	"enable": 1,
    	"prof_dir": "${PATH}/prof_dir/",
    	"acl_task_time": 0
    ...    # 此处仅以配置上面三个字段为例
    }
    
    表1 参数说明

    参数

    说明

    是否必选

    enable

    性能数据采集总开关。取值为:

    • 0:关闭。
    • 1:开启。

    即便其他开关开启,该开关不开启,仍然不会进行任何数据采集;如果只有该开关开启,只采集服务化性能数据。

    prof_dir

    采集到的性能数据的存放路径,默认值为${HOME}/.ms_server_profiler。

    该路径下存放的是性能原始数据,需要继续执行后续解析步骤,才能获取可视化的性能数据文件进行分析。

    在enable为0时,对prof_dir进行自定义修改,随后修改enable为1时生效;在enable为1时,直接修改prof_dir,则修改不生效。

    acl_task_time

    开启采集算子下发耗时、算子执行耗时数据的开关,取值为:

    • 0:关闭。默认值,配置为0或其他非法值均表示关闭。
    • 1:开启。
    说明:
    • 该功能开启时会占用一定的设备性能,导致采集的性能数据不准确,建议在模型执行耗时异常时开启,用于更细致的分析。
    • 算子采集数据量较大,推荐集中采集3 ~ 5s,时间过长会导致占用额外磁盘空间,消耗额外的解析时间,从而导致性能定位时间拉长。
    • 默认算子采集等级为L0,如果需要开启其他算子采集等级,请参见服务化调优工具的完整参数介绍。

    如果enable一直为1,当MindIE Motor推理服务从收到请求的那一刻,工具会一直采集,直到请求结束,prof_dir下的目录大小也会不断增长,因此推荐用户仅采集关键时间段的信息。

    每当enable字段发生变更时,工具都会输出对应的日志进行告知。

    1
    [msservice_profiler] [PID:3259] [INFO] [DynamicControl:407] Profiler Enabled Successfully!
    

    或者

    1
    [msservice_profiler] [PID:3057] [INFO] [DynamicControl:411] Profiler Disabled Successfully!
    

    每当enable由0改为1时,配置文件中的所有字段都会被工具重新加载,从而实现动态地更新。

  5. 数据解析。
    1. 安装环境依赖。
      1
      2
      3
      4
      python >= 3.10
      pandas >= 2.2
      numpy >= 1.24.3
      psutil >= 5.9.5
      
    2. 执行解析命令示例:
      1
      python3 -m ms_service_profiler.parse --input-path=${PATH}/prof_dir
      

      --input-path指定为4prof_dir参数指定的路径。

      解析完成后默认在命令执行目录下生成解析后的性能数据文件。

  6. 调优分析。

    解析后的性能数据包含db格式、csv格式和json格式,用户可以通过csv进行请求、调度等不同维度的快速分析,也可以通过MindStudio Insight工具导入db文件或者json文件进行可视化分析,详细操作和分析说明请参见MindStudio Insight 工具用户指南中的“服务化调优”章节。