函数：model_subscribe
函数：create_subscribe_config
| C函数原型 | aclprofSubscribeConfig *aclprofCreateSubscribeConfig(int8_t timeInfoSwitch, aclprofAicoreMetrics aicoreMetrics, void *fd) |
|---|---|
| Python函数 | subscribe_config = acl.prof.create_subscribe_config(time_info_switch, aicore_metrics, fd) |
| 函数功能 | 创建aclprofSubscribeConfig类型的数据，表示创建订阅配置信息。同步接口。 如需销毁aclprofSubscribeConfig类型的数据，请参见acl.prof.destroy_subscribe_config。 |
| 输入说明 | time_info_switch：int，是否采集网络模型中算子的性能数据： - 1：采集 - 0：不采集 aicore_metrics：int，表示AI Core性能指标采集项，参考aclprofAicoreMetrics。 （说明：订阅接口目前仅提供算子耗时统计的功能，暂时不支持AicoreMetrics采集功能。） fd：int，用户创建管道的写文件描述符。 用户在调用acl.prof.model_unsubscribe接口后，系统内部会在数据发送结束后，关闭该模型的管道写文件描述符。 |
| 返回值说明 | subscribe_config：int。 - 返回非0值表示成功，返回aclprofSubscribeConfig的地址对象。 - 返回0表示失败。 |
| 约束说明 | - 使用acl.prof.destroy_subscribe_config接口销毁aclprofSubscribeConfig类型的数据，如不销毁会导致内存未被释放。 - 与acl.prof.destroy_subscribe_config接口配对使用，先调用acl.prof.create_subscribe_config接口再调用acl.prof.destroy_subscribe_config接口。 |
父主题： Profiling pyACL API for Subscription（订阅算子信息的Profiling pyACL API）
函数：destroy_subscribe_config
| C函数原型 | aclError aclprofDestroySubscribeConfig(const aclprofSubscribeConfig *profSubscribeConfig) |
|---|---|
| Python函数 | ret = acl.prof.destroy_subscribe_config(subscribe_config) |
| 函数功能 | 销毁aclprofSubscribeConfig类型的数据，只能销毁通过acl.prof.create_subscribe_config接口创建的aclprofSubscribeConfig类型。同步接口。 |
| 输入说明 | subscribe_config：int，待销毁的aclprofSubscribeConfig类型的地址对象。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | - 与acl.prof.create_subscribe_config接口配对使用，先调用acl.prof.create_subscribe_config接口再调用acl.prof.destroy_subscribe_config接口。 - 同一aclprofSubscribeConfig重复调用acl.prof.destroy_subscribe_config接口，会出现重复释放内存的报错。 |
父主题： Profiling pyACL API for Subscription（订阅算子信息的Profiling pyACL API）
函数：model_subscribe
| C函数原型 | aclError aclprofModelSubscribe(uint32_t modelId, const aclprofSubscribeConfig *profSubscribeConfig) |
|---|---|
| Python函数 | ret = acl.prof.model_subscribe(model_id, subscribe_config) |
| 函数功能 | 网络场景下，订阅算子的基本信息，包括算子名称、算子类型、算子执行耗时等。同步接口。 |
| 输入说明 | model_id：int，待订阅的网络模型的ID。调用acl.mdl.load_from_file接口/acl.mdl.load_from_mem接口/acl.mdl.load_from_file_with_mem接口/acl.mdl.load_from_mem_with_mem接口加载模型成功后，会返回模型ID。 subscribe_config：int，待订阅的配置信息。调用acl.prof.create_subscribe_config接口创建配置数据。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 需要与acl.prof.model_unsubscribe接口配对使用。 |
| 参考资源 | 接口调用示例，参见Profiling性能数据采集。 |
父主题： Profiling pyACL API for Subscription（订阅算子信息的Profiling pyACL API）
函数：model_un_subscribe
| C函数原型 | aclError aclprofModelUnSubscribe(uint32_t modelId) |
|---|---|
| Python函数 | ret = acl.prof.model_un_subscribe(model_id) |
| 函数功能 | 网络场景下，取消订阅算子的基本信息，包括算子名称、算子类型、算子执行耗时等。同步接口。 |
| 输入说明 | model_id：int，已订阅的网络模型的ID。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 需要与acl.prof.model_subscribe接口配对使用。 |
| 参考资源 | 接口调用示例，参见Profiling性能数据采集。 |
父主题： Profiling pyACL API for Subscription（订阅算子信息的Profiling pyACL API）
函数：model_unsubscribe
| C函数原型 | aclError aclprofModelUnSubscribe(uint32_t modelId) |
|---|---|
| Python函数 | ret = acl.prof.model_unsubscribe(model_id) |
| 函数功能 | 网络场景下，取消订阅算子的基本信息，包括算子名称、算子类型、算子执行耗时等。同步接口。 |
| 输入说明 | model_id：int，已订阅的网络模型的ID。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 需要与acl.prof.model_subscribe接口配对使用。 |
| 参考资源 | 接口调用示例，参见Profiling性能数据采集。 |
父主题： Profiling pyACL API for Subscription（订阅算子信息的Profiling pyACL API）
函数：get_op_desc_size
| C函数原型 | aclError aclprofGetOpDescSize(size_t *opDescSize) |
|---|---|
| Python函数 | op_desc_size, ret = acl.prof.get_op_desc_size() |
| 函数功能 | 获取单个算子数据结构的大小，单位为Byte。当前版本中约定每个算子数据结构的大小是一样的。同步接口。 建议用户新建一个线程，在新线程内调用该接口，否则可能阻塞主线程中的其它任务调度。 |
| 输入说明 | 无 |
| 返回值说明 | op_desc_size：int，算子数据结构的大小。 ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
| 参考资源 | 接口调用示例，参见Profiling性能数据采集。 |
父主题： Profiling pyACL API for Subscription（订阅算子信息的Profiling pyACL API）
在线提单