函数:set_config

C函数原型

aclError aclprofSetConfig(aclprofConfigType configType, const char *config, uint32_t configLength)

Python函数

ret = acl.prof.set_config(config_type, config)

函数功能

acl.prof.create_config接口的扩展接口,用于设置性能数据采集参数。同步接口。

该接口支持多次调用,用户需要保证数据的一致性和准确性。

输入说明

config_type:int,用户选择如下多个常量进行逻辑或(例如:ACL_PROF_SYS_HARDWARE_MEM_FREQ | ACL_PROF_SYS_IO_FREQ),作为config_type参数值。每个常量表示某一类性能数据,详细说明如下:

  • ACL_PROF_STORAGE_LIMIT = 1:指定落盘目录允许存放的最大文件容量,有效取值范围为[200MB, 4294967296MB]。
  • ACL_PROF_SYS_HARDWARE_MEM_FREQ = 3:片上内存、LLC的读写带宽数据采集频率以及acc_pmu数据和SOC传输带宽信息采集频率,范围[1,100]。

    不同产品支持情况不同,请以实际实现为准。

  • ACL_PROF_LLC_MODE = 4:LLC Profiling采集事件。
    • read:读事件,三级缓存读速率。
    • write:写事件,三级缓存写速率。默认为read。
  • ACL_PROF_SYS_IO_FREQ = 5:NIC采集频率,范围[1,100]。

    容器场景下本参数不生效。

  • ACL_PROF_DVPP_FREQ = 7:DVPP采集频率,范围[1,100]。

config:str,配置项的参数值。

返回值说明

ret:int,错误码。

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

约束说明

先调用acl.prof.set_config接口再调用acl.prof.start接口,可根据需求选择调用该接口。