The rmon alarm command adds an entry to the alarm table.
The undo rmon alarm command deletes an entry from the alarm table.
rmon alarm entry-number alarm-OID sampling-time { absolute | changeratio | delta } rising-threshold threshold-value1 event-entry1 falling-threshold threshold-value2 event-entry2 [ startup-alarm { falling | rising | risingorfalling } ] [ owner owner-name ]
undo rmon alarm entry-number
| Parameter | Description | Value |
|---|---|---|
entry-number |
Specifies the index of the entry to be added or deleted. |
The value is an integer that ranges from 1 to 65535. |
alarm-OID |
Specifies the OID of a monitored object. |
The name is a string of 1 to 256 case-sensitive characters without spaces. When quotation marks are used around the string, spaces are allowed in the string. |
sampling-time |
Specifies the sampling interval. |
The value is an integer that ranges from 5 to 65535, in seconds. |
absolute |
Indicates that the sample type is absolute. The value is the sampled value at the end of the period. |
- |
changeratio |
Indicates that the sample type is changeratio. The value is Changing value/Sampling interval. |
- |
delta |
Indicates that the sample type is delta. The value is the difference between the samples at the beginning and end of the period. |
- |
rising-threshold threshold-value1 |
Specifies the rising threshold of sampled value. |
The value is an integer that ranges from 1 to 2147483647. |
event-entry1 |
Indicates the event index corresponding to the rising threshold. |
The value is an integer that ranges from 1 to 65535. |
falling-threshold threshold-value2 |
Specifies the falling threshold of sampled value. |
The value is an integer that ranges from 0 to 2147483646. |
event-entry2 |
Indicates the event index corresponding to the falling threshold. |
The value is an integer that ranges from 1 to 65535. |
startup-alarm { falling | rising | risingorfalling } |
Specifies the condition of sending an alarm when the system data is sampled for the first time.
NOTE:
An alarm is sen no matter whether the following sampled value exceeds the upper threshold value or the lower threshold value. |
- |
owner owner-name |
Indicates the owner of the alarm. |
The name is a string of 1 to 127 case-sensitive characters without spaces. When quotation marks are used around the string, spaces are allowed in the string. |
Usage Scenario
To monitor system running status, run the rmon alarm command to configure an alarm table and add an entry to the alarm table. After the command is executed, the RMON alarm function is enabled. The system obtains information about the monitored object at the specified interval, and compares the obtained value with the configured threshold. Then the system triggers the event according to the following table, and records log or sends a trap to the NMS.
Situation |
Action |
|---|---|
The sampled value is greater than or equal to the configured rising threshold threshold-value1. |
Trigger event-entry1. |
The sampled value is smaller than or equal to the configured falling threshold threshold-value2. |
Trigger event-entry2. |
Prerequisites
Before configuring alarm function for the specified object, run the rmon event command to define the associated events. Otherwise, events cannot be triggered even if alarms are generated.
If the alarm variables configured in RMON alarm function are MIB variables defined in the statistics group or history group, the Ethernet statistics function or history statistics function must be configured on the monitored Ethernet interface first. Otherwise, alarm entries cannot be created.
# Monitor the alarm threshold of etherStatsBroadcastPkts.1 (1.3.6.1.2.1.16.1.1.1.6.1) and sample the absolute value with an interval of 30 seconds. When the sampled value is greater than or equal to the upper threshold 500, event 1 is triggered. When the sampled value is less than or equal to the lower threshold 100, event 2 is triggered. The creator parameter indicates the owner that creates the event.
<HUAWEI> system-view [HUAWEI] interface gigabitethernet 0/0/1 [HUAWEI-GigabitEthernet0/0/1] rmon statistics 1 owner creator [HUAWEI-GigabitEthernet0/0/1] quit [HUAWEI] rmon event 1 log [HUAWEI] rmon event 2 trap public [HUAWEI] rmon alarm 1 1.3.6.1.2.1.16.1.1.1.6.1 30 absolute rising-threshold 500 1 falling-threshold 100 2 owner creator