Statistics and Alarms

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 Commands

show stats alarm

Notes

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 Commands

show stats alarm

Notes

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 Commands

show stats alarm

Notes

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 Commands

show stats alarm

Notes

Not all alarms support all four thresholds.

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 Commands

show stats alarm

Notes

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

• ib_day

• ib_hour

Default

N/A

Configuration Mode

config

History

3.1.0000

Example

switch (config) # stats chd memory_day clear

Related Commands

show stats chd

Notes

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— n etwork interface statistics (same as “interface” sample)

• intf_util – a ggregate 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

• ib_day

• ib_hour

Default

Enabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # stats chd memory_day enable

Related Commands

show stats chd

Notes

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

• ib_day

• ib_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 Commands

show stats chd

Notes

stats export <format> <sample-id>

Exports collected information to a file.

Syntax Description

memory

Memory utilization

paging

Paging I/O

telemetry

Telemetry histogram

cpu_util

CPU utilization

power

Power

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 Commands

show stats sample

Notes

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

• ib

Default

N/A

Configuration Mode

config

History

3.1.0000

Example

switch (config) # stats sample temperature clear

Related Commands

show stats sample

Notes

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

• ib

Default

Enabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # stats sample temperature enable

Related Commands

show stats sample

Notes

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

• ib

interval

Measured 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 Commands

show stats sample

Notes

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

• ib

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 Commands

show stats sample

Notes

• Setting a new value will delete all sample history.

• History does not persist after reboot.

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 Commands

show stats sample

Notes

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

Displays status of all alarms or the specified alarm.

Syntax Description

alarm-id

Available 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-limit

Displays 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 Commands

stats alarm

Notes

show stats chd [<chd-id>]

Displays configuration of all statistics CHDs.

Syntax Description

chd-id

Available 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 Commands

stats chd

Notes

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 [<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

• ib

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 <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

• ib

interface

Allows limiting output to a particular interface’s counters

group

Allows limiting output to a particular group of counters

counter

Allows limiting output to a particular counter. This option is available only if the option interface or group is chosen.

max-samples

Allows 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>.

• 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