heimdallr.utilities.nvidia.bindings.nvmlDeviceGetNvLinkUtilizationCounter

heimdallr.utilities.nvidia.bindings.nvmlDeviceGetNvLinkUtilizationCounter(device, link, counter)[source]

Retrieve an NVLINK utilization counter.

Retrieve the NVLINK utilization counter based on the current control for a specified counter. In general it is good practice to use nvmlDeviceSetNvLinkUtilizationControl before reading the utilization counters as they have no default state.

Parameters

  • device – The identifier of the target device

  • link – Specifies the NvLink link to be queried (uint)

  • counter – Specifies the counter that should be set (0 or 1)

Returns

Dictionary with rx key (value is “receive” counter) and tx key (value is “transmit” counter)

Return type

rxtx_dict