总体介绍

该章节提供离线推理场景下AscendCL API，用于Profiling采集性能数据，实现方式支持以下四种：

Profiling AscendCL API（通过Profiling AscendCL API采集并落盘性能数据）：将采集到的Profiling数据写入文件，再使用Profiling工具解析该文件，并展示性能分析数据。
aclprofInit、aclprofFinalize、aclprofStart、aclprofStop、aclprofCreateConfig和aclprofDestroyConfig接口配合使用，实现该方式的性能数据采集。该方式可获取AscendCL的接口性能数据、AI Core上算子的执行时间、AI Core性能指标数据等。
Profiling AscendCL API for Extension（Profiling AscendCL API扩展接口）：当用户需要定位应用程序或上层框架程序的性能瓶颈时，可在Profiling采集进程内（aclprofStart接口、aclprofStop接口之间）调用Profiling AscendCL API扩展接口（统称为msproftx接口），开启记录应用程序执行期间特定事件发生的时间跨度，并将数据写入Profiling数据文件，再使用Profiling工具解析该文件，并导出展示性能分析数据。
在aclprofStart和aclprofStop接口之间调用aclprofCreateStamp、aclprofSetStampTraceMessage、aclprofMark、aclprofPush、aclprofPop、aclprofRangeStart、aclprofRangeStop、aclprofDestroyStamp接口，获取应用程序执行期间特定时间发生的事件并记录事件发生的时间跨度。

msproftx：msprof tool extension，MindStudio系统调优工具扩展。
Profiling AscendCL API for Subscription（订阅算子信息的Profiling AscendCL API）：将采集到的Profiling数据解析后写入管道，由用户读入内存，再由用户调用AscendCL的接口获取性能数据。
aclprofModelSubscribe接口、aclprofGet*接口、aclprofModelUnSubscribe接口配合使用，实现该方式的性能数据采集，当前支持获取网络模型中算子的性能数据，包括算子名称、算子类型名称、算子执行时间等。
Profiling AscendCL API（PyTorch场景下标记迭代时间）：用于标记迭代开始与结束时间，为后续Profiling解析提供迭代标识，以便以迭代为粒度展示性能数据。
aclprofGetStepTimestamp、aclprofCreateStepInfo、aclprofDestroyStepInfo接口配合使用，实现该方式的性能数据采集。

使用Profiling AscendCL API进行性能数据采集，须参见《应用软件开发指南 (C&C++)》完成应用工程开发、编译和运行。
Profiling AscendCL API和Profiling AscendCL API for Extension不能与Profiling AscendCL API for Subscription交叉调用。

父主题： AscendCL API方式