--- title: 函数：set_config description: "| 产品 | 是否支持 |" url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_0849.html sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_0849.html indexId: 8e4226e8cb73734a28c77f8042469904aa98eedffb5fbe6e4909ca6e6f1c2d0c71 --- # 函数：set_config #### 产品支持情况 | 产品 | 是否支持 | | --- | --- | | Atlas 350 加速卡 | √ | | Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ | | Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ | | Atlas 训练系列产品 | √ | | Atlas 推理系列产品 | √ | | Atlas 200I/500 A2 推理产品 | √ | #### 功能说明 acl.prof.create_config接口的扩展接口，用于设置性能数据采集参数。 该接口支持多次调用，用户需要保证数据的一致性和准确性。 #### 函数原型 - C函数原型 1 aclError aclprofSetConfig(aclprofConfigType configType, const char *config, size_t configLength) - python函数 1 ret = acl.prof.set_config(config_type, config) #### 参数说明 | 参数名 | 说明 | | --- | --- | | config\_type | int，作为config\_type参数值。每个常量表示不同采集配置，若要使用该接口下不同的选项采集多种性能数据，则需要多次调用该接口，详细说明如下： ACL\_PROF\_STORAGE\_LIMIT = 1：指定落盘目录允许存放的最大文件容量，有效取值范围为[200, 4294967295]，单位为MB。 ACL\_PROF\_SYS\_HARDWARE\_MEM\_FREQ = 3：片上内存、QoS带宽及内存、LLC的读写带宽数据、acc\_pmu数据和SoC传输带宽信息、组件内存采集频率，范围[1,100]。 ACL\_PROF\_LLC\_MODE = 4：LLC Profiling采集事件。要求同时设置ACL\_PROF\_SYS\_HARDWARE\_MEM\_FREQ。可以设置为： Atlas 推理系列产品 ： read：读事件，三级缓存读速率。 write：写事件，三级缓存写速率。默认为read。 Atlas 训练系列产品 ： read：读事件，三级缓存读速率。 write：写事件，三级缓存写速率。默认为read。 Atlas 200I/500 A2 推理产品 ： read：读事件，三级缓存读速率。 write：写事件，三级缓存写速率。默认为read。 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ： read：读事件，三级缓存读速率。 write：写事件，三级缓存写速率。默认为read。 Atlas A3 训练系列产品 / Atlas A3 推理系列产品 ： read：读事件，三级缓存读速率。 write：写事件，三级缓存写速率。默认为read。 ACL\_PROF\_SYS\_IO\_FREQ = 5：NIC、ROCE采集频率，范围[1,100]，单位hz。 Atlas 200I/500 A2 推理产品 ：支持采集NIC，容器场景参数不生效。 Atlas 训练系列产品 ：支持采集NIC和ROCE。 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ：支持采集NIC和ROCE。 Atlas A3 训练系列产品 / Atlas A3 推理系列产品 ：支持采集NIC和ROCE。 ACL\_PROF\_SYS\_INTERCONNECTION\_FREQ = 6：集合通信带宽数据（HCCS）、PCIe数据采集开关、片间传输带宽信息采集频率，范围[1,50]，单位hz。 Atlas 推理系列产品 ：支持采集PCIe数据。 Atlas 训练系列产品 ：支持采集HCCS、PCIe数据。 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ：支持采集HCCS、PCIe数据、片间传输带宽信息。 Atlas A3 训练系列产品 / Atlas A3 推理系列产品 ：支持采集HCCS、PCIe数据、片间传输带宽信息、SIO数据。 ACL\_PROF\_DVPP\_FREQ：DVPP采集频率，范围[1,100]。 Atlas 推理系列产品 ：支持采集性能数据，暂不支持解析。 ACL\_PROF\_HOST\_SYS = 8：Host侧进程级别的性能数据采集开关，取值包括cpu和mem。 ACL\_PROF\_HOST\_SYS\_USAGE = 9：Host侧系统和所有进程的性能数据采集开关，取值包括cpu和mem。 ACL\_PROF\_HOST\_SYS\_USAGE\_FREQ = 10：CPU利用率、内存利用率的采集频率，范围[1,50]。 | | config | str，配置项的参数值。 | #### 返回值说明 | 返回值 | 说明 | | --- | --- | | ret | int，错误码。 返回0表示成功。 返回其它值表示失败。 | #### 约束说明 先调用acl.prof.set_config接口再调用acl.prof.start接口，可根据需求选择调用该接口。