RMON Commands

Console# show rmon statistics ethernet 1/e1
Port 1/e1
Dropped: 8
Octets: 878128 Packets: 978
Broadcast: 7 Multicast: 1
CRC Align Errors: 0 Collisions: 0
Undersize Pkts: 0 Oversize Pkts: 0
Fragments: 0 Jabbers: 0
64 Octets: 98 65 to 127 Octets: 0
128 to 255 Octets: 0 256 to 511 Octets: 0
512 to 1023 Octets: 491 1024 to 1518 Octets: 389

The following table describes the significant fields shown in the display:

Field
Description

Dropped
The total number of events in which packets are dropped by the probe due to lack of resources. This number is not always the number of packets dropped; it is the number of times this condition has been detected.

Octets
The total number of octets of data (including those in bad packets) received on the network (excluding framing bits but including FCS octets).

Packets
The total number of packets (including bad packets, broadcast packets, and multicast packets) received.

Broadcast
The total number of good packets received and directed to the broadcast address. This does not include multicast packets.

Multicast
The total number of good packets received and directed to a multicast address. This number does not include packets directed to the broadcast address.

CRC Align Errors
The total number of packets received with a length (excluding framing bits, but including FCS octets) of between 64 and 1518 octets, inclusive, but with either a bad Frame Check Sequence (FCS), with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error).

Undersize Pkts
The total number of packets received less than 64 octets long (excluding framing bits, but including FCS octets) and otherwise well formed.

Oversize Pkts
The total number of packets received longer than 1518 octets (excluding framing bits, but including FCS octets) and otherwise well formed.

Fragments
The total number of packets received less than 64 octets in length (excluding framing bits but including FCS octets) and either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error), or a bad FCS with a non-integral number of octets (Alignment Error).

Jabbers
The total number of packets received longer than 1518 octets (excluding framing bits, but including FCS octets), and either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error).

Collisions
The best estimate of the total number of collisions on this ethernet segment.

64 Octets
The total number of packets (including bad packets) received that are 64 octets in length (excluding framing bits but including FCS octets).

65 to 127 Octets
The total number of packets (including bad packets) received between 65 and 127 octets in length inclusive (excluding framing bits but including FCS octets).

128 to 255 Octets
The total number of packets (including bad packets) received between 128 and 255 octets in length inclusive (excluding framing bits but including FCS octets).

256 to 511 Octets
The total number of packets (including bad packets) received between 256 and 511 octets in length inclusive (excluding framing bits but including FCS octets).

512 to 1023 Octets
The total number of packets (including bad packets) received that are between 512 and 1023 octets in length inclusive (excluding framing bits but including FCS octets).

1024 to 1518 Octets
The total number of packets (including bad packets) received that are between 1024 and 1518 octets in length inclusive (excluding framing bits but including FCS octets).

rmon collection history

Use the rmon collection history interface configuration command to enable a Remote Monitoring (RMON) MIB history statistics group on an interface. To remove a specified RMON history statistics group, use the no form of this command.

Syntax

rmon collection history index [owner ownername] [buckets bucket-number] [interval seconds]

no rmon collection history index

index—The requested statistics index group (Range: 1-65535).
owner ownername—Records the RMON statistics group owner name. If unspecified, the name is an empty string.
buckets bucket-number—A value associated with the number of buckets specified for the RMON collection history group of statistics. If unspecified, defaults to 50 (Range: 1-65535).
interval seconds—The number of seconds in each polling cycle. If unspecified, defaults to 1800 (Range: 1-3600).

Default Configuration

This command has no default configuration.

Command Mode

Interface Configuration (Ethernet, port-channel) Mode

User Guidelines

This command cannot be executed on multiple ports using the interface range ethernet command.

Examples

The following example enables a Remote Monitoring (RMON) MIB history statistics group.

Console (config)# interface ethernet 1/e8
Console (config-if)# rmon collection history 1 interval 2400

show rmon collection history

Use the show rmon collection history privileged EXEC command to display the requested history group configuration.

Syntax

show rmon collection history [ethernet interface | port-channel port-channel-number]

interface—An ethernet port. The full syntax is: unit/port.
port-channel-number—A port-channel index.

Default Configuration

This command has no default configuration.

Command Mode

Privileged EXEC Mode

User Guidelines

There are no user guidelines for this command.

Examples

The following example displays all RMON group statistics.

Console# show rmon collection history

Index Interface Interval Requested Granted Owner
Samples Samples
----- ----- ---------- ---------- -------- -------
1 1/e1 30 50 50 CLI
2 1/e1 1800 50 50 Manager

The following table describes the significant fields shown in the display:

Field
Description

Index
An index that uniquely identifies the entry.

Interface
The sampled ethernet interface

Interval
The interval in seconds between samples.

Requested Samples
The requested number of samples to be saved.

Granted Samples
The granted number of samples to be saved.

Owner
The entity that configured this entry.

show rmon history

Use the show rmon history privileged EXEC command to display RMON ethernet statistics history.

Syntax

show rmon history index {throughput | errors | other} [period seconds]

index—The requested set of samples (Range: 1-65535).
throughput—Displays throughput counters.
errors—Displays error counters.
other—Displays drop and collision counters.
period seconds—Specifies the requested period time to display (Range: 0–2147483647).

Default Configuration

This command has no default configuration.

Command Mode

Privileged EXEC Mode

User Guidelines

There are no user guidelines for this command.

Examples

The following example displays RMON Ethernet Statistics history for throughput on index number 1.

Console# show rmon history 1 throughput
Sample set: 1 Owner: CLI
Interface: 1/1 Interval: 1800
Requested samples: 50 Granted samples: 50
Maximum table size: 500
Time Octets Packets Broadcast Multicast Utilization
-------------------- ---------- --------- --------- ---------- ----
Jan 18 2002 21:57:00 303595962 357568 3289 7287 19.98%
Jan 18 2002 21:57:30 287696304 275686 2789 5878 20.17%

The following example displays RMON Ethernet Statistics history for errors on index number 1.

Console# show rmon history 1 errors
Sample set: 1 Owner: Me
Interface: 1/1 Interval: 1800
Requested samples: 50 Granted samples: 50
Maximum table size: 500 (800 after reset)
Time CRC Align Undersize Oversize Fragments Jabbers
--------------------- ---------- --------- --------- ---------- ---
Jan 18 2002 21:57:00 1 1 0 49 0
Jan 18 2002 21:57:30 1 1 0 27 0

The following example displays RMON Ethernet Statistics history for other on index number 1.

Console# show rmon history 1 other
Sample set: 1 Owner: Me
Interface: 1/1 Interval: 1800
Requested samples: 50 Granted samples: 50
Maximum table size: 500
Time Dropped Collisions
-------------------- ------- ----------
Jan 18 2002 21:57:00 3 0
Jan 18 2002 21:57:30 3 0

The following table describes the significant fields shown in the display:

Field
Description

Time
Date and time the entry is recorded.

Octets
The total number of octets of data (including those in bad packets) received on the network (excluding framing bits but including FCS octets).

Packets
The number of packets (including bad packets) received during this sampling interval.

Broadcast
The number of good packets received during this sampling interval that were directed to the broadcast address.

Multicast
The number of good packets received during this sampling interval that were directed to a multicast address. This number does not include packets addressed to the broadcast address.

Utilization
The best estimate of the mean physical layer network utilization on this interface during this sampling interval, in hundredths of a percent.

CRC Align
The number of packets received during this sampling interval that had a length (excluding framing bits but including FCS octets) between 64 and 1518 octets, inclusive, but had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error).

Undersize
The number of packets received during this sampling interval that were less than 64 octets long (excluding framing bits but including FCS octets) and were otherwise well formed.

Oversize
The number of packets received during this sampling interval that were longer than 1518 octets (excluding framing bits but including FCS octets) but were otherwise well formed.

Fragments
The total number of packets received during this sampling interval that were less than 64 octets in length (excluding framing bits but including FCS octets) had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error), or a bad FCS with a non-integral number of octets (AlignmentError). It is normal for etherHistoryFragments to increment because it counts both runts (which are normal occurrences due to collisions) and noise hits.

Jabbers
The number of packets received during this sampling interval that were longer than 1518 octets (excluding framing bits but including FCS octets), and had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error).

Dropped
The total number of events in which packets were dropped by the probe due to lack of resources during this sampling interval. This number is not necessarily the number of packets dropped, it is just the number of times this condition has been detected.

Collisions
The best estimate of the total number of collisions on this Ethernet segment during this sampling interval.

rmon alarm

Use the rmon alarm global configuration command to configure alarm conditions. To remove an alarm, use the no form of this command.

Syntax

rmon alarm index variable interval rthreshold fthreshold revent fevent [type type] [startup direction] [owner name]

no rmon alarm index

index—The alarm index (Range: 1-65535).
variable—The variable object identifier to be sampled.
interval—The interval in seconds over which the data is sampled and compared with the rising and falling thresholds (Range: 1-4294967295).
rthreshold—Rising Threshold (Range: 1-4294967295).
fthreshold—Falling Threshold (Range: 1-4294967295).
revent—The Event index used when a rising threshold is crossed (Range: 1-65535).
fevent—The Event index used when a falling threshold is crossed (Range: 1-65535).
type type—The sampling method for the selected variable and calculating the value to be compared against the thresholds. If the method is absolute, the value of the selected variable is compared directly with the thresholds at the end of the sampling interval. If the method is delta, the selected variable value at the last sample is subtracted from the current value, and the difference compared with the thresholds.
startup direction—The alarm that may be sent when this entry is first set to valid. If the first sample after this entry becomes valid is greater than or equal to the rthreshold, and direction is equal to rising or rising-falling, then a single rising alarm is generated. If the first sample after this entry becomes valid is less than or equal to the fthreshold, and direction is equal to falling or rising-falling, then a single falling alarm is generated.
owner name—Enter a name that specifies who configured this alarm. If unspecified, the name is an empty string.

Default Configuration

The following parameters have the following default values:

type type—If unspecified, the type is absolute.
startup direction—If unspecified, the startup direction is rising-falling.

Command Mode

Global Configuration Mode

User Guidelines

There are no user guidelines for this command.

Examples

The following example configures the following alarm conditions:

Alarm index—1
Variable identifier—1.3.6.1.2.1.16.1.1.1.18.1
Sample interval—10 seconds
Rising Threshold—100
Falling Threshold—20
Rising threshold event index—10
Falling threshold event index—20

console(config)# rmon alarm 1 1.3.6.1.2.1.16.1.1.1.18.1 10 100 20 10 20

show rmon alarm-table

Use the show rmon alarm-table privileged EXEC command to display the alarms summary table.

Syntax

show rmon alarm-table

Default Configuration

This command has no default configuration.

Command Mode

Privileged EXEC Mode

User Guidelines

There are no user guidelines for this command.

Examples

The following example displays the alarms summary table.

Console# show rmon alarm-table

Index OID Owner
----- ----------------------- -------
1 1.3.6.1.2.1.2.2.1.10.1 CLI
2 1.3.6.1.2.1.2.2.1.10.1 Manager
3 1.3.6.1.2.1.2.2.1.10.9 CLI

The following table describes the significant fields shown in the display:

Field
Description

Index
An index that uniquely identifies the entry.

OID
Monitored variable OID.

Owner
The entity that configured this entry.

show rmon alarm

Use the show rmon alarm privileged EXEC command to display alarm configuration.

Syntax

show rmon alarm number

number—Alarm index (Range: 1-65535).

Default Configuration

This command has no default configuration.

Command Mode

Privileged EXEC Mode

User Guidelines

There are no user guidelines for this command.

Examples

The following example displays the RMON alarm 1 information.

Console# show rmon alarm 1
Alarm 1
-------
OID: 1.3.6.1.2.1.2.2.1.10.1
Last sample Value: 878128
Interval: 30
Sample Type: delta
Startup Alarm: rising
Rising Threshold: 8700000
Falling Threshold: 78
Rising Event: 1
Falling Event: 1
Owner: CLI

The following table describes the significant fields shown in the display:

Field
Description

OID
Monitored variable OID.

Last Sample Value
The statistic value during the last sampling period. For example, if the sample type is delta, this value is the difference between the samples at the beginning and end of the period. If the sample type is absolute, this value is the sampled value at the end of the period.

Alarm
Alarm index.

Owner
The entity that configured this entry.

Interval
The interval in seconds over which the data is sampled and compared with the rising and falling thresholds.

Sample Type
The method of sampling the variable and calculating the value compared against the thresholds. If the value is absolute, the value of the variable is compared directly with the thresholds at the end of the sampling interval. If the value is delta, the value of the variable at the last sample is subtracted from the current value, and the difference compared with the thresholds.

Startup Alarm
The alarm that may be sent when this entry is first set. If the first sample is greater than or equal to the Rising Threshold, and Startup Alarm is equal to rising or rising and falling, then a single rising alarm is generated. If the first sample is less than or equal to the Falling Threshold, and Startup Alarm is equal falling or Rising and Falling, then a single falling alarm is generated.

Rising Threshold
A sampled statistic threshold. When the current sampled value is greater than or equal to this threshold, and the value at the last sampling interval is less than this threshold, a single event is generated.

Falling Threshold
A sampled statistic threshold. When the current sampled value is less than or equal to this threshold, and the value at the last sampling interval is greater than this threshold, a single event is generated.

Rising Event
The Event index used when a rising threshold is crossed.

Falling Event
The Event index used when a falling threshold is crossed.

rmon event

Use the rmon event global configuration command to configure an event. To remove an event, use the no form of this command.

Syntax

rmon event index type [community text] [description text] [owner name]

no rmon event index

index—The event index (Range: 1-65535).
type—The notification type that the device generates about this event. Can have the following values: none, log, trap, log-trap. In the case of log, an entry is made in the log table for each event. In the case of trap, an SNMP trap is sent to one or more management stations.
community text—If an SNMP trap is to be sent, it is sent to the SNMP community specified by this octet string.
description text—A comment describing this event.
owner name—Enter a name that specifies who configured this event. If unspecified, the name is an empty string.

Default Configuration

This command has no default configuration.

Command Mode

Global Configuration Mode

User Guidelines

There are no user guidelines for this command.

Examples

The following example configures an event with the trap index of 10.

Console (config)# rmon event 10 log community delta

show rmon events

Use the show rmon events privileged EXEC command to display the RMON event table.

Syntax

show rmon events

Default Configuration

This command has no default configuration.

Command Mode

Privileged EXEC Mode

User Guidelines

There are no user guidelines for this command.

Examples

The following example describes RMON events.

Console# show rmon events

Index Description Type Community Owner Last time sent
----- ----------- ---------- ---------- -------- ------------------
1 Errors Log CLI Jan 18 2002 23:58:17
2 High Broadcast Log-Trap device Manager Jan 18 2002 23:59:48

The following table describes the significant fields shown in the display:

Field
Description

Index
An index that uniquely identifies the event.

Description
A comment describing this event.

Type
The type of notification that the device generates about this event. Can have the following values: none, log, trap, log-trap. In the case of log, an entry is made in the log table for each event. In the case of trap, an SNMP trap is sent to one or more management stations.

Community
If an SNMP trap is sent, it is sent to the SNMP community specified by this octet string.

Owner
The entity that configured this event.

Last time sent
The time this entry last generated an event. If this entry has not generated any events, this value is zero.

show rmon log

Use the show rmon log privileged EXEC command to display the RMON logging table.

Syntax

show rmon log [event]

event—Event index (Range: 0-65535).

Default Configuration

This command has no default configuration.

Command Mode

Privileged EXEC Mode

User Guidelines

There are no user guidelines for this command.

Examples

The following example displays the RMON logging table.

Console# show rmon log

Maximum table size: 500

Event Description Time
----- ----------- --------------------
1 Errors Jan 18 2002 23:48:19
1 Errors Jan 18 2002 23:58:17
2 High Broadcast Jan 18 2002 23:59:48

Console# show rmon log

Maximum table size: 500 (800 after reset)

Event Description Time
----- ----------- --------------------
1 Errors Jan 18 2002 23:48:19
1 Errors Jan 18 2002 23:58:17
2 High Broadcast Jan 18 2002 23:59:48

The following table describes the significant fields shown in the display:

Field
Description

Index
An index that uniquely identifies the event.

Description
A comment describing this event.

Time
The time this entry created.

rmon table-size

Use the rmon table-size global configuration command to configure the maximum RMON tables sizes. To return to the default configuration, use the no form of this command.

Syntax

rmon table-size {history entries | log entries}

no rmon table-size {history | log}

history entries—Maximum number of history table entries (Range: 20-32767).
log entries—Maximum number of log table entries (Range: 20-32767).

Default Configuration

History table size is 270.

Log table size is 100.

Command Mode

Global Configuration Mode

User Guidelines

There are no user guidelines for this command.

Examples

The following example configures the maximum RMON history table sizes to 1000 entries.

Console (config)# rmon table-size history 1000

Back to Contents Page

Field	Description
Dropped	The total number of events in which packets are dropped by the probe due to lack of resources. This number is not always the number of packets dropped; it is the number of times this condition has been detected.
Octets	The total number of octets of data (including those in bad packets) received on the network (excluding framing bits but including FCS octets).
Packets	The total number of packets (including bad packets, broadcast packets, and multicast packets) received.
Broadcast	The total number of good packets received and directed to the broadcast address. This does not include multicast packets.
Multicast	The total number of good packets received and directed to a multicast address. This number does not include packets directed to the broadcast address.
CRC Align Errors	The total number of packets received with a length (excluding framing bits, but including FCS octets) of between 64 and 1518 octets, inclusive, but with either a bad Frame Check Sequence (FCS), with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error).
Undersize Pkts	The total number of packets received less than 64 octets long (excluding framing bits, but including FCS octets) and otherwise well formed.
Oversize Pkts	The total number of packets received longer than 1518 octets (excluding framing bits, but including FCS octets) and otherwise well formed.
Fragments	The total number of packets received less than 64 octets in length (excluding framing bits but including FCS octets) and either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error), or a bad FCS with a non-integral number of octets (Alignment Error).
Jabbers	The total number of packets received longer than 1518 octets (excluding framing bits, but including FCS octets), and either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error).
Collisions	The best estimate of the total number of collisions on this ethernet segment.
64 Octets	The total number of packets (including bad packets) received that are 64 octets in length (excluding framing bits but including FCS octets).
65 to 127 Octets	The total number of packets (including bad packets) received between 65 and 127 octets in length inclusive (excluding framing bits but including FCS octets).
128 to 255 Octets	The total number of packets (including bad packets) received between 128 and 255 octets in length inclusive (excluding framing bits but including FCS octets).
256 to 511 Octets	The total number of packets (including bad packets) received between 256 and 511 octets in length inclusive (excluding framing bits but including FCS octets).
512 to 1023 Octets	The total number of packets (including bad packets) received that are between 512 and 1023 octets in length inclusive (excluding framing bits but including FCS octets).
1024 to 1518 Octets	The total number of packets (including bad packets) received that are between 1024 and 1518 octets in length inclusive (excluding framing bits but including FCS octets).

Field	Description
Index	An index that uniquely identifies the entry.
Interface	The sampled ethernet interface
Interval	The interval in seconds between samples.
Requested Samples	The requested number of samples to be saved.
Granted Samples	The granted number of samples to be saved.
Owner	The entity that configured this entry.

Field	Description
Time	Date and time the entry is recorded.
Octets	The total number of octets of data (including those in bad packets) received on the network (excluding framing bits but including FCS octets).
Packets	The number of packets (including bad packets) received during this sampling interval.
Broadcast	The number of good packets received during this sampling interval that were directed to the broadcast address.
Multicast	The number of good packets received during this sampling interval that were directed to a multicast address. This number does not include packets addressed to the broadcast address.
Utilization	The best estimate of the mean physical layer network utilization on this interface during this sampling interval, in hundredths of a percent.
CRC Align	The number of packets received during this sampling interval that had a length (excluding framing bits but including FCS octets) between 64 and 1518 octets, inclusive, but had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error).
Undersize	The number of packets received during this sampling interval that were less than 64 octets long (excluding framing bits but including FCS octets) and were otherwise well formed.
Oversize	The number of packets received during this sampling interval that were longer than 1518 octets (excluding framing bits but including FCS octets) but were otherwise well formed.
Fragments	The total number of packets received during this sampling interval that were less than 64 octets in length (excluding framing bits but including FCS octets) had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error), or a bad FCS with a non-integral number of octets (AlignmentError). It is normal for etherHistoryFragments to increment because it counts both runts (which are normal occurrences due to collisions) and noise hits.
Jabbers	The number of packets received during this sampling interval that were longer than 1518 octets (excluding framing bits but including FCS octets), and had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets (Alignment Error).
Dropped	The total number of events in which packets were dropped by the probe due to lack of resources during this sampling interval. This number is not necessarily the number of packets dropped, it is just the number of times this condition has been detected.
Collisions	The best estimate of the total number of collisions on this Ethernet segment during this sampling interval.

Field	Description
OID	Monitored variable OID.
Last Sample Value	The statistic value during the last sampling period. For example, if the sample type is delta, this value is the difference between the samples at the beginning and end of the period. If the sample type is absolute, this value is the sampled value at the end of the period.
Alarm	Alarm index.
Owner	The entity that configured this entry.
Interval	The interval in seconds over which the data is sampled and compared with the rising and falling thresholds.
Sample Type	The method of sampling the variable and calculating the value compared against the thresholds. If the value is absolute, the value of the variable is compared directly with the thresholds at the end of the sampling interval. If the value is delta, the value of the variable at the last sample is subtracted from the current value, and the difference compared with the thresholds.
Startup Alarm	The alarm that may be sent when this entry is first set. If the first sample is greater than or equal to the Rising Threshold, and Startup Alarm is equal to rising or rising and falling, then a single rising alarm is generated. If the first sample is less than or equal to the Falling Threshold, and Startup Alarm is equal falling or Rising and Falling, then a single falling alarm is generated.
Rising Threshold	A sampled statistic threshold. When the current sampled value is greater than or equal to this threshold, and the value at the last sampling interval is less than this threshold, a single event is generated.
Falling Threshold	A sampled statistic threshold. When the current sampled value is less than or equal to this threshold, and the value at the last sampling interval is greater than this threshold, a single event is generated.
Rising Event	The Event index used when a rising threshold is crossed.
Falling Event	The Event index used when a falling threshold is crossed.