函数功能
aclprofCreateConfig接口的扩展接口,用于设置性能数据采集参数。
该接口支持多次调用,用户需要保证数据的一致性和准确性。
函数原型
aclError aclprofSetConfig(aclprofConfigType configType, const char *config, size_t configLength)
参数说明
参数名 |
输入/输出 |
说明 |
configType |
输入 |
作为configType参数值。每个枚举表示不同采集配置,若要使用该接口下不同的选项采集多种性能数据,则需要多次调用该接口,详细说明如下:
- ACL_PROF_STORAGE_LIMIT :指定落盘目录允许存放的最大文件容量,有效取值范围为[200, 4294967295],单位为MB。
- ACL_PROF_SYS_HARDWARE_MEM_FREQ:DDR、HBM带宽及内存、LLC的读写带宽数据、acc_pmu数据和SoC传输带宽信息、组件内存采集频率,范围[1,100]。
- Atlas 200/300/500 推理产品:支持采集DDR、LLC、组件内存
- Atlas 200/500 A2推理产品:支持采集DDR、LLC、acc_pmu数据、SoC传输带宽信息、组件内存
- Atlas 推理系列产品(Ascend 310P处理器):支持采集DDR、LLC、组件内存
- Atlas 训练系列产品:支持采集DDR、HBM、LLC、组件内存
- Atlas A2训练系列产品:支持采集HBM、LLC、acc_pmu数据、SoC传输带宽信息、组件内存
- ACL_PROF_LLC_MODE:LLC Profiling采集事件。要求同时设置ACL_PROF_SYS_HARDWARE_MEM_FREQ。可以设置为:
- Atlas 200/300/500 推理产品:
- capacity:采集AI CPU和Control CPU的LLC capacity数据。
- bandwidth:采集LLC bandwidth。默认值为capacity。
- Atlas 推理系列产品(Ascend 310P处理器):
- read:读事件,三级缓存读速率。
- write:写事件,三级缓存写速率。默认为read。
- Atlas 训练系列产品:
- read:读事件,三级缓存读速率。
- write:写事件,三级缓存写速率。默认为read。
- read:读事件,三级缓存读速率。
- write:写事件,三级缓存写速率。默认为read。
- Atlas A2训练系列产品:
- read:读事件,三级缓存读速率。
- write:写事件,三级缓存写速率。默认为read。
- ACL_PROF_SYS_IO_FREQ:NIC(Atlas 200/300/500 推理产品)(Atlas 训练系列产品)、ROCE(Atlas 训练系列产品)(Atlas A2训练系列产品)采集频率,范围[1,100]。
容器场景下本参数不生效。
- ACL_PROF_SYS_INTERCONNECTION_FREQ:集合通信带宽数据(HCCS)(Atlas 训练系列产品)(Atlas A2训练系列产品)、PCIe数据(Atlas 推理系列产品(Ascend 310P处理器))(Atlas 训练系列产品)(Atlas A2训练系列产品)采集频率以及片间传输带宽信息采集频率,范围[1,50]。
- ACL_PROF_DVPP_FREQ:DVPP采集频率,范围[1,100]。
- ACL_PROF_HOST_SYS:Host侧进程级别的性能数据采集开关,取值包括cpu和mem。
- ACL_PROF_HOST_SYS_USAGE:Host侧系统和所有进程的性能数据采集开关,取值包括cpu和mem。
- ACL_PROF_HOST_SYS_USAGE_FREQ:CPU利用率、内存利用率的采集频率,范围[1,50]。
|
config |
输入 |
指定配置项参数值。 |
configLength |
输入 |
config的长度,单位为Byte,最大长度不超过256字节。 |