watch

watch command {difference} {count count} {interval interval}

Description

Runs a selected show command at a repeated interval.

Syntax Description

command Specifies the command. Must be enclosed in double quotes.
difference Shows the difference between successive iterations if numerical values have changed in the output.
count Specifies the number of times to run the command.
count Range is 1–4,294,967,295. The default is 3.
interval Specifies the time between command iterations.
interval The interval in seconds. Range is 1–4,294,967,295. The default is 5.

Default

The count default is 3.

The interval defalut is 5.

Usage Guidelines

This command runs the integrated Python script watch.py to run the specified show command periodically and display the output accordingly. In the script, CLI paging is disabled so that user input is not needed, and CLI refreshing is disabled so that the keyword no-refresh is not needed in auto-refreshing commands.

Example

The following example runs the show ports command for port 11 runs 15 times with an interval of 30 seconds:

# watch "show ports 11 statistics port-number no-refresh" count 15 interval 30
Port      Link       Tx Pkt     Tx Byte      Rx Pkt     Rx Byte      Rx Pkt      Rx Pkt      Tx Pkt      Tx Pkt 

          State       Count       Count       Count       Count       Bcast       Mcast       Bcast       Mcast 

========= ===== =========== =========== =========== =========== =========== =========== =========== =========== 

11        A          206845    30061110      205326    30939540           0      163381           0      163483 

========= ===== =========== =========== =========== =========== =========== =========== =========== =========== 

          > in Port indicates Port Display Name truncated past 8 characters 

          > in Count indicates value exceeds column width. Use 'wide' option or '0' to clear. 

          Link State: A-Active, R-Ready, NP-Port Not Present, L-Loopback 

 

Port      Link       Tx Pkt     Tx Byte      Rx Pkt     Rx Byte      Rx Pkt      Rx Pkt      Tx Pkt      Tx Pkt 

          State       Count       Count       Count       Count       Bcast       Mcast       Bcast       Mcast 

========= ===== =========== =========== =========== =========== =========== =========== =========== =========== 

11        A          206845    30061110      205327    30939662           0      163382           0      163483 

========= ===== =========== =========== =========== =========== =========== =========== =========== =========== 

          > in Port indicates Port Display Name truncated past 8 characters 

          > in Count indicates value exceeds column width. Use 'wide' option or '0' to clear. 

          Link State: A-Active, R-Ready, NP-Port Not Present, L-Loopback 

 

Port      Link       Tx Pkt     Tx Byte      Rx Pkt     Rx Byte      Rx Pkt      Rx Pkt      Tx Pkt      Tx Pkt 

          State       Count       Count       Count       Count       Bcast       Mcast       Bcast       Mcast 

========= ===== =========== =========== =========== =========== =========== =========== =========== =========== 

11        A          206847    30061402      205328    30939832           0      163383           0      163485 

========= ===== =========== =========== =========== =========== =========== =========== =========== =========== 

          > in Port indicates Port Display Name truncated past 8 characters 

          > in Count indicates value exceeds column width. Use 'wide' option or '0' to clear. 

          Link State: A-Active, R-Ready, NP-Port Not Present, L-Loopback 

History

This command was first available in ExtremeXOS 31.2.

Platform Availability

This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, and X695 series switches.