DOCA Documentation v2.7.0
1.0

NVIDIA DOCA PCC Counter Tool

This document provides instruction on the usage of the PCC Counter tool.

The PCC Counter tool is used to print PCC-related hardware counters. The output counters help debug the PCC user algorithm embedded in the DOCA PCC application.

DOCA 2.2.0 and higher.

If NVIDIA® BlueField®-3 is operating in DPU mode, the script must be executed on the Arm side. If BlueField-3 is operating in NIC mode, the script must be executed on the host side.

Info

Refer to NVIDIA BlueField Modes of Operation for more information on the DPU's modes of operation.

The following performance counters are supported for PCC:

  • MAD_RTT_PERF_CONT_REQ – the number of RTT requests received in total

  • MAD_RTT_PERF_CONT_RES – the number of RTT responses received in total

  • SX_EVENT_WRED_DROP – the number of TX events dropped due to the CC event queue being full

  • SX_RTT_EVENT_WRED_DROP – the number of "TX event with RTT request sent indication" dropped due to the CC event queue being full

  • ACK_EVENT_WRED_DROP – the number of Ack events dropped due to the CC event queue being full

  • NACK_EVENT_WRED_DROP – the number of Nack events dropped due to the CC event queue being full

  • CNP_EVENT_WRED_DROP – the number of CNP events dropped due to the CC event queue being full

  • RTT_EVENT_WRED_DROP – the number of RTT events dropped due to the CC event queue being full

  • HANDLED_SXW_EVENTS – the number of handled CC events related to SXW

  • HANDLED_RXT_EVENTS – the number of handled CC events related to RXT

  • DROP_RTT_PORT0_REQ – the number of RTT requests dropped in total from port 0

  • DROP_RTT_PORT1_REQ – the number of RTT requests dropped in total from port 1

  • DROP_RTT_PORT0_RES – the number of RTT responses dropped in total from port 0

  • DROP_RTT_PORT1_RES – the number of RTT responses dropped in total from port 1

  • RTT_GEN_PORT0_REQ – the number of RTT requests sent in total from port 0

  • RTT_GEN_PORT1_REQ – the number of RTT requests sent in total from port 1

  • RTT_GEN_PORT0_RES – the number of RTT responses sent in total from port 0

  • RTT_GEN_PORT1_RES – the number of RTT responses sent in total from port 1

  • PCC_CNP_COUNT – the number of CNP received in total, regardless of whether it is handled or ignored

To use the PCC Counter:

  1. Initialize all supported hardware counters. Run:

    Copy
    Copied!
                

    sudo ./pcc_counters.sh set /dev/mst/mt41692_pciconf0

    Info

    Counters are zeroed after each set command.

  2. Query all supported hardware counters. Run:

    Copy
    Copied!
                

    sudo ./pcc_counters.sh query /dev/mst/mt41692_pciconf0

    Info

    The output counters are counted from the time the set command is executed to the time when the query command is issued.

    Example output:

    Copy
    Copied!
                

    sudo ./pcc_counters.sh query /dev/mst/mt41692_pciconf0 -----------------PCC Counters----------------- Counter: MAD_RTT_PERF_CONT_REQ Value: 000000000028b85b Counter: MAD_RTT_PERF_CONT_RES Value: 000000000028b85a Counter: SX_EVENT_WRED_DROP Value: 0000000000000000 Counter: SX_RTT_EVENT_WRED_DROP Value: 0000000000000000 Counter: ACK_EVENT_WRED_DROP Value: 0000000000ccdf4f Counter: NACK_EVENT_WRED_DROP Value: 0000000000000000 Counter: CNP_EVENT_WRED_DROP Value: 0000000000000000 Counter: RTT_EVENT_WRED_DROP Value: 0000000000000000 Counter: HANDLED_SXW_EVENTS Value: 000000000932543a Counter: HANDLED_RXT_EVENTS Value: 000000000028b85c Counter: DROP_RTT_PORT0_REQ Value: 0000000000000000 Counter: DROP_RTT_PORT1_REQ Value: 0000000000000000 Counter: DROP_RTT_PORT0_RES Value: 0000000000000000 Counter: DROP_RTT_PORT1_RES Value: 0000000000000000 Counter: RTT_GEN_PORT0_REQ Value: 0000000000000000 Counter: RTT_GEN_PORT1_REQ Value: 000000000028b85c Counter: RTT_GEN_PORT0_RES Value: 0000000000000000 Counter: RTT_GEN_PORT1_RES Value: 000000000028b85d Counter: PCC_CNP_COUNT Value: 0000000000000000

© Copyright 2024, NVIDIA. Last updated on Aug 15, 2024.