- Table of Contents
-
- H3C S9500 Command Manual-Release1648[v1.24]-08 System Volume
- 00-1Cover
- 01-Command Line Interface Commands
- 02-Login and User Interface Commands
- 03-FTP and TFTP Commands
- 04-HA Commands
- 05-NQA Commands
- 06-NetStream Commands
- 07-NTP Commands
- 08-RMON Commands
- 09-SNMP Commands
- 10-Packet Statistics Accounting Commands
- 11-Device Management Commands
- 12-Configuration File Management Commands
- 13-File System Management Commands
- 14-Cluster Management Commands
- 15-System Maintenance and Debugging Commands
- 16-Information Center Commands
- 17-PoE Commands
- 18-Clock Module Commands
- 19-ACSEI Server Commands
- 20-OAP Module Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
08-RMON Commands | 63.83 KB |
Chapter 1 RMON Configuration Commands
1.1 RMON Configuration Commands
1.1.1 display rmon alarm
Syntax
display rmon alarm [ alarm-table-entry ]
View
Any view
Parameters
alarm-table-entry: Alarm table entry index.
Description
Use the display rmon alarm command to view RMON alarm information.
Related commands: rmon alarm.
Examples
# Display the RMON alarm information.
<H3C> display rmon alarm
Alarm table 1 owned by monitor is VALID.
Samples type : delta
Variable formula : 1.3.6.1.2.1.16.1.1.1.3.1<etherStatsDropEvents.1>
Description : Ethernet5/1/1
Sampling interval : 10(sec)
Rising threshold : 10(linked with event 1)
Falling threshold : 2(linked with event 1)
When startup enables : risingOrFallingAlarm
Latest value : 0
Table 1-1 display rmon alarm command output description
Field |
Description |
Alarm table 1 |
Index 1 in alarm table |
monitor |
Owner |
VALID |
The alarm entry corresponding to this index is valid. |
Samples type |
Type of sampling |
Variable formula |
Variable parameters |
Description |
Description information |
Sampling interval |
Time interval for sampling |
Rising threshold is 1000 |
The rising threshold is 1000. |
Falling threshold is 100 |
The falling threshold is 100. |
startup |
First triggering |
When startup enables: risingOrFallingAlarm |
Type of the first alarm. The startup may trigger rising threshold alarm, falling threshold alarm, or both. |
Latest value |
Last sample value |
1.1.2 display rmon event
Syntax
display rmon event [ event-table-entry ]
View
Any view
Parameters
event-table-entry: Entry index of event table.
Description
Use the display rmon event command to view RMON events.
The display includes event index in event table, owner of the event, description to the event, action caused by event (log or alarm information), and occurrence time of the latest event (counted on system initiate/boot time in centiseconds).
Related commands: rmon event.
Examples
# Show the RMON event.
<H3C> display rmon event
Event table 1 owned by null is VALID.
Description: null.
Will cause log-trap when triggered, last triggered at 0days 00h:02m:27s.
Table 1-2 display rmon event command output description
Field |
Description |
Event table 1 |
Index in event table |
VALID |
The entry corresponding to the index is valid |
Description |
Event description |
Cause log-trap when triggered, |
When the event is triggered, it will cause the log-trap. |
Last triggered at 0days 00h:02m:27s |
The last triggered time is 00h:02m:27s |
1.1.3 display rmon eventlog
Syntax
display rmon eventlog [ event-number ]
View
Any view
Parameters
event-number: Entry index of event table.
Description
Use the display rmon eventlog command to view RMON event log.
The display includes event index in the event table, the status of the event, the time at which the event log is generated (this time starts from the system initialization or booting and counted in milliseconds), and event description.
Examples
# Show event log of RMON.
<H3C> display rmon eventlog 1
Event table 1 owned by null is VALID.
Generates eventLog 1.1 at 0days 00h:01m:39s.
Description: The 1.3.6.1.2.1.16.1.1.1.4.1 defined in alarm table 1,
less than(or =) 100 with alarm value 0. Alarm sample type is absolute.
Generates eventLog 1.2 at 0days 00h:02m:27s.
Description: The alarm formula defined in private alarm table 1,
less than(or =) 100 with alarm value 0. Alarm sample type is absolute.
Table 1-3 display rmon eventlog command output description
Field |
Description |
Event table 1 |
Index 1 in event table |
VALID |
The entry corresponding to the index is valid |
Description |
Event description |
less than(or =) 100 with alarm value 0 |
The alarm sample value is less than or equal to 100 |
Alarm sample type is absolute |
The type of alarm sampling is absolute |
Generates eventLog 1.2 at 0days 00h:02m:27s |
The eventlog corresponding to the index 1.2 is generated at 0days 00h:02m:27s. |
1.1.4 display rmon history
Syntax
display rmon history [ port-num ]
View
Any view
Parameters
port-num: Ethernet port name.
Description
Use the display rmon history command to view latest RMON history sampling information (including utility, error number and total packet number).
Related commands: rmon history.
Examples
# Show the RMON history information.
<H3C> display rmon history ethernet 2/1/1
History control entry 1 owned by null is VALID
Samples interface : Ethernet2/1/1<ifEntry.642>
Sampling interval : 10(sec) with 10 buckets max
Latest sampled values :
Dropevents :0 , octets :0
packets :0 , broadcast packets :0
multicast packets :0 , CRC alignment errors :0
undersize packets :0 , oversize packets :0
fragments :0 , jabbers :0
collisions :0 , utilization :0
Table 1-4 display rmon history command output description
Field |
Description |
Samples interface |
The sampled interface |
History control entry |
Index number in history control table |
VALID |
The entry corresponding to the index is valid |
Sampling interval |
Sampling interval |
buckets |
Records in history control table |
Latest sampled values |
The latest sample information |
dropevents |
Dropping packet events |
octets |
Sent/Received octets in sampling time |
packets |
Packets sent/received in sampling time |
broadcast packets |
Number of broadcast packets |
multicast packets |
Number of multicast packets |
CRC alignment errors |
Number of CRC error packets |
undersized packets |
Number of undersized packets |
oversized packets |
Number of oversized packets |
fragments |
Number of undersized and CRC error packets |
jabbers |
Number of oversized and CRC error packets |
collisions |
Number of collision packets |
utilization |
Utilization |
1.1.5 display rmon prialarm
Syntax
display rmon prialarm [ prialarm-table-entry ]
View
Any view
Parameters
prialarm-table-entry: Entry index of extended RMON alarm table.
Description
Use the display rmon prialarm command to view information about extended RMON alarm table.
Related commands: rmon prialarm.
Examples
# Display the information about extended RMON alarm table.
<H3C> display rmon prialarm
Prialarm table 1 owned by monitor is UNDERCREATION.
Samples type : changeratio
Variable formula : (.1.3.6.1.2.1.2.2.1.10.201326601+.1.3.6.1.2.1.2.2.1.16
.201326601)*8*100/.1.3.6.1.2.1.2.2.1.5.201326601
Description : ifUtilization.Ethernet5/1/1
Sampling interval : 10(sec)
Rising threshold : 50(linked with event 1)
Falling threshold : 5(linked with event 1)
When startup enables : risingOrFallingAlarm
This entry will exist : forever.
Latest value : 0
Table 1-5 display rmon prialarm command output description
Field |
Description |
Prialarm table 1 |
Index of extended alarm entry. |
owned by monitor |
Creator of the extended alarm entry. |
UNDERCREATION |
Status of expansion alarms |
Samples type |
Type of sampling |
Variable formula |
Formula for expansion alarms |
Description |
Description information |
Sampling interval : 10(sec) |
Sampling interval |
Rising threshold : 50 |
Rising threshold. When sampling value rises from normal value to this threshold, rising threshold alarm will be triggered. |
Falling threshold : 5 |
Falling threshold. When sampling value decreases from normal value to this threshold, falling threshold alarm will be triggered. |
linked with event 1 |
Corresponding event index of ring and falling threshold alarm. |
When startup enables: risingOrFallingAlarm |
Kind of first alarm. It may trigger rising threshold alarm or falling threshold alarm or both. |
This entry will exist forever |
The lifespan of this alarm entry which can be forever or a specified period of time. |
Latest value : 0 |
The value of the latest sampling. |
1.1.6 display rmon statistics
Syntax
display rmon statistics [ port-num ]
View
Any view
Parameters
port-num: Ethernet port number.
Description
Use the display rmon statistics command to view RMON statistics.
The displayed information includes collision, CRC (Cyclic Redundancy Check) and queue, undersized or oversized packet, timeout, fragment, broadcast, multicast, unicast, and bandwidth utility.
Related commands: rmon statistics.
Examples
# Show RMON statistics.
<H3C> display rmon statistics Ethernet 2/1/1
Statistics entry 1 owned by aaa is VALID.
Interface : Ethernet2/1/1<ifIndex.872418178>
etherStatsOctets : 756 , etherStatsPkts : 9
etherStatsBroadcastPkts : 9 , etherStatsMulticastPkts : 0
etherStatsUndersizePkts : 0 , etherStatsOversizePkts : 0
etherStatsFragments : 0 , etherStatsJabbers : 0
etherStatsCRCAlignErrors : 0 , etherStatsCollisions : 0
etherStatsDropEvents (insufficient resources): 0
Packets received according to length (etherStatsPktsXXXtoYYYOctets):
64 : 0 , 65-127 : 444 , 128-255 : 0
256-511: 0 , 512-1023: 0 , 1024-max : 0
1.1.7 rmon alarm
Syntax
rmon alarm entry-number alarm-variable sampling-time { delta | absolute } rising-threshold threshold-value1 event-entry1 falling-threshold threshold-value2 event-entry2 [ owner text ]
undo rmon alarm entry-number
View
System view
Parameters
entry-number: Number of the entry to be added/deleted, ranging from 1 to 65535.
alarm-variable: Specifies the alarm variable with a character string, ranging from 1 to 256, in the OID dotted format, like 1.3.6.1.2.1.2.1.10.1 (or ifInOctets.1).
sampling-time: Specifies the sampling interval, ranging from 5 to 65535 (measured in seconds).
delta: Sampling type is delta.
absolute: Sampling type is absolute.
rising-threshold threshold-value1: Rising threshold, ranging from 0 to 2147483647.
event-entry1: Event number corresponding to the upper limit of threshold, ranging from 0 to 65535.
falling-threshold threshold-value2: Falling threshold, ranging from 0 to 2147483647.
event-entry2: Event number corresponding to the falling threshold, ranging from 0 to 65535.
owner text: Specifies the creator of the alarm. Length of the character string ranges from 1 to 127.
Description
Use the rmon alarm command to add an entry to the alarm table.
Use the undo rmon alarm command to cancel an entry from this table.
In this way, the alarm event can be triggered in the abnormal situations and then decides to log and send trap to the NM station.
& Note:
Before adding an alarm entry, you need first to define the event to be referenced in the alarm entry using the rmon event command.
The system takes these actions on the defined alarm entries:
l Sampling the defined alarm variables at a specified time interval.
l Comparing the sample values against the predefined threshold and take further actions (see Table 1-6).
Table 1-6 Handling alarm entries
Item |
Handling |
The sample value is greater than the upper limit threshold-value1. |
Triggers the defined event event-entry1 |
The sample value is less than the lower limit threshold-value2. |
Triggers the defined event event-entry2 |
Examples
# Create alarm group
l Configure an event before configuring “alarm” and “prialarm”.
[H3C]rmon event 1 log owner test-rmon
l View configuration information.
[H3C]display rmon event 1
Event table 1 owned by test-rmon is VALID.
Description: null.
Will cause log when triggered, last triggered at 1days 01h:42m:09s.
l Configure alarm group.
# Add the first line in the alarm table. Sample the nodes 1.3.6.1.2.1.16.1.1.1.4.1 every 10 seconds. Trigger event 1 when the sampling value exceeds the upper threshold 50, and trigger event 2 when the sampling value gets below the lower threshold 5. The owner is user1.
<H3C> system-view
[H3C]rmon alarm 1 1.3.6.1.2.1.16.1.1.1.4.1 10 absolute rising_threshold 50 1 falling_threshold 5 2 owner user1
# Delete the information of entry 15 from the alarm table.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] undo rmon alarm 15
1.1.8 rmon event
Syntax
rmon event event-entry [ description string ] { log | trap trap-community | log-trap log-trapcommunity | none } [ owner text ]
undo rmon event event-entry
View
System view
Parameters
event-entry: Number of the entry to be added/deleted, ranging from 1 to 65535.
description string: Event description. Length of the character string ranges from 1 to 127.
log-trap log-trapcommunity: Defines the event as log and trap event, and specifies the community name of the NMS which receives the messages triggered by the event.
log: Log event.
trap trap-community: Defines the event as trap event, and specifies the community name of the NMS which receives the messages triggered by the event.
none: Neither log nor trap event.
owner text: Creator for this entry. The length of the character string ranges from 1 to 127.
Description
Use the rmon event command to add an entry to the event table.
Use the undo rmon event command to cancel an entry from this table.
RMON event management defines the event ID and the handling of the event.
You can handle the event in the following ways:
l Keeping logs
l Sending the trap messages to NMS
l Keeping logs and sending the trap messages to NMS
Examples
# Add the entry 10 to the event table and marks it as log event.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] rmon event 10 log
1.1.9 rmon history
Syntax
rmon history entry-number buckets number interval sampling-interval [ owner text-string ]
undo rmon history entry-number
View
Ethernet port view
Parameters
entry-number: Number of the entry to be added/deleted, ranging from 1 to 65,535.
buckets number: Capacity of the history table corresponding to the control line.
interval sampling-interval: Sampling interval, ranging from 5 to 3600 (measured in seconds).
owner text-string: Creator of this entry. Length of the character string ranges from 1 to 127.
Description
Use the rmon history command to add an entry to the history control table.
Use the undo rmon history command to cancel an entry from history control table.
Perform this command to sample, set sample parameter (sample time interval) and storage amounts for a port. RMON will periodically perform data collection and save for query on this port. Sample information includes utility, error number and total packet number.
Related commands: display rmon history.
Examples
# Create a history control table entry with the index number of 15, capacity of 100 and sampling interval of 10 seconds. The owner is tester.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface Ethernet 2/1/1
[H3C-Ethernet2/1/1] rmon history 15 buckets 100 interval 10 owner tester
1.1.10 rmon prialarm
Syntax
rmon prialarm entry-number prialarm-formula prialarm-des sampling-timer { delta | absolute | changeratio } rising-threshold threshold-value1 event-entry1 falling-threshold threshold-value2 event-entry2 entrytype { forever | cycle cycle-period } [ owner text ]
undo rmon prialarm entry-number
View
System view
Parameters
entry-number: Specifies the entry number, ranging from 1 to 65535.
prialarm-formula: Variables in the formula must be represented by OID, for example, (1.3.6.1.2.1.2.1.10.1)*8. The operation results are in long integers. Every operation result must be within the range of the long integer; otherwise, errors may be prompted.
prialarm-des : Specifies the alarm description with a length ranging from 1 to 256;
sampling-timer: Sets the sampling interval, ranging from 10 to 65535 and measured in seconds.
delta | absolute | changeratio: Specifies the sampling type as delta ratio, absolute ratio or change ratio.
threshold-value1: Rising threshold value, specified with a number greater than 0.
event-entry1: Corresponding event number to the upper limit threshold value, ranging from 0 to 65535.
threshold-value2: Falling threshold value, specified with a number greater than 0.
event-entry2: Event number corresponding to the falling threshold, ranging from 0 to 65535.
forever | cycle cycle-period: Specifies the type of the alarm instance line.
cycle-period specifies the functional cycle of the instance.
owner text: Creator of this entry. Length of the character string ranges from 1 to 127.
Description
Use the rmon prialarm command to add an entry to the extended RMON alarm table.
Use the undo rmon prialarm command to cancel an entry from the extended RMON alarm table.
The number of instances can be created in the table depends on the hardware resource of the product.
& Note:
Before adding an extended alarm entry, you need first to define the event to be referenced in the extended alarm entry using the rmon event command.
You can define up to 50 prialarm entries.
The system takes these actions on the extended alarm entries you defined:
l Sampling the alarm variables in the defined extended alarm formula at a specified time interval.
l Calculating the sample value using the defined extended alarm formula.
l Comparing the sample values against the predefined threshold and take further actions (see Table 1-7).
Table 1-7 Handling extended alarm entries
Item |
Handling |
The calculated sample value is greater than the upper limit threshold-value1. |
Triggers the defined event event-entry1 |
The calculated sample value is less than the lower limit threshold-value2. |
Triggers the defined event event-entry2 |
Examples
# Add an extended alarm entry in the fifth line of the extended alarm table. Perform operation on the corresponding variant by means of the formula ((.1.3.6.1.4.1.43.45.1.6.1.2.1.1.2.1-.1.3.6.1.4.1.43.45.1.6.1.2.1.1.3.1)*100/.1.3.6.1.4.1.43.45.1.6.1.2.1.1.2.1) to get the port utilization of Gigabit Ethernet interface 1/1/1. Monitor the operation results at the sampling interval of 10 seconds. When the variation rate exceeds the upper threshold 50, trigger event 1; when the variation rate gets below the lower threshold 2, trigger event 2. Set the alarm instance sampling type to “forever”, and set the owner of the extended alarm table to “user1”.
<H3C> system-view
[H3C] rmon prialarm 5 ((.1.3.6.1.4.1.43.45.1.6.1.2.1.1.2.1-.1.3.6.1.4.1.43.45.1.6.1.2.1.1.3.1)*100/.1.3.6.1.4.1.43.45.1.6.1.2.1.1.2.1) ifUtilization.GigabitEthernet1/1/1 10 changeratio rising_threshold 50 1 falling_threshold 5 2 entrytype forever owner user1
# Delete line 10 from the extended RMON alarm table.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] undo rmon prialarm 10
1.1.11 rmon statistics
Syntax
rmon statistics entry-number [ owner text-string ]
undo rmon statistics entry-number
View
Ethernet port view
Parameters
entry-number: Number of the entry to be added/deleted, ranging from 1 to 65535.
owner text-string: Creator of this entry. Length of the character string ranges from 1 to 127.
Description
Use the rmon statistics command to add an entry to the statistic table.
Use the undo rmon statistics command to cancel an entry from statistic table.
RMON statistic management concerns the statistics and monitoring of the usage and error on a port. Statistics includes collision, undersized or oversized packet, timeout, fragment, broadcast, multicast, unicast, and bandwidth utility.
Related commands: display rmon statistics.
Examples
# Add statistics of Ethernet 2/1/1 to the entry 20.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C]interface Ethernet 2/1/1