昇腾社区首页
中文
注册

函数:get_device_utilization_rate

产品支持情况

产品

是否支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

Atlas 训练系列产品

Atlas 推理系列产品

Atlas 200I/500 A2 推理产品

Atlas 200/300/500 推理产品

功能说明

查询Device上Cube、Vector、AI CPU等的利用率。

函数原型

  • C函数原型
    1
    aclError aclrtGetDeviceUtilizationRate(int32_t deviceId, aclrtUtilizationInfo *utilizationInfo)
    
  • python函数
    1
    utilization_info, ret = acl.rt.get_device_utilization_rate (device_id)
    

参数说明

参数名

说明

device_id

int,Device设备号。

用户调用acl.rt.get_device_count接口获取可用的Device数量后,该Device ID的取值范围为[0, (可用的Device数量-1)]。

返回值说明

返回值

说明

utilization_info

dict,aclrtUtilizationInfo类型利用率信息字典,具体请参见17.43-aclrtUtilizationInfo

ret

int,错误码,返回0表示成功,返回其它值表示失败。

约束说明

  • 昇腾虚拟化实例场景下,不支持调用本接口查询利用率,接口返回值无实际意义。
  • 开启Profiling功能时,不支持调用本接口查询利用率,接口返回值无实际意义。
  • 查询Device内存利用率为预留功能,当前版本不支持,若调用本接口查询内存利用率,查询到的利用率为-1。
  • Atlas 200/300/500 推理产品上没有Vector,调用本接口查询Vector利用率时,查询到的利用率为-1。
  • Atlas 训练系列产品上没有Vector,调用本接口查询Vector利用率时,查询到的利用率为-1。