功能介绍

功能

该章节描述通过Profiling AscendCL API采集并落盘性能数据，实现将采集到的Profiling数据写入文件，再使用Profiling工具解析该文件（请参见数据解析与导出），并展示性能分析数据。

总体约束

不能与Profiling AscendCL API for Subscription（订阅算子信息的Profiling AscendCL API）的接口交叉调用：aclprofInit接口和aclprofFinalize接口之间不能调用aclprofModelSubscribe接口、aclprofGet*接口、aclprofModelUnSubscribe接口。

接口约束说明

• 调用接口要求：
  • aclprofInit接口必须在aclInit接口之后、模型加载之前调用。

    如果已经通过aclInit接口配置了Profiling信息，则调用aclprofInit接口、aclprofStart接口、aclprofStop接口、aclprofFinalize时，会返回报错。

    如果没有调用aclprofInit接口，调用aclprofStart接口、aclprofStop接口、aclprofFinalize时，会返回报错。

  • aclprofStart接口在模型执行之前调用，若在模型执行过程中调用aclprofStart接口，Profling采集到的数据为调用aclprofStart接口之后的数据，可能导致数据不完整。

    调用aclprofStart接口时，可以指定从一个Device上采集性能数据，也可以指定从多个Device上采集性能数据。

    一个APP进程内，如果连续调用多次aclprofStart接口，指定重复的Profiling配置，或指定的Device重复，会返回报错。

  • 在用户APP的进程生命周期内，aclprofInit接口与aclprofFinalize接口配对使用，建议只调用一次，如该组合多次调用可以改变保存性能数据的文件的路径。
  • aclprofStart接口与aclprofStop接口需配对使用。
  • aclprofSetConfig接口必须在aclprofStart接口之前调用。一个APP进程内，可以根据需要选择一次或多次调用aclprofSetConfig接口。
• 接口调用顺序：
  • 建议的接口调用顺序如下，以“一个用户APP进程内采集多个模型推理时的性能数据”为例：

    aclInit接口-->aclprofInit接口-->aclprofStart接口(指定Device 0和Device 1)-->模型1加载-->模型1执行-->aclprofStop接口(与aclprofStart接口的aclprofConfig数据保持一致)-->aclprofStart接口(指定Device 1和Device 2)-->模型2加载-->模型2执行-->aclprofStop接口(与aclprofStart接口的aclprofConfig数据保持一致)-->aclprofFinalize接口-->执行其它任务-->模型卸载-->aclFinalize接口

  • 错误的接口调用顺序示例如下，以“一个用户APP进程内，如果连续调用多次aclprofStart接口，指定的Device重复”为例：

    aclInit接口-->aclprofInit接口-->aclprofStart接口(指定Device 0和Device 1)-->aclprofStart接口(指定Device 1和Device 2)-->模型1加载-->模型1执行-->模型2加载-->模型2执行-->aclprofStop接口-->aclprofStop接口-->aclprofFinalize-->执行其它任务-->模型卸载-->aclFinalize接口

• 有关aclInit和aclFinalize接口的详细介绍请参见《应用软件开发指南（C&C++）》中“AscendCL API参考 > 系统配置”章节。
• 有关aclprofConfig接口的详细介绍请参见《应用软件开发指南（C&C++）》中“AscendCL API参考 > 数据类型及其操作接口 > aclprofConfig”章节。