总体介绍
本章节提供离线推理场景下，如何通过API方式采集性能数据，支持以下实现方式：
|
采集方式 |
说明 |
调用 |
|---|---|---|
|
方式一：采集并落盘性能数据 |
将采集到的性能数据写入文件，再使用msprof工具解析该文件，并展示性能分析数据。 |
acl.prof.init、acl.prof.finalize、acl.prof.start、 acl.prof.stop、acl.prof.create_config和acl.prof.destroy_config接口配合使用，实现该方式的性能数据采集。该方式可获取AI Core上算子的执行时间、AI Core性能指标数据等。 |
|
方式二：使用msproftx扩展接口采集并落盘性能数据 |
当用户需要定位应用程序或上层框架程序的性能瓶颈时，可在Profiling采集进程内（acl.prof.start接口、acl.prof.stop接口之间）调用msproftx，开启记录应用程序执行期间特定事件发生的时间跨度，并将数据写入性能数据文件，再使用msprof工具解析该文件，并导出展示性能分析数据。 |
在acl.prof.start和acl.prof.stop接口之间调用acl.prof.create_stamp、acl.prof.set_stamp_trace_message、acl.prof.mark、acl.prof.push、acl.prof.pop、acl.prof.range_start、acl.prof.range_stop、acl.prof.destroy_stamp接口，获取应用程序执行期间特定时间发生的事件并记录事件发生的时间跨度。 |
|
方式三：订阅算子信息 |
将采集到的性能数据解析后写入管道，由用户读入内存，再由用户调用API获取性能数据。 |
acl.prof.model_subscribe接口、acl.prof.get*接口、acl.prof.model_un_subscribe接口配合使用，实现该方式的性能数据采集，当前支持获取网络模型中算子的性能数据，包括算子名称、算子类型名称、算子执行时间等。 |
- 使用接口进行性能数据采集，须完成应用工程开发、编译和运行。
- 方式一和方式二不能与方式三交叉调用。