Function: Get_device_utilization_rate

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

C Prototype

aclError aclrtGetDeviceUtilizationRate(int32_t deviceId, aclrtUtilizationInfo *utilizationInfo)

Python Function

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

Parameter	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.

Parameter

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	Description
utilization_info	Dict, usage information dictionary of the aclrtUtilizationInfo type. For details, see aclrtUtilizationInfo.
ret	Int, error code. 0 on success; else, failure.

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.
The Atlas training product does not have a Vector. When this API is called to query the Vector usage, the returned value is -1.

Parent topic: Device Management