函数:get_device_utilization_rate

C函数原型

aclError aclrtGetDeviceUtilizationRate(int32_t deviceId, aclrtUtilizationInfo *utilizationInfo)

Python函数

utilization_info, ret = acl.rt.get_device_utilization_rate (device_id)

函数功能

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

输入说明

device_id:int,Device设备号。

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

返回值说明

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

ret:int,错误码。

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

约束说明

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