下载
中文
注册
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
在线提单
论坛求助
昇腾小AI

功能介绍

功能

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

包括以下两种接口调用方式:
  • aclprofInit接口、aclprofStart接口、aclprofStop接口、aclprofFinalize接口配合使用,实现该方式的性能数据采集。该方式可获取AscendCL的接口性能数据、AI Core上算子的执行时间、AI Core性能指标数据等。目前这些接口为进程级控制,表示在进程内任意线程调用该接口,其它线程都会生效。

    一个进程内,可以根据需求多次调用这些接口,基于不同的Profiling采集配置,采集数据。

  • 调用aclInit接口,在AscendCL初始化阶段,通过*.json 文件传入要采集的Profiling数据。该方式可获取AscendCL的接口性能数据、AI Core上算子的执行时间、AI Core性能指标数据等。

    一个进程内,只能调用一次aclInit接口,如果要修改Profiling采集配置,需修改*.json文件中的配置。

总体约束

不能与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接口需配对使用。
  • 接口调用顺序
    • 建议的接口调用顺序如下,以“一个用户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”章节。
搜索结果
找到“0”个结果

当前产品无相关内容

未找到相关内容,请尝试其他搜索词