nx_ifrate

Description

This script is based on Cisco's interface_rate_n7k.py script. It prints interface throughput/packet rate statistics in an easy to read list format on NX-OS platforms. Furthermore, it contains a couple of improvements, for example port-channel and member interfaces are displayed in a structured way, cdp or lldp neighbors are shown and an IO summary is calculated over all ports.

To reduce the table width a filter can be configured which shortens the interface descriptions as well as cdp or lldp hostnames.
event manager environment RMLIST "connected-to-, .mydom.dom, yyy-, zzz"

The script knows five options:

  -d:  list ports with description
  
  -u:  list ports in up state
  
  -r:  adding a column with input/output discards
  
  -n:  looks for cdp neighbor or, if no cdp neighbor, try lldp
  
  -l:  shows load interval used for rate calculation. Default is 30 sec.
  
  -du: any combination of options works as well

Without an option all interfaces are shown. Discards or neighbors columns are not displayed in this case.

To use

1. Copy the script to the Nexus switch directory bootflash:scripts/

2. Execute using:

   source nx_ifrate.py
   

   or

   source nx_ifrate.py -d
   

   or

   source nx_ifrate.py -u
   

3. Configure an alias, e.g.

   cli alias name ifrate source nx_ifrate.py
   

4. Configure a list removing unnessacary characters form interfaces description or the cdp/lldp neighbor hostname

   event manager environment RMLIST "connected-to-, xxx-, yyy-, zzz"
   

The script was tested on N9K using 10.6.1 release. But it should run under every NX release > 10.

Sample output

Leaf# ifrate -d

Collecting and processing interface statistics ...

--------------------------------------------------------------------------------------------------
Port            Descr         State Intvl   Rx Mbps  Rx %   Rx pps    Tx Mbps  Tx %   Tx pps
--------------------------------------------------------------------------------------------------
port-channel1   XXX11 Po1     up    30/30   6.5      0.0%   2002      0.1      0.0%   130
 Ethernet1/1    XXX11 E1/1    up    30/30   4.3      0.0%   920       0.0      0.0%   37
 Ethernet2/1    XXX11 E2/1    up    30/30   2.2      0.0%   1082      0.1      0.0%   93
port-channel12  XXX11 Po12    up    30/30   793.4    1.0%   96501     242.6    0.3%   48320
 Ethernet1/3    XXX11 E1/3    up    30/30   75.8     0.2%   15469     92.4     0.2%   16539
 Ethernet2/3    XXX11 E2/3    up    30/30   717.5    1.8%   81032     150.2    0.4%   31781
port-channel14  XXX12 Po14    up    30/30   510.2    0.6%   79104     680.4    0.9%   83912
 Ethernet1/2    XXX12 E1/2    up    30/30   91.5     0.2%   18344     58.2     0.1%   12981
 Ethernet2/2    XXX12 E2/2    up    30/30   418.8    1.0%   60760     622.2    1.6%   70931

Ethernet1/4     A-link        up    30/30   0.0      0.0%   0         0.0      0.0%   0
Ethernet1/5     B-link        up    30/30   0.0      0.0%   0         0.0      0.0%   0
Ethernet1/6     C-link        up    30/30   0.0      0.0%   0         0.0      0.0%   0
<snip>
--------------------------------------------------------------------------------------------------
IO Summary:                              1310.0                       924.8