Querying Interface and VLAN Counters and Statistics

The NX-API REST provides HTTP GET requests that query interface statistics and VLAN statistics. The information returned from these queries is useful in monitoring the performance of the switch.

Querying RMON Dot3 Ethernet Statistics

Querying RMON Dot3 Ethernet Statistics

GET http://<IP_Address>/api/node/mo/sys/intf/phys-[eth3/2]/dbgDot3Stats.json

{
    "rmonDot3Stats": {
        "attributes": {
            "alignmentErrors": "0",
            "babble": "0",
            "carrierSenseErrors": "0",
            "childAction": "",
            "clearTs": "never",
            "controlInUnknownOpcodes": "0",
            "deferredTransmissions": "0",
            "dn": "sys/intf/phys-[eth3/2]/dbgDot3Stats",
            "excessiveCollisions": "0",
            "fCSErrors": "0",
            "frameTooLongs": "0",
            "inPauseFrames": "0",
            "inputdribble": "0",
            "internalMacReceiveErrors": "0",
            "internalMacTransmitErrors": "0",
            "lateCollisions": "0",
            "lostCarrierErrors": "0",
            "modTs": "never",
            "multipleCollisionFrames": "0",
            "noCarrierErrors": "0",
            "outPauseFrames": "0",
            "runts": "0",
            "sQETTestErrors": "0",
            "singleCollisionFrames": "0",
            "status": "",
            "symbolErrors": "0"
        }
    }
}

The HTTP request shown in this section shows how to query RMON Dot3 Ethernet Statistics for a specified Ethernet interface. For detailed information on Dot3 Ethernet Statistics, see RFC 3635, " Definitions of Managed Objects for the Ethernet-like Interface Types" at the following URL.

https://tools.ietf.org/html/rfc3635

Note: The property information for this example was added in Release 9.3(3).

rmonDot3Stats Properties

The following table contains information about the rmonDot3Stats properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Querying Ethernet Statistics

Querying Ethernet Statistics

GET http://<IP_Address>/api/node/mo/sys/intf/phys-[eth1/1]/dbgEtherStats.json

{
    "totalCount": "1",
    "imdata": [
        {
            "rmonEtherStats": {
                "attributes": {
                    "broadcastPkts": "0",
                    "cRCAlignErrors": "0",
                    "childAction": "",
                    "clearTs": "never",
                    "collisions": "0",
                    "dn": "sys/intf/phys-[eth1/1]/dbgEtherStats",
                    "dropEvents": "0",
                    "fragments": "0",
                    "ifdowndrop": "0",
                    "ignored": "0",
                    "jabbers": "0",
                    "modTs": "never",
                    "multicastPkts": "0",
                    "octets": "0",
                    "overrun": "0",
                    "oversizePkts": "0",
                    "pkts": "0",
                    "pkts1024to1518Octets": "0",
                    "pkts128to255Octets": "0",
                    "pkts256to511Octets": "0",
                    "pkts512to1023Octets": "0",
                    "pkts64Octets": "0",
                    "pkts65to127Octets": "0",
                    "rXNoErrors": "0",
                    "rxOversizePkts": "0",
                    "status": "",
                    "tXNoErrors": "0",
                    "txOversizePkts": "0",
                    "underrun": "0",
                    "undersizePkts": "0",
                    "watchdog": "0"
                }
            }
        }
    ]
}

The example in this section queries Ethernet statistics for interrace eth1/1. For a description of the Ethernet statistics, see RFC 2819 at the following URL:

https://tools.ietf.org/html/rfc2819

Note: The property information for this example was added in Release 9.3(3).

rmonEtherStats Properties

The following table contains information about the rmonEtherStats properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Querying RMON High Capacity Interface Input Statistics

Querying RMON High Capacity Interface Input Statistics

GET http://<IP_Address>/api/node/mo/sys/intf/phys-[eth1/1]/dbgIfHCIn.json

{
    "totalCount": "1",
    "imdata": [
        {
            "rmonIfHCIn": {
                "attributes": {
                    "broadcastPkts": "0",
                    "childAction": "",
                    "clearTs": "never",
                    "dn": "sys/intf/phys-[eth1/1]/dbgIfHCIn",
                    "modTs": "never",
                    "multicastPkts": "0",
                    "octets": "0",
                    "status": "",
                    "ucastPkts": "0"
                }
            }
        }
    ]
}

The example in this section queries high capacity interface input statistics for interface eth1/1.

Note: The property information for this example was added in Release 9.3(3).

rmonIfHCIn Properties

The following table contains information about the rmonIfHCIn properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Querying RMON High Capacity Interface Output Statistics

Querying RMON High Capacity Interface Output Statistics

GET http://<IP_Address>/api/node/mo/sys/intf/phys-[eth1/1]/dbgIfHCOut.json

{
    "totalCount": "1",
    "imdata": [
        {
            "rmonIfHCOut": {
                "attributes": {
                    "broadcastPckts": "0",
                    "broadcastPkts": "0",
                    "childAction": "",
                    "clearTs": "never",
                    "dn": "sys/intf/phys-[eth1/1]/dbgIfHCOut",
                    "modTs": "never",
                    "multicastPkts": "0",
                    "octets": "0",
                    "status": "",
                    "ucastPkts": "0"
                }
            }
        }
    ]
}

The example in this section queries high capacity interface output statistics for interface eht1/1.

Note: The property information for this example was added in Release 9.3(3).

rmonIfHCOut Properties

The following table contains information about the rmonIfHCOut properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Querying Interface Input Counters

Querying Interface Input Counters

GET http://172.31.200.187/api/node/mo/sys/intf/phys-[eth1/1]/dbgIfIn.json

{
    "totalCount": "1",
    "imdata": [
        {
            "rmonIfIn": {
                "attributes": {
                    "broadcastPkts": "0",
                    "childAction": "",
                    "clearTs": "never",
                    "discards": "0",
                    "dn": "sys/intf/phys-[eth1/1]/dbgIfIn",
                    "errors": "0",
                    "modTs": "never",
                    "multicastPkts": "0",
                    "nUcastPkts": "0",
                    "noBuffer": "0",
                    "octetRate": "0",
                    "octets": "0",
                    "packetRate": "0",
                    "rateInterval": "738263040",
                    "status": "",
                    "ucastPkts": "0",
                    "unknownEtype": "0",
                    "unknownProtos": "0"
                }
            }
        }
    ]
}

The example in this section queries interface input counters for interface eth1/1.

Note: The property information for this example was added in Release 9.3(3).

rmonIfIn Properties

The following table contains information about the rmonIfIn properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Querying Interface Output Counters

Querying Interface Output Counters

GET http://<IP_Address>/api/node/mo/sys/intf/phys-[eth1/1]/dbgIfOut.json

{
    "totalCount": "1",
    "imdata": [
        {
            "rmonIfOut": {
                "attributes": {
                    "broadcastPkts": "0",
                    "childAction": "",
                    "clearTs": "never",
                    "discards": "0",
                    "dn": "sys/intf/phys-[eth1/1]/dbgIfOut",
                    "errors": "0",
                    "modTs": "never",
                    "multicastPkts": "0",
                    "nUcastPkts": "0",
                    "octetRate": "0",
                    "octets": "0",
                    "packetRate": "0",
                    "qLen": "0",
                    "rateInterval": "738263040",
                    "status": "",
                    "ucastPkts": "0"
                }
            }
        }
    ]
}

Note: The property information for this example was added in Release 9.3(3).

rmonIfOut Properties

The following table contains information about the rmonIfOut properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Querying VLAN Statistics

Querying VLAN Statistics

GET http://<IP_Address>/api/node/mo/sys/bd/bd-[vlan-1].json?query-target=subtree

{
    "totalCount": "3",
    "imdata": [
        {
            "l2EpRetPol": {
                "attributes": {
                    "bounceAgeIntvl": "630",
                    "bounceTrig": "protocol",
                    "childAction": "",
                    "descr": "",
                    "dn": "sys/bd/bd-[vlan-1]/epret",
                    "holdIntvl": "300",
                    "lcOwn": "local",
                    "localEpAgeIntvl": "900",
                    "modTs": "2015-08-06T17:51:01.934+00:00",
                    "moveFreq": "256",
                    "name": "",
                    "remoteEpAgeIntvl": "300",
                    "status": ""
                }
            }
        },
        {
            "l2VlanStats": {
                "attributes": {
                    "childAction": "",
                    "clearTs": "never",
                    "dn": "sys/bd/bd-[vlan-1]/dbgVlanStats",
                    "inBcastOctets": "0",
                    "inBcastPkts": "0",
                    "inL3UcastOctets": "0",
                    "inL3UcastPkts": "0",
                    "inMcastOctets": "0",
                    "inMcastPkts": "0",
                    "inUcastOctets": "0",
                    "inUcastPkts": "0",
                    "modTs": "never",
                    "outUcastOctets": "0",
                    "outUcastPkts": "0",
                    "status": ""
                }
            }
        },
        {
            "l2BD": {
                "attributes": {
                    "accEncap": "unknown",
                    "adminSt": "active",
                    "bdDefDn": "",
                    "bridgeMode": "mac",
                    "childAction": "",
                    "createTs": "1970-01-01T00:00:00.000+00:00",
                    "ctrl": "",
                    "dn": "sys/bd/bd-[vlan-1]",
                    "epOperSt": "",
                    "fabEncap": "vlan-1",
                    "fwdCtrl": "mdst-flood",
                    "fwdMode": "bridge,route",
                    "hwId": "0",
                    "id": "1",
                    "lcOwn": "local",
                    "modTs": "2015-08-06T17:51:01.934+00:00",
                    "mode": "CE",
                    "monPolDn": "",
                    "name": "",
                    "operSt": "down",
                    "pcTag": "any",
                    "status": "",
                    "type": "bd-regular",
                    "unkMacUcastAct": "proxy",
                    "unkMcastAct": "flood",
                    "vlanmgrCfgFailedBmp": "",
                    "vlanmgrCfgFailedTs": "00:00:00:00.000",
                    "vlanmgrCfgState": "0"
                }
            }
        }
    ]
}

You can also query VLAN statistics objects for a specified VLAN. The example in this section queries the VLAN statistics objects for VLAN-1.

Note: The property information for this example was added in Release 9.3(3).

l2EpRetPol Properties

The following table contains information about the l2EpRetPol properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

l2VlanStats Properties

The following table contains information about the l2VlanStats properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

l2BD Properties

The following table contains information about the l2BD properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Querying SVI Statistics

Querying SVI Statistics

GET http://172.31.200.187/api/node/mo/sys/intf/svi-[vlan30].json

{
  "sviIf": {
    "attributes": {
      "adminSt": "up",
      "autostate": "yes",
      "bw": "1000000",
      "carDel": "100",
      "childAction": "",
      "ctrlrId": "",
      "delay": "1",
      "descr": "",
      "dn": "sys/intf/svi-[vlan30]",
      "id": "vlan30",
      "inbMgmt": "no",
      "iod": "3",
      "loadIntvl1": "60",
      "loadIntvl2": "300",
      "loadIntvl3": "60",
      "mac": "64:3A:EA:32:7D:79",
      "medium": "bcast",
      "modTs": "2021-07-13T23:23:03.020+00:00",
      "mtu": "1500",
      "mtuInherit": "yes",
      "name": "",
      "operSt": "up",
      "operStQual": "unknown",
      "snmpTrap": "yes",
      "status": "",
      "vlanId": "30",
      "vlanT": "bd-regular"
    },
    "children": [
      {
        "nwRtVrfMbr": {
          "attributes": {
            "childAction": "",
            "dn": "sys/intf/svi-[vlan30]/rtvrfMbr",
            "l3vmCfgFailedBmp": "",
            "l3vmCfgFailedTs": "0",
            "l3vmCfgState": "0",
            "modTs": "2021-07-13T23:23:02.864+00:00",
            "parentSKey": "unspecified",
            "status": "",
            "tCl": "l3Inst",
            "tDn": "sys/inst-default",
            "tSKey": ""
          }
        }
      },
      {
        "rmonIfIn": {
          "attributes": {
            "broadcastPkts": "0",
            "clearTs": "never",
            "discards": "0",
            "dn": "sys/intf/svi-[vlan30]/dbgIfIn",
            "errors": "0",
            "modTs": "2021-07-16T06:21:04.727+00:00",
            "multicastPkts": "0",
            "nUcastPkts": "0",
            "noBuffer": "0",
            "octetRate": "0",
            "octets": "2120",
            "packetRate": "0",
            "rateInterval": "0",
            "ucastPkts": "20",
            "unknownEtype": "0",
            "unknownProtos": "0"
          }
        }
      },
      {
        "rmonIfOut": {
          "attributes": {
            "broadcastPkts": "0",
            "clearTs": "never",
            "discards": "0",
            "dn": "sys/intf/svi-[vlan30]/dbgIfOut",
            "errors": "0",
            "modTs": "2021-07-16T06:21:04.727+00:00",
            "multicastPkts": "0",
            "nUcastPkts": "0",
            "octetRate": "0",
            "octets": "0",
            "packetRate": "0",
            "qLen": "0",
            "rateInterval": "0",
            "ucastPkts": "0"
          }
        }
      },
      {
        "sviOperSvi": {
          "attributes": {
            "adminSt": "up",
            "dn": "sys/intf/svi-[vlan30]/svi",
            "ifIndex": "151060510",
            "iod": "3",
            "modTs": "2021-07-15T19:13:49.938+00:00",
            "operAutoState": "yes",
            "operBw": "1000000",
            "operCarrierDelayMsec": "100",
            "operCarrierDelaySec": "0",
            "operDelay": "1",
            "operDescr": "",
            "operLastChgSec": "1626376429",
            "operLastChgUsec": "938381",
            "operLoadIntvl1": "60",
            "operLoadIntvl2": "300",
            "operLoadIntvl3": "60",
            "operMac": "64:3A:EA:32:7D:79",
            "operMtu": "1500",
            "operStQual": "unknown"
          }
        }
      }
    ]
  }
}

The example in this section queries SVI Statistics for interface vlan 30.

Note: The property information for this example was added in Release 10.2(1)F.

rmonIfIn Properties

The following table contains information about the rmonIfIn properties in the DME payload that are relevant for the SVI. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Querying Interface Queuing Counters

Querying Interface Queuing Counters

POST https://{{host}}/api/node/mo/sys/ipqos/queuing/policy/out/intf-[eth1/40]/queCmap-c-out-8q-q3-stats-queuing.json

{
    "totalCount": "1",
    "imdata": [
        {
            "ipqosQueuingStats": {
                "attributes": {
                    "cmapName": "c-out-8q-q3",
                    "currQueueDepth": "1466400",
                    "dn": "sys/ipqos/queuing/policy/out/intf-[eth1/40]/queCmap-c-out-8q-q3-stats-queuing",
                    "dropBytes": "376179900",
                    "dropPackets": "125393300",
                    "ingQDepthBytes": "91104",
                    "ingQDropPackets": "783978242",
                    "maxQueueDepth": "0",
                    "modTs": "2021-07-15T09:26:41.822+00:00",
                    "pfcRxPpp": "919199",
                    "pfcTxPpp": "5196435",
                    "pfcwdFlushedPackets": "0",
                    "pfcwdRestoredCount": "0",
                    "pfcwdShutdownCount": "0",
                    "pmapName": "queuint_qLink1",
                    "randDropBytes": "0",
                    "randDropPackets": "0",
                    "randEcnMarkedPackets": "0",
                    "statType": "queuing",
                    "txBytes": "1127003856000",
                    "txPackets": "1127003856"
                }
            }
        }
    ]
}


POST https://{{host}}/api/node/mo/sys/ipqos/queuing/policy/in/intf-[eth1/40]/queCmap-c-in-q3-stats-queuing.json 

Response:
{
    "totalCount": "1",
    "imdata": [
        {
            "ipqosQueuingStats": {
                "attributes": {
                    "cmapName": "c-in-q3",
                    "currQueueDepth": "0",
                    "dn": "sys/ipqos/queuing/policy/in/intf-[eth1/40]/queCmap-c-in-q3-stats-queuing",
                    "dropBytes": "0",
                    "dropPackets": "0",
                    "ingQDepthBytes": "91104",
                    "ingQDropPackets": "793466348",
                    "maxQueueDepth": "0",
                    "modTs": "2021-07-15T09:44:29.537+00:00",
                    "pfcRxPpp": "929876",
                    "pfcTxPpp": "5260067",
                    "pfcwdFlushedPackets": "0",
                    "pfcwdRestoredCount": "0",
                    "pfcwdShutdownCount": "0",
                    "pmapName": "ing_queue_qLink1",
                    "randDropBytes": "0",
                    "randDropPackets": "0",
                    "randEcnMarkedPackets": "0",
                    "statType": "queuing",
                    "txBytes": "0",
                    "txPackets": "0"
                }
            }
        }
    ]
}

Request:

<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="101">
  <get>
  <filter>
    <System xmlns="http://cisco.com/ns/yang/cisco-nx-os-device">
      <ipqos-items>
        <queuing-items>
          <policy-items>
            <out-items>
              <intf-items>
                <If-list>
                  <name>eth1/40</name>
                  <queCmap-items>
                    <QueuingStats-list>
                      <cmapName>c-out-8q-q3</cmapName>
                      <statType>queuing</statType>
                    </QueuingStats-list>
                  </queCmap-items>
                </If-list>
              </intf-items>
            </out-items>
          </policy-items>
        </queuing-items>
      </ipqos-items>
    </System>
  </filter>
</get>
</rpc>


Response:

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="2">
  <data>
    <System xmlns="http://cisco.com/ns/yang/cisco-nx-os-device">
      <ipqos-items>
        <queuing-items>
          <policy-items>
            <out-items>
              <intf-items>
                <If-list>
                  <name>eth1/40</name>
                  <queCmap-items>
                    <QueuingStats-list>
                      <cmapName>c-out-8q-q3</cmapName>
                      <statType>queuing</statType>
                      <currQueueDepth>1466400</currQueueDepth>
                      <dropBytes>376179900</dropBytes>
                      <dropPackets>125393300</dropPackets>
                      <ingQDepthBytes>91104</ingQDepthBytes>
                      <ingQDropPackets>783978242</ingQDropPackets>
                      <pfcRxPpp>919199</pfcRxPpp>
                      <pfcTxPpp>5196435</pfcTxPpp>
                      <pfcwdFlushedPackets>0</pfcwdFlushedPackets>
                      <pfcwdRestoredCount>0</pfcwdRestoredCount>
                      <pfcwdShutdownCount>0</pfcwdShutdownCount>
                      <pmapName>queuint_qLink1</pmapName>
                      <randEcnMarkedPackets>0</randEcnMarkedPackets>
                      <txBytes>1127003856000</txBytes>
                      <txPackets>1127003856</txPackets>
                    </QueuingStats-list>
                  </queCmap-items>
                </If-list>
              </intf-items>
            </out-items>
          </policy-items>
        </queuing-items>
      </ipqos-items>
    </System>
  </data>
</rpc-reply>



Request:

<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="101">
  <get>
  <filter>
    <System xmlns="http://cisco.com/ns/yang/cisco-nx-os-device">
      <ipqos-items>
        <queuing-items>
          <policy-items>
            <in-items>
              <intf-items>
                <If-list>
                  <name>eth1/40</name>
                  <queCmap-items>
                    <QueuingStats-list>
                      <cmapName>c-in-q3</cmapName>
                      <statType>queuing</statType>
                    </QueuingStats-list>
                  </queCmap-items>
                </If-list>
              </intf-items>
            </in-items>
          </policy-items>
        </queuing-items>
      </ipqos-items>
    </System>
  </filter>
</get>
</rpc>



Response:
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="2">
  <data>
    <System xmlns="http://cisco.com/ns/yang/cisco-nx-os-device">
      <ipqos-items>
        <queuing-items>
          <policy-items>
            <in-items>
              <intf-items>
                <If-list>
                  <name>eth1/40</name>
                  <queCmap-items>
                    <QueuingStats-list>
                      <cmapName>c-in-q3</cmapName>
                      <statType>queuing</statType>
                      <currQueueDepth>0</currQueueDepth>
                      <dropBytes>0</dropBytes>
                      <dropPackets>0</dropPackets>
                      <ingQDepthBytes>91104</ingQDepthBytes>
                      <ingQDropPackets>793466348</ingQDropPackets>
                      <pfcRxPpp>929876</pfcRxPpp>
                      <pfcTxPpp>5260067</pfcTxPpp>
                      <pfcwdFlushedPackets>0</pfcwdFlushedPackets>
                      <pfcwdRestoredCount>0</pfcwdRestoredCount>
                      <pfcwdShutdownCount>0</pfcwdShutdownCount>
                      <pmapName>ing_queue_qLink1</pmapName>
                      <randEcnMarkedPackets>0</randEcnMarkedPackets>
                      <txBytes>0</txBytes>
                      <txPackets>0</txPackets>
                    </QueuingStats-list>
                  </queCmap-items>
                </If-list>
              </intf-items>
            </in-items>
          </policy-items>
        </queuing-items>
      </ipqos-items>
    </System>
  </data>
</rpc-reply>

The example in this section queries interface queuing counters for interface eth1/40, QoS Group 3.

Note: The property information for this example was added in Release 10.2(1)F.

ipqosQueuingStats Properties

The following table contains information about the QueuingStats properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Querying Hardware Debug Counters

Querying Hardware Debug Counters

Request:

<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="101">
  <get>
    <filter>
      <System xmlns="http://cisco.com/ns/yang/cisco-nx-os-device">
        <ipqos-items>
          <module_type-items>
            <Module-list>
              <hwcounters-items/>
            </Module-list>
          </module_type-items>
        </ipqos-items>
      </System>
    </filter>
  </get>
</rpc>


Response:

<?xml version="1.0" ?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:4ed8663f-0ceb-4ddb-9708-abb14c24b59b">
  <data>
    <System xmlns="http://cisco.com/ns/yang/cisco-nx-os-device">
      <ipqos-items>
        <module_type-items>
          <Module-list>
            <moduleType>LC</moduleType>
            <moduleId>1</moduleId>
            <asicInstance>0</asicInstance>
            <hwcounters-items>
              <hardwareCounter1>110</hardwareCounter1>
              <hardwareCounter10>100100</hardwareCounter10>
              <hardwareCounter10Desc>If the memory blocks are overwhelmed, then this counter accounts for the drops due to any Backpressure.</hardwareCounter10Desc>
              <hardwareCounter11>1111</hardwareCounter11>
              <hardwareCounter11Desc>This counter accounts for the truncated MTU packets.</hardwareCounter11Desc>
              <hardwareCounter12>1212</hardwareCounter12>
              <hardwareCounter12Desc>This counter accounts for the truncated packets due to any backpressure in the BMM.</hardwareCounter12Desc>
              <hardwareCounter13>2370</hardwareCounter13>
              <hardwareCounter13Desc>This counter accounts for the CPU pool group occupancy drops.</hardwareCounter13Desc>
              <hardwareCounter14>3230</hardwareCounter14>
              <hardwareCounter14Desc>This counter accounts for the LCPU pool group occupancy drops.</hardwareCounter14Desc>
              <hardwareCounter15>4542</hardwareCounter15>
              <hardwareCounter15Desc>This counter accounts for the RCPU pool group occupancy drops.</hardwareCounter15Desc>
              <hardwareCounter16>6843</hardwareCounter16>
              <hardwareCounter16Desc>This counter accounts for the SPAN pool group occupancy drops.</hardwareCounter16Desc>
              <hardwareCounter1Desc>Memory refers to the entire storage of the slice. This counter accounts for any overflow in the memory block of the slice.</hardwareCounter1Desc>
              <hardwareCounter2>220</hardwareCounter2>
              <hardwareCounter2Desc>This counter refers to the overflow in the descriptors for the memory block for the slice. The memory descriptors are used for multicast packets.</hardwareCounter2Desc>
              <hardwareCounter3>330</hardwareCounter3>
              <hardwareCounter3Desc>This counter accounts for the overflow in Drop PG descriptors (used for multicast).</hardwareCounter3Desc>
              <hardwareCounter4>440</hardwareCounter4>
              <hardwareCounter4Desc>This counter accounts for the overflow in the CPU PG memory.</hardwareCounter4Desc>
              <hardwareCounter5>550</hardwareCounter5>
              <hardwareCounter5Desc>This counter accounts for the overflow in the CPU PG descriptors for multicast traffic.</hardwareCounter5Desc>
              <hardwareCounter6>660</hardwareCounter6>
              <hardwareCounter6Desc>This counter accounts for the overflow in the SPAN PG memory.</hardwareCounter6Desc>
              <hardwareCounter7>770</hardwareCounter7>
              <hardwareCounter7Desc>This counter accounts for the overflow in the SPAN PG descriptors for multicast traffic.</hardwareCounter7Desc>
              <hardwareCounter8>880</hardwareCounter8>
              <hardwareCounter8Desc>The descriptors are used for only multicast traffic the OPOOL descriptor drop reasons refers to the overflow in descriptors for the Multicast Pool in Drop PG.</hardwareCounter8Desc>
              <hardwareCounter9>990</hardwareCounter9>
              <hardwareCounter9Desc>These descriptors account for the MC/UC queue drops.</hardwareCounter9Desc>
            </hwcounters-items>
          </Module-list>
        </module_type-items>
      </ipqos-items>
    </System>
  </data>
</rpc-reply>

This section illustrates hardware counter debug queries and provides information on the hardware statistics which are displayed per module ID and per ASIC.

Note: For this example, support properties 1 to 12 were added in 10.2(3)F and 13 to 16 are added in 10.3(1)F.

ipqosHardwareStats Properties

The following table contains information about the hardware counter properties:

The following table contains information about the SPAN/CPU counters:

Querying CPU Tx and Tail Drop Counters

Querying CPU Tx and Tail Drop Counters

Request:

GET : /api/mo/sys/ipqos/queuing/policy/out/intf-[eth1/13]/stats-cpu-queue.json


Response:

{
  "totalCount": "1",
  "imdata": [
    {
      "ipqosCpuSpanStats": {
        "attributes": {
          "dn": "sys/ipqos/queuing/policy/out/intf-[eth1/13]/stats-cpu-queue",
          "dropBytes": "0",
          "dropPackets": "0",
          "modTs": "2022-06-29T14:59:28.291+00:00",
          "statType": "cpu-queue",
          "txBytes": "0",
          "txPackets": "0"
        }
      }
    }
  ]
}

Querying SPAN Tx and Tail Drop Counters

Querying SPAN Tx and Tail Drop Counters

Request:

GET: /api/mo/sys/ipqos/queuing/policy/out/intf-[eth1/13]/stats-span-queue.json


Response: 
{
  "totalCount": "1",
  "imdata": [
    {
      "ipqosCpuSpanStats": {
        "attributes": {
          "dn": "sys/ipqos/queuing/policy/out/intf-[eth1/13]/stats-span-queue",
          "dropBytes": "0",
          "dropPackets": "0",
          "modTs": "2022-06-29T14:59:28.291+00:00",
          "statType": "span-queue",
          "txBytes": "0",
          "txPackets": "0"        
        }
      }
    }
  ]
}

Related Documentation

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html