image image image image image

On This Page

Commands

stats alarm clear


stats alarm <alarm ID> clear

Clears alarm state.

Syntax Description

alarm ID

Alarms supported by the system, for example:

  • cpu_util_indiv average CPU utilization too high: percent utilization
  • disk_io operating System Disk I/O per second too high: kilobytes per second
  • fs_mnt free filesystem space too low: percent of disk space free
  • intf_util network utilization too high: bytes per second
  • memory_pct_used too much memory in use: percent of physical memory used
  • paging paging activity too high: page faults
  • temperature temperature is too high: degrees

Default

N/A

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats alarm cpu_util_indiv clear
Related Commandsshow stats alarm

Notes


stats alarm enable


stats alarm <alarm-id> enable
no stats alarm <alarm-id> enable

Enables the alarm.
The no form of the command disables the alarm, notifications will not be received.

Syntax Description

alarm ID

Alarms supported by the system, for example:

  • cpu_util_indiv average CPU utilization too high: percent utilization
  • disk_io operating System Disk I/O per second too high: kilobytes per second
  • fs_mnt free filesystem space too low: percent of disk space free
  • intf_util network utilization too high: bytes per second
  • memory_pct_used too much memory in use: percent of physical memory used
  • paging paging activity too high: page faults
  • temperature temperature is too high: degrees

Default

The default is different per alarm-id

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats alarm cpu_util_indiv enable
Related Commandsshow stats alarm

Notes


stats alarm event-repeat


stats alarm <alarm ID> event-repeat {single | while-not-cleared}
no stats alarm <alarm ID> event-repeat

Configures repetition of events from this alarm.
The no form of this command resets this parameter to its default.

Syntax Description

alarm ID

Alarms supported by the system, for example:

  • cpu_util_indiv average CPU utilization too high: percent utilization
  • disk_io operating System Disk I/O per second too high: kilobytes per second
  • fs_mnt free filesystem space too low: percent of disk space free
  • intf_util network utilization too high: bytes per second
  • memory_pct_used too much memory in use: percent of physical memory used
  • paging paging activity too high: page faults
  • temperature temperature is too high: degrees

single

Does not repeat events: only sends one event whenever the alarm changes state.

while-not-cleared

Repeats error events until the alarm clears.

Default

single

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats alarm cpu_util_indiv event-repeat single
Related Commandsshow stats alarm

Notes


stats alarm {rising | falling}


stats alarm <alarm ID> {rising | falling} {clear-threshold | error-threshold} <threshold-value>

Configure alarms thresholds.

Syntax Description

alarm ID

Alarms supported by the system, for example:

  • cpu_util_indiv average CPU utilization too high: percent utilization
  • disk_io operating System Disk I/O per second too high: kilobytes per second
  • fs_mnt free filesystem space too low: percent of disk space free
  • intf_util network utilization too high: bytes per second
  • memory_pct_used too much memory in use: percent of physical memory used
  • paging paging activity too high: page faults
  • temperature temperature is too high: degrees

falling

Configures alarm for when the statistic falls too low

rising

Configures alarm for when the statistic rises too high

error-threshold

Sets threshold to trigger falling or rising alarm

clear-threshold

Sets threshold to clear falling or rising alarm

threshold-value

The desired threshold value, different per alarm

Default

Default is different per alarm-id

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats alarm cpu_util_indiv falling clear-threshold 10
Related Commandsshow stats alarm

Notes

Not all alarms support all four thresholds.

stats alarm rate-limit


stats alarm <alarm ID> rate-limit {count <count-type> <count> | reset | window <window-type> <duration>}

Configures alarms rate limit.

Syntax Description

alarm ID

Alarms supported by the system, for example:

  • cpu_util_indiv average CPU utilization too high: percent utilization
  • disk_io operating System Disk I/O per second too high: kilobytes per second
  • fs_mnt free filesystem space too low: percent of disk space free
  • intf_util network utilization too high: bytes per second
  • memory_pct_used too much memory in use: percent of physical memory used
  • paging paging activity too high: page faults
  • temperature temperature is too high: degrees

count-type

Long medium, or short count (number of alarms)

reset

Set the count and window durations to default values for this alarm

window-type

Long medium, or short count, in seconds

Default

Short window: 5 alarms in 1 hour
Medium window: 20 alarms in 1 day
Long window: 50 alarms in 7 days

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats alarm paging rate-limit window long 2000
Related Commandsshow stats alarm

Notes


stats chd clear


stats chd <CHD ID> clear

Clears CHD counters.

Syntax Description

CHD ID

CHD supported by the system, for example:

  • cpu_util CPU utilization: percentage of time spent
  • cpu_util_ave CPU utilization average: percentage of time spent
  • cpu_util_day CPU utilization average: percentage of time spent
  • disk_device_io_hour storage device I/O read/write statistics for the last hour: bytes
  • disk_io operating system aggregate disk I/O average (KB/sec)
  • fs_mnt_day filesystem system usage average: bytes
  • fs_mnt_month filesystem system usage average: bytes
  • fs_mnt_week filesystem system usage average: bytes
  • intf_day network interface statistics aggregation: bytes
  • intf_hour network interface statistics (same as “interface” sample)
  • intf_util aggregate network utilization across all interfaces
  • memory_day average physical memory usage: bytes
  • memory_pct average physical memory usage
  • paging paging activity: page faults
  • paging_day paging activity: page faults

  • eth_day
  • eth_hour
  • eth_ip_day
  • eth_ip_hour

Default

N/A

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats chd memory_day clear
Related Commandsshow stats chd

Notes


stats chd enable


stats chd <chd-id> enable
no stats chd <chd-id> enable

Enables the CHD.
The no form of the command disables the CHD.

Syntax Description

chd-id

CHD supported by the system, for example:

  • cpu_util CPU utilization: percentage of time spent
  • cpu_util_ave CPU utilization average: percentage of time spent
  • cpu_util_day CPU utilization average: percentage of time spent
  • disk_device_io_hour storage device I/O read/write statistics for the last hour: bytes
  • disk_io operating system aggregate disk I/O average: KB/sec
  • fs_mnt_day filesystem system usage average: bytes
  • fs_mnt_month filesystem system usage average: bytes
  • fs_mnt_week filesystem system usage average: bytes
  • intf_day network interface statistics aggregation: bytes
  • intf_hour – network interface statistics (same as “interface” sample)
  • intf_util – aggregate network utilization across all interfaces
  • memory_day average physical memory usage: bytes
  • memory_pct average physical memory usage
  • paging paging activity: page faults
  • paging_day paging activity: page faults

  • eth_day
  • eth_hour

Default

Enabled

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats chd memory_day enable
Related Commandsshow stats chd

Notes


stats chd compute time


stats chd <CHD ID> compute time {interval | range} <number of seconds>

Sets parameters for when this CHD is computed.

Syntax Description

CHD ID

Possible IDs:

  • cpu_util CPU utilization: percentage of time spent
  • cpu_util_ave CPU utilization average: percentage of time spent
  • cpu_util_day CPU utilization average: percentage of time spent
  • disk_device_io_hour storage device I/O read/write statistics for the last hour: bytes
  • disk_io operating system aggregate disk I/O average: KB/sec
  • fs_mnt_day filesystem system usage average: bytes
  • fs_mnt_month filesystem system usage average: bytes
  • fs_mnt_week filesystem system usage average: bytes
  • intf_day network interface statistics aggregation: bytes
  • intf_hour network interface statistics (same as “interface” sample)
  • intf_util aggregate network utilization across all interfaces
  • memory_day average physical memory usage: bytes
  • memory_pct average physical memory usage
  • paging paging activity: page faults
  • paging_day paging activity: page faults

  • eth_day
  • eth_hour

interval

Specifies calculation interval (how often to do a new calculation) in number of seconds

range

Specifies calculation range, in number of seconds

number of seconds

Number of seconds

Default

Different per CHD

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats chd memory_day compute time interval 120
Related Commandsshow stats chd

Notes


stats export


stats export <format> <sample-id>

Exports collected information to a file.Can export extended "interface-ethernet", "interface-port-channel", "interface-mlag-port-channel"& "power" samples.

Syntax Description

memory 

Memory utilization

pagingPaging I/O
telemetryTelemetry histogram
cpu_utilCPU utilization
powerPower

Default

N/A

Configuration Mode

config

History


3.7.1102 
3.10.1000: Updated syntax description options

Example

switch (config) # stats export csv memory
Related Commandsshow stats sample

Notes


stats sample clear


stats sample <sample ID> clear

Clears sample history.

Syntax Description

sample ID

Possible sample IDs are:

  • congested
  • cpu_util CPU utilization: milliseconds of time spent
  • disk_device_io storage device I/O statistics
  • disk_io operating system aggregate disk I/O: KB/sec
  • fan - Fan speed
  • fs_mnt_bytes filesystem usage: bytes
  • fs_mnt_inodes filesystem usage: inodes
  • interface network interface statistics
  • intf_util network interface utilization: bytes
  • memory system memory utilization: bytes
  • paging paging activity: page faults
  • power power supply usage
  • power-consumption
  • temperature modules temperature

  • interface-ethernet Ethernet counters statistics: counter units
  • interface-mlag-port-channel MLAG counters statistics: counter units
  • interface-port-channel LAG counters statistics: counter units
  • eth
  • eth-abs
  • eth_ip

Default

N/A

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats sample temperature clear
Related Commandsshow stats sample

Notes


stats sample enable


stats sample <sample-id> enable
no states sample <sample-id> enable

Enables the sample.
The no form of the command disables the sample.

Syntax Description

sample-id

Possible sample IDs are:

  • congested
  • cpu_util CPU utilization: milliseconds of time spent
  • disk_device_io storage device I/O statistics
  • disk_io operating system aggregate disk I/O: KB/sec
  • fan fan speed
  • fs_mnt_bytes filesystem usage: bytes
  • fs_mnt_inodes filesystem usage: inodes
  • interface network interface statistics
  • intf_util network interface utilization: bytes
  • memory system memory utilization: bytes
  • paging paging activity: page faults
  • power power supply usage
  • power-consumption
  • temperature modules temperature

  • interface-ethernet Ethernet counters statistics: counter units
  • interface-mlag-port-channel MLAG counters statistics: counter units
  • interface-port-channel LAG counters statistics: counter units
  • eth
  • eth-abs
  • eth_ip

Default

Enabled

Configuration Mode

config

History


3.1.0000 

Example

switch (config) # stats sample temperature enable
Related Commandsshow stats sample

Notes


stats sample interval


stats sample <sample-id> interval [<interval>]
no stats sample <sample-id> interval [<interval>]

Sets the sampling interval between taking of sample records.
The no form of the command sets interval to default value.

Syntax Description

sample-id

Sample name for which report file should be generated.

  • congested
  • cpu_util CPU utilization: milliseconds of time spent
  • disk_device_io storage device I/O statistics
  • disk_io operating system aggregate disk I/O: KB/sec
  • fan fan speed
  • fs_mnt_bytes filesystem usage: bytes
  • fs_mnt_inodes filesystem usage: inodes
  • interface network interface statistics
  • intf_util network interface utilization: bytes
  • memory system memory utilization: bytes
  • paging paging activity: page faults
  • power power supply usage
  • power-consumption
  • temperature modules temperature

  • interface-ethernet Ethernet counters statistics: counter units
  • interface-mlag-port-channel MLAG counters statistics: counter units
  • interface-port-channel LAG counters statistics: counter units
  • eth
  • eth-abs
  • eth_ip

intervalMeasured in seconds.
Range: 1 - 86400 (24 hours)

Default

Default for “interface” samples is 60 seconds

Configuration Mode

config

History


3.7.1102

Example

switch (config) # stats sample interface-ethernet interval 1
Related Commandsshow stats sample

Notes


stats sample max-entries


stats sample <sample-id> max-entries [<max-entries>]
no stats sample <sample-id> max-entries [<max-entries>]

Sets number of records to be kept in memory for the counter.
The no form of the command resets the value to its default.

Syntax Description

sample-id

Sample name for which report file should be generated.

  • congested
  • cpu_util CPU utilization: milliseconds of time spent
  • disk_device_io storage device I/O statistics
  • disk_io operating system aggregate disk I/O: KB/sec
  • fan fan speed
  • fs_mnt_bytes filesystem usage: bytes
  • fs_mnt_inodes filesystem usage: inodes
  • interface network interface statistics
  • intf_util network interface utilization: bytes
  • memory system memory utilization: bytes
  • paging paging activity: page faults
  • power power supply usage
  • power-consumption
  • temperature modules temperature

  • interface-ethernet Ethernet counters statistics: counter units
  • interface-mlag-port-channel MLAG counters statistics: counter units
  • interface-port-channel LAG counters statistics: counter units
  • eth
  • eth-abs
  • eth_ip

max-entries

Number of records
Range: 1-1000

Default

Default “interface” samples is 100 records

Configuration Mode

config

History

3.7.1102

Example

switch (config) # stats sample interface-ethernet max-entries 1000
Related Commandsshow stats sample

Notes

  • Setting a new value will delete all sample history.
  • History does not persist after reboot.

stats clear-all


stats clear-all

Clears data for all samples, CHDs, and status for all alarms.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

3.1.0000

Example

switch (config) # stats clear-all
Related Commandsshow stats sample

Notes


show stats alarm


show stats alarm [<alarm-id> [rate-limit]]

Displays status of all alarms or the specified alarm.

Syntax Description

alarm-idAvailable values:
  • cpu_util_indiv average CPU utilization too high: percent utilization
  • disk_io operating System Disk I/O per second too high: kilobytes per second
  • fs_mnt free filesystem space too low: percent of disk space free
  • intf_util network utilization too high: bytes per second
  • memory_pct_used too much memory in use: percent of physical memory used
  • paging paging activity too high: page faults
  • temperature temperature is too high: degrees
rate-limitDisplays rate limit parameters.

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show stats alarm
Alarm cpu_util_indiv (Average CPU utilization too high):   ok
Alarm disk_io (Operating System Disk I/O per second too high): (disabled)
Alarm fs_mnt (Free filesystem space too low):              ok
Alarm intf_util (Network utilization too high):            (disabled)
Alarm memory_pct_used (Too much memory in use):            (disabled)
Alarm paging (Paging activity too high):                   ok
Alarm temperature (Temperature is too high):               ok
Related Commandsstats alarm

Notes


show stats chd


show stats chd [<chd-id>]

Displays configuration of all statistics CHDs.

Syntax Description

chd-idAvailable values:
  • cpu_util_indiv average CPU utilization too high: percent utilization
  • disk_io operating System Disk I/O per second too high: kilobytes per second
  • fs_mnt free filesystem space too low: percent of disk space free
  • intf_util network utilization too high: bytes per second
  • memory_pct_used too much memory in use: percent of physical memory used
  • paging paging activity too high: page faults
  • temperature temperature is too high: degrees

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show stats chd disk_device_io_hour

CHD "disk_device_io_hour" (Storage device I/O read/write statistics for the last
 hour: bytes):
   Enabled:           yes
   Source dataset:    sample "disk_device_io"
   Computation basis: data points
   Interval:          1 data point(s)
   Range:             1 data point(s)
Related Commandsstats chd

Notes


show stats cpu


show stats cpu

Displays some basic stats about CPU utilization:

  • the current level
  • the peak over the past hour
  • the average over the past hour

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show stats cpu

CPU 0
  Utilization:                6%
  Peak Utilization Last Hour: 16% at 2012/02/28 08:47:32
  Avg. Utilization Last Hour: 8%
Related Commands

Notes


show stats sample


show stats sample [<sample-id>]

Displays sampling interval for all samples, or the specified one.

Syntax Description

sample-id

Sample name for which report file should be generated.

  • congested
  • cpu_util – CPU utilization: milliseconds of time spent
  • disk_device_io – storage device I/O statistics
  • disk_io – operating system aggregate disk I/O: KB/sec
  • fan – fan speed
  • fs_mnt_bytes – filesystem usage: bytes
  • fs_mnt_inodes – filesystem usage: inodes
  • interface – network interface statistics
  • intf_util – network interface utilization: bytes
  • memory – system memory utilization: bytes
  • paging – paging activity: page faults
  • power – power supply usage
  • power-consumption
  • temperature – modules temperature

  • interface-ethernet Ethernet counters statistics: counter units
  • interface-mlag-port-channel MLAG counters statistics: counter units
  • interface-port-channel LAG counters statistics: counter units
  • eth
  • eth-abs
  • eth_ip

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show stats sample fan
Sample "fan" (Fan speed):
   Enabled:           yes
   Sampling interval: 1 minute 11 seconds
Related Commands

Notes


show stats sample data


show stats sample <sample-id> data [interface {ethernet | port-channel | mlag-port-channel} <device/port> [counter <counter-name>] ] [group name <group-name> [counter <counter-name>] ] [max-samples {<max-samples> | all}]

Displays history of counter values (i.e., collected information for a sample).

Syntax Description

sample-id

Sample name for which report file should be generated.

  • congested
  • cpu_util – CPU utilization: milliseconds of time spent
  • disk_device_io – storage device I/O statistics
  • disk_io – operating system aggregate disk I/O: KB/sec
  • fan – fan speed
  • fs_mnt_bytes – filesystem usage: bytes
  • fs_mnt_inodes – filesystem usage: inodes
  • interface – network interface statistics
  • intf_util – network interface utilization: bytes
  • memory – system memory utilization: bytes
  • paging – paging activity: page faults
  • power – power supply usage
  • power-consumption
  • temperature – modules temperature

  • interface-ethernet Ethernet counters statistics: counter units
  • interface-mlag-port-channel MLAG counters statistics: counter units
  • interface-port-channel LAG counters statistics: counter units
  • eth
  • eth-abs
  • eth_ip


interfaceAllows limiting output to a particular interface’s counters
groupAllows limiting output to a particular group of counters
counterAllows limiting output to a particular counter. This option is available only if the option interface or group is chosen.
max-samplesAllows choosing a number of counter records to display. Range: 1-1000 records. The “all” option is meant for all available records. By default, 20 counter records are displayed.

Default

N/A

Configuration Mode

Any command mode

History

3.7.1102
3.8.1000: Modified configuration mode & example
3.9.2000: Modified note and example

Example
switch (config) # show stats sample interface-ethernet data interface ethernet 1/1 max-samples 1
Sampling data for Interface ethernet counters:
Eth1/1:
    ------------------------------------------------------------------
    Name                            Timestamp               Value
    ------------------------------------------------------------------
    Rx_packets                      2000/12/25 10:27:53     0
    Rx_unicast_packets              2000/12/25 10:27:53     0
    Rx_multicast_packets            2000/12/25 10:27:53     0
    Rx_broadcast_packets            2000/12/25 10:27:53     0
    Rx_bytes                        2000/12/25 10:27:53     0
    Rx_discard_packets              2000/12/25 10:27:53     0
    Rx_error_packets                2000/12/25 10:27:53     0
    Rx_fcs_errors                   2000/12/25 10:27:53     0
    Rx_undersize_packets            2000/12/25 10:27:53     0
    Rx_oversize_packets             2000/12/25 10:27:53     0
    Rx_pause_packets                2000/12/25 10:27:53     0
    Rx_unknown_control_opcode       2000/12/25 10:27:53     0
    Rx_symbol_errors                2000/12/25 10:27:53     0
    Rx_packets_of_64_bytes          2000/12/25 10:27:53     0
    Rx_packets_of_65-127_bytes      2000/12/25 10:27:53     0
    Rx_packets_of_128-255_bytes     2000/12/25 10:27:53     0
    Rx_packets_of_256-511_bytes     2000/12/25 10:27:53     0
    Rx_packets_of_512-1023_bytes    2000/12/25 10:27:53     0
    Rx_packets_of_1024-1518_bytes   2000/12/25 10:27:53     0
    Rx_packets_Jumbo                2000/12/25 10:27:53     0
    Tx_packets                      2000/12/25 10:27:53     0
    Tx_unicast_packets              2000/12/25 10:27:53     0
    Tx_multicast_packets            2000/12/25 10:27:53     0
    Tx_broadcast_packets            2000/12/25 10:27:53     0
    Tx_bytes                        2000/12/25 10:27:53     0
    Tx_discard_packets              2000/12/25 10:27:53     0
    Tx_error_packets                2000/12/25 10:27:53     0
    Tx_hoq_discard_packets          2000/12/25 10:27:53     0
    Tx_pause_packets                2000/12/25 10:27:53     0
    Tx_pause_duration               2000/12/25 10:27:53     0
Related Commands

Notes

  • Filtering keyword depends on chosen <sample-id>.  For convenience, “interface” samples such as “interface-ethernet”, “interface-port-channel” and “interface-mlag-port-channel” have interface related keywords for choosing a counters group.

  • Notice that this is a history of counters. Autocompletion and output can contain information for groups (interfaces) that is not present anymore in the system, and vice versa. If counters are not sampled, they will not appear in the output.
  • Output of collected information is implemented only for the following samples:
    • memory
    • paging
    • power

  • interface-port-channel
  • interface-ethernet
  • interface-mlag-port-channel