Function: Get_device_utilization_rate

C Prototype

aclError aclrtGetDeviceUtilizationRate(int32_t deviceId, aclrtUtilizationInfo *utilizationInfo)

Python Function

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

Function Usage

Queries the usage of the Cube, Vector, and AI CPU on the device.

Input Description

device_id: int, device ID.

Must be in the range of [0, Device count – 1]. Call acl.rt.get_device_count to obtain the device count.

Return Value

utilization_info: dict, usage information dictionary of the aclrtUtilizationInfo type. For details, see aclrtUtilizationInfo.

ret: int, error code.

Restrictions

  • For Ascend virtual instances, this API cannot be called to query the usage, and the returned value has no meaning.
  • When profiling is enabled, this API cannot be called to query the usage, and the returned value has no meaning.
  • Querying the memory usage of a device is a reserved function and is not supported in the current version. If this API is called to query the memory usage, the returned value is -1.
  • There is no vector on the Atlas 200/300/500 Inference Product. When this API is called to query the vector usage, the returned value is -1.
  • There is no vector on the Atlas Training Series Product. When this API is called to query the vector usage, the returned value is -1.