Skip to main content

aclprofStop

aclprofStart​

函数功能​

下发Profiling请求，使能对应数据的采集。同步接口。

用户可根据需要，在模型执行过程中按需调用aclprofStart接口，Profling采集到的数据为调用该接口之后的数据。

约束说明​

与aclprofStop接口配对使用，先调用aclprofStart接口再调用aclprofStop接口。

函数原型​

aclError aclprofStart(aclprofConfig *profilerConfig)

参数说明​

参数名输入/输出说明
profilerConfig输入指定Profiling配置数据。 需提前调用aclprofCreateConfig接口创建aclprofConfig类型的数据。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

接口调用示例，参见Profiling性能数据采集。

父主题： Profiling AscendCL API（通过Profiling AscendCL API采集并落盘性能数据）

aclprofStop​

函数功能​

停止Profiling数据采集。同步接口。

约束说明​

与aclprofStart接口配对使用，先调用aclprofStart接口再调用aclprofStop接口。

函数原型​

aclError aclprofStop(****aclprofConfig *profilerConfig)

参数说明​

参数名输入/输出说明
profilerConfig输入指定停止Profiling数据采集的配置。 与aclprofStart接口中的aclprofConfig类型数据保持一致。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

接口调用示例，参见Profiling性能数据采集。

父主题： Profiling AscendCL API（通过Profiling AscendCL API采集并落盘性能数据）

aclprofFinalize​

函数功能​

结束Profiling。同步接口。

约束说明​

与aclprofInit接口配对使用，先调用aclprofInit接口再调用aclprofFinalize接口。

函数原型​

aclError aclprofFinalize()

参数说明​

无

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

接口调用示例，参见Profiling性能数据采集。

父主题： Profiling AscendCL API（通过Profiling AscendCL API采集并落盘性能数据）

功能介绍​

功能​

当用户需要定位应用程序或上层框架程序的性能瓶颈时，可在Profiling采集进程内（aclprofStart接口、aclprofStop接口之间）调用Profiling AscendCL API扩展接口（统称为msproftx功能），开启记录应用程序执行期间特定事件发生的时间跨度，并将数据写入Profiling数据文件，再使用Profiling工具解析该文件，并导出展示性能分析数据。

Profiling工具解析导出操作请参见《性能分析工具使用指南》下的“高级功能>数据解析与导出”。

接口调用方式：在aclprofStart和aclprofStop接口之间调用aclprofCreateStamp、aclprofSetStampTraceMessage、aclprofMark、aclprofPush、aclprofPop、aclprofRangeStart、aclprofRangeStop、aclprofDestroyStamp接口。该方式可获取应用程序执行期间特定时间发生的事件并记录事件发生的时间跨度。

一个进程内，可以根据需求多次调用这些接口。

接口约束说明​

父主题： Profiling AscendCL API for Extension（Profiling AscendCL API扩展接口）

在线提单