采集Profiling数据（acl.json配置文件方式）

采集性能原始数据

参考以下步骤完成acl.json文件配置，并完成应用工程编译和运行：

1. 打开工程文件，查看调用的aclInit()函数，获取acl.json文件路径。

   // ACL init
   const char *aclConfigPath = “../src/acl.json”;
   aclError ret = aclInit(aclConfigPath);
   if (ret != ACL_ERROR_NONE) {
       ERROR_LOG(“acl init failed”);
       return FAILED;
   }
   INFO_LOG(“acl init success”);

   

   如果aclInit()初始化为空，则需要修改该函数，补充步骤2创建的acl.json路径。

2. 在查出的目录下修改acl.json文件（如不存在该文件，则需要新建，建议放在工程编译后的src目录下），添加Profiling相关配置，格式如下所示。

   {
   "profiler": {
                 "switch": "on",
                 "output": "output",
                 "aicpu": "on",
               }
   }

   profiler参数配置说明：

   • switch：Profiling开关，取值on或off。可选参数。

     on表示开启Profiling，off表示关闭Profiling；如果缺失该参数或参数值不为on，则表示关闭Profiling。

     acl.json配置文件方式开启Profiling开关后自动采集AscendCL、Runtime接口和Task Scheduler任务调度信息数据。

   • output：Profiling性能数据在运行环境上的落盘路径。可选参数。

     Profiling采集结束后，在该目录下生成PROF开头目录，存放Profiling采集的性能原始数据。支持配置绝对路径或相对路径（相对执行命令行时的当前路径）：

     • 绝对路径配置以“/”开头，例如：/home/HwHiAiUser/output。
     • 相对路径配置直接以目录名开始，例如：output。
     • 该参数指定的目录需要确保安装时配置的运行用户具有读写权限。如果该处设置的目录没有读写权限，默认存放采集结果数据到应用工程可执行文件所在目录（确保安装时配置的运行用户具有该目录的读写权限）。
   • storage_limit：指定落盘目录允许存放的最大文件容量。当Profiling数据文件在磁盘中即将占满本参数设置的最大存储空间（剩余空间<=20MB）或剩余磁盘总空间即将被占满时（总空间剩余<=20MB），则将磁盘内最早的文件进行老化删除处理。

     单位为MB，取值范围为[200, 4294967295]，默认未配置本参数。

     参数值配置格式为数值+单位，例如"storage_limit": "200MB"。

     未配置本参数时，不开启数据老化功能。仅Atlas 训练系列产品与Atlas 推理系列产品支持。

   • aicpu：采集AICPU算子的详细信息，如：算子执行时间、数据拷贝时间等。可选on或off，默认值为off。可选参数。
   • aic_metrics：AI Core采集事件，默认值为PipeUtilization。可选参数。

     AI Core采集事件包括：ArithmeticUtilization、PipeUtilization、Memory、MemoryL0、 MemoryUB、ResourceConflictRatio。以上各参数值对应的详细采集指标请参见AI Core性能指标采集项说明。

   • l2：控制L2采样数据的开关，可选on或off，默认为off。该参数配置前提是application参数已配置，仅Atlas 训练系列产品与Atlas 推理系列产品支持。可选参数。
   • hccl：控制hccl数据采集开关，可选on或off，默认为off。该参数配置前提是application参数已配置。可选参数。
   • msproftx：控制msproftx用户和上层框架程序输出性能数据的开关，可选on或off，默认值为off。

     Profiling开启msproftx功能之前，需要在程序内调用msproftx相关接口来开启程序的Profiling数据流的输出，详细操作请参见Profiling AscendCL API for Extension（Profiling AscendCL API扩展接口）。

3. 配置acl.json完成后，参考《应用软件开发指南 (C&C++)》重新编译应用工程、并运行应用工程。

   “output”指定路径下生成Profiling性能原始数据，如图1所示。

   

   如果acl.json文件之前已经存在，本处仅仅是修改文件内容、添加Profiling相关配置，则不需要重新编译应用工程。

   图1 Profiling性能原始数据
   

采集数据说明

配置acl.json方式参数后生成的Profiling数据如表1和表2所示。