cancel
Showing results for 
Search instead for 
Did you mean: 
cancel
40072
Views
5
Helpful
4
Comments
Julie Burruss
Level 4
Level 4

The "history" command is new with 15.1T. This, along with the new "show interface history" command, allows an interface to maintain utilization history in a graphical format similar to CPU history.

This history can be maintained as either packets per second (pps) or bit per second (bps). Along with the rate, the user can monitor the many/various interface counters. As with CPU history, there are graphs for the last 60 seconds, last 60 minutes and last 72 hours. Separate graphs are maintained for input and output. This is a total of 6 graphs.

This allows the Technical Assistance Center (TAC) to be able to look back in time at the interface(s) in question and see rates and counters. Problems in the network can then be investigated and determined if they relate to an interface and the counter(s) that are being incremented at that time interval.

The show interface history command allows a display of all 6 graphs or only a subset based on needs:

show interface [type number] history [all | 60sec | 60min | 72hour] [both | input | output] Syntax Description

type

(Optional) Interface type.

number

(Optional) Port number of the interface.

all

(Optional) Specifies the histograms representing the last 60 seconds, the last 60 minutes, and the last 72 hours of interface utilization.

60sec

(Optional) Specifies the histograms representing the last 60 seconds of interface utilization.

60min

(Optional) Specifies the histograms representing the last 60 minutes of interface utilization.

72hour

(Optional) Specifies the histograms representing the last 72 hours of interface utilization.

both

(Optional) Specifies both the input histograms and the output histograms.

input

(Optional) Specifies the input histograms.

output

(Optional) Specifies the output histograms.

Example:

The following was configured under gigabitethernet 0/1:

    history BPS input-drops output-drops unknown-protocol-drops multicast

Router# show interface gigabitethernet 0/1 history 60min

          5689688755455324777665666876546

       10

        9    *

        8   ** **                  *

        7   *# ##*        ***      #*

        6  *######        ####* **###*  *

        5 ########## *#   ############* *

        4 #############  *#############**

        3 ############## ###############*

        2 ###############################

        1 ###############################

         0....5....1....1....2....2....3....3....4....4....5....5....6

                   0    5    0    5    0    5    0    5    0    5    0

          3333333333333333333333333333331

    Mlcst 556555555565555555555565535555700000000000000000000000000000

          22322111111     121221211211

          57149774766867 133175814422022

    iDrop 425727636924219265454496840996600000000000000000000000000000

          GigabitEthernet0/1 input rate(mbits/sec)  (last 60 minutes)

                  * = maximum   # = average

          5677678656555434767665666866545

       10

        9

        8       *                  *

        7   ** *#         * *      *

        6  *#####* *      ##*** ***##*

        5 *#########***   #####*######* *

        4 #############* *#############**

        3 #############**###############*

        2 ###############################

        1 ###############################

         0....5....1....1....2....2....3....3....4....4....5....5....6

                   0    5    0    5    0    5    0    5    0    5    0

    Unkno 000000000000000000000000000000000000000000000000000000000000

    oDrop 000000000000000000000000000000000000000000000000000000000000

          GigabitEthernet0/1 output rate(mbits/sec)  (last 60 minutes)

                  * = maximum   # = average

Explanation of the above:

The input rate histogram shows that the input rate peaked at 9 Mbps at 4 minutes prior to the command execution. During that one-minute interval, there were 35 input multicast packets and 247 input drops. The counter values in the histogram should be read vertically.

The output rate histogram shows that the output rate reached 8 Mbps twice; once 7 minutes prior and the second time 26 minutes prior to the command execution. There were no unknown protocol drops and no output drops during the last 60 minutes.

show interfaces history *is* included in the show tech-support. So if it's configured you will get the output in the show tech.

Comments
bhilgenkamp
Level 1
Level 1

This seems like a great feature, however I get no results when trying to use it on an ISR4331 or Catalyst 2960X. Does this need to be enabled in some way or should it just work by default?

bhilgenkamp
Level 1
Level 1

NM, I missed the part about the interface needing to be configured first with the "history" command

Ric Hernandez
Level 1
Level 1


Not Sure if this has been answered, but you have to configure the interface with the history command and any options you want.

 

ROUTER1(config)#int s1/0/0
ROUTER1(config-if)#history bps/pps ?
  all                         Include all counters
  crcs                        Include CRCs - CRCs
  dribbles                    Include dribbles - Dribl
  flushes                     Include flushes - Flush
  frame-errors                Include frame errors - FrErr
  giants                      Include giants - Giant
  ignored                     Include ignored - Ignor
  input-broadcasts            Include input broadcasts - iBcst
  input-drops                 Include input drops - iDrop
  input-errors                Include input errors - iErr
  interface-resets            Include interface resets - IRset
  output-broadcasts           Include output broadcasts - oBcst
  output-buffer-failures      Include output buffer failures - oBufF
  output-buffers-swapped-out  Include output buffers swapped out - oBSwO
  output-drops                Include output drops - oDrop
  output-errors               Include output errors - oErr
  output-no-buffer            Include output no buffer - oNoBf
  overruns                    Include overruns - OvrRn
  runts                       Include runts - Runts
  throttles                   Include throttles - Thrtl
  underruns                   Include underruns - UndRn
  unknown-protocol-drops      Include unknown protocol drops - Unkno
  <cr>

edsiew1971
Level 1
Level 1

What does the very top part of the command output show?

 

In your example, it'd be the string of numbers  "5689688755455324777665666876546"

Getting Started

Find answers to your questions by entering keywords or phrases in the Search bar above. New here? Use these resources to familiarize yourself with the community:

Innovations in Cisco Full Stack Observability - A new webinar from Cisco