RMON Commands

RMON (Remote Monitoring) is a standard monitoring specification that allows network monitors and console systems to exchange network-monitoring data.

RMON CLI commands are categorized as follows:

• Enable and Disable Commands
• Configuration Commands
• Display Command

Enable and Disable Commands

This section includes the RMON enable and disable command.

set rmon

Command Objective:
This command is used to enable or disable the RMON feature.

Syntax:
set rmon {enable | disable}

Parameter Description:

• enable - Enables the RMON feature in the system. On enabling, the RMON starts monitoring the networks both local and remote and provides network fault diagnosis
• disable - Disables the RMON feature in the system. On disabling, the RMON’s network monitoring is called off. When the module is disabled, the dynamic learned entries are flushed. When it is enabled again statistics collection newly starts.
  

  ---

  Note: "Number of statistics collection on interface" is showing number of statically configured collection entries and that will remain.

  ---

Mode:
Global Configuration Mode

Default:
Disabled

Example:

Your Product(config)# set rmon enable

Configuration Commands

This section includes RMON configuration commands.

rmon alarm

Command Objective:
This command sets an alarm on a MIB object. The Alarm group periodically takes statistical samples from variables in the probe and compares them to thresholds that have been configured.

The no form of the command deletes the alarm configured on the MIB object.

Syntax:
rmon alarm < alarm-number > < mib-object-id (255) > < sample-interval-time (1-65535) > {absolute | delta} rising-threshold < value (0-2147483647) > [rising-event-number (1-65535)] falling-threshold < value (0-2147483647) > [falling-event-number (1-65535)] [owner < ownername (127) >]

no rmon alarm < number (1-65535) >

Parameter Description:

• < alarm-number > / < number (1-65535) > - Displays the value of the statistic during the last sampling period. This value remains available until the current sampling period is completed. For example, if the sample type is deltaValue, this value will be the difference between the samples at the beginning and end of the period. If the sample type is absoluteValue, this value will be the sampled value at the end of the period. This value is compared with the rising and falling thresholds. This value ranges from 1 to 65535.
• < mib-object-id (255) > - Identifies the MIB object.
• < sample-interval-time (1-65535) > - Identifies an entry in the alarm table. Each entry defines a diagnostic sample at a particular level for a MIB object in the device. This value ranges from 1 to 65535 seconds.
• absolute - Compares the value of the selected variable with the thresholds at the end of the sampling interval.
• delta - Subtracts the value of the selected variable at the last sample from the current value; the difference is compared with the thresholds at the end of the sampling interval.
• rising-threshold < value (0-2147483647) > - Configures the rising threshold value. If the startup alarm is set as Rising alarm or RisingOrFalling alarm and if the configured threshold value is reached, an alarm is raised. When the current sampled value is greater than or equal to the configured Rising threshold, and the value at the last sampling interval is less than this configured threshold, a single event will be generated. This value ranges from 0 to 2147483647.
• < rising-event-number (1-65535) > - Raises the index of the event when the Rising threshold is reached. The event entry identified by a particular value of this index is the same as identified by the same value of the event index object. This value ranges from 1 to 65535.
• falling-threshold < value (0-2147483647) > - Configures the falling threshold value. If the startup alarm is set as Falling alarm or RisingOrFalling alarm and if the configured threshold value is reached, an alarm is raised. When the current sampled value is lesser than or equal to the configured Falling threshold, and the value at the last sampling interval is greater than this threshold, a single event will be generated. This value ranges from 0 to 2147483647.
• < falling-event-number (1-65535) > - Raises the index of the event when the Falling threshold is reached. The event entry identified by a particular value of this index is the same as identified by the same value of the event index object. This value ranges from 1 to 65535.
• owner < ownername (127) > - Sets the entity that are configured for this entry.

Mode:
Global Configuration Mode

Default:
The least event number in the event table is assigned the same rising and falling threshold as its event number.

You cannot monitor all the MIB objects through RMON. This is only applicable to the Ethernet interfaces and VLANs.

Example:

Your Product(config)# rmon alarm 1 1.3.6.1.2.1.16.1.1.1.5.2 1 delta rising-threshold 2 falling-threshold 1

rmon collection history

Command Objective:
This command enables history collection of interface/ VLAN statistics in the buckets for the specified time interval.

The no form of the command disables the history collection on the interface/VLAN.

Syntax:
rmon collection history <index (1-65535)> [buckets <bucket-number (1-65535)>] [interval <seconds (1-3600)>] [owner <ownername (127)>]

no rmon collection history <index (1-65535)>

Parameter Description:

• <index (1-65535)> - Identifies an entry in the history control table. Each such entry defines a set of samples at a particular interval for an interface on the device. This value ranges from 1 to 65535.
• buckets <bucket-number (1-65535)> - Configures the number of desired buckets for the RMON collection history group of statistics. This is the requested number of discrete time intervals over which data is saved in the part of the media-specific table associated with this History Control Entry. The polling cycle is the bucket interval where the interface statistics details are stored. This value ranges from 1 to 65535.
• interval <seconds (1-3600)> - Configures the time interval over which the data is sampled for each bucket. This value ranges from 1 to 3600.
• owner < ownername (127) > - Configures the owner name of the RMON group of statistics

Mode:
Interface Configuration Mode / Config VLAN Mode

Default:

• bucket number - 50
• interval - 1800 seconds

Example:
Interface Configuration Mode

Your Product(config) interface gigabitethernet 0/1

Your Product(config-if)# rmon collection history 1 buckets 2 interval 20

Config VLAN Mode

Your Product(config) vlan 1

Your Product(config-vlan) rmon collection history 2

rmon collection stats

Command Objective:
This command enables RMON statistic collection on the interface / VLAN.

The no form of the command disables RMON statistic collection on the interface / VLAN.

Syntax:
rmon collection stats <index (1-65535)> [owner <ownername (127)>]

no rmon collection stats <index (1-65535)>

Parameter Description:

• <index (1-65535)> - Identifies an entry in the statistics table. This value ranges from 1 to 65535.
• owner <ownername (127)> - Configures the owner name of the RMON group of statistics

Mode:
Interface Configuration Mode / Config VLAN Mode

Default:

• bucket number - 50
• interval - 1800 seconds

Example:
Interface Configuration Mode

Your Product(config) interface gigabitethernet 0/1

Your Product(config-if)# rmon collection stats 1

Config VLAN Mode

Your Product(config) vlan 1

Your Product(config-vlan) rmon collection stats 2

rmon event

Command Objective:
This command adds an event to the RMON event table. The added event is associated with an RMON event number.

The no form of the command deletes an event from the RMON event table.

Syntax:
rmon event <number (1-65535)> [description <event-description (127)>] [log] [owner <ownername (127)>] [trap <community (127)>]

no rmon event <number (1-65535)>

Parameter Description:

• < number (1-65535) > - Sets the number of events to be added in the event table. This value ranges from 1 to 65535.
• description < event-description (127) > - Provides a description for the event. This value is a string with a maximum length of 127.
• log - Creates an entry in the log table for each event.
• owner < ownername (127) > - Displays the entity that are configured this entry. This value is a string with a maximum value of 127.
• trap < community (127) > - Generates a trap, The SNMP community string is to be passed for the specified trap. This value is a string with a maximum value of 127.

Mode:
Global Configuration Mode

Example:

Your Product(config)# rmon event 1 log owner capgemini trap netman

Display Command

This section includes the RMON display command.

show rmon

Command Objective:
This command displays the RMON statistics, alarms, events, and history configured on the interface.

Syntax:
show rmon [statistics [<stats-index (1-65535)>]] [alarms] [events] [history [history-index (1-65535)] [overview]]

Parameter Description:

• statistics - Displays a collection of statistics for a particular Ethernet Interface. The probe for each monitored interface on this device measures the statistics.
• alarms - Displays the value of the statistic during the last sampling period. This value remains available until the current sampling period is completed.
• events - Generates events whenever an associated condition takes place in the device. The Conditions may be alarms. Alarms are generated when a sampled statistical variable value exceeds the defined threshold value. Alarm module calls events module.
• history - Displays the history of the configured RMON
• overview - Displays only the overview of RMON history entries

Mode:
Privileged EXEC Mode

Example:

Your Product# show rmon

RMON is enabled

Your Product# show rmon history

RMON is disabled
Entry 1 is active,  and owned by monitor
 Monitors ifEntry.1.2 every 1800 second(s)
 Requested # of time intervals, ie buckets, is 50,
 Granted # of time intervals, ie buckets, is 50,
Entry 4 is active,  and owned by monitor
 Monitors Vlan 40 every 1800 second(s)
 Requested # of time intervals, ie buckets, is 50,
 Granted # of time intervals, ie buckets, is 50,
Number of history collection on interface: 1
Number of history collection on Vlan     : 1