trap-threshold { input-rate | output-rate }

Function

The trap-threshold { input-rate | output-rate } command sets the threshold for bandwidth utilization of the incoming traffic or bandwidth utilization of the outgoing traffic.

The undo trap-threshold { input-rate | output-rate } command restores the threshold for bandwidth utilization of the incoming traffic or bandwidth utilization of the outgoing traffic to the default value.

Format

trap-threshold { input-rate | output-rate } bandwidth-in-use [ resume-rate resume-threshold ]

undo trap-threshold { input-rate | output-rate }

Parameters

Parameter	Description	Value
input-rate	Sets the threshold for bandwidth utilization of the incoming traffic.	-
output-rate	Sets the threshold for bandwidth utilization of the outgoing traffic.	-
bandwidth-in-use	Specifies the threshold for bandwidth utilization.	It is an integer that ranges from 1 to 100, in percentage. The default value is 90%.
resume-rate resume-threshold	Specifies the bandwidth usage threshold for clearing a trap.	The value is an integer ranging from 1 to the value of bandwidth-in-use. The default value is equal to the value of bandwidth-in-use.

Views

Ethernet interface view, Ethernet sub-interface view, Layer-2 Ethernet Interface view, Layer-2 Ethernet sub-interface view

Default Level

2: Configuration level

Usage Guidelines

This command can't be backed up to the standby device.

The device detects the interface bandwidth usage every 1s. If the bandwidth usage is higher than the upper threshold or lower than the recovery threshold constantly, the device does not send alarms repeatedly.

When the bandwidth utilization exceeds the threshold, the system generates an alarm message and sends it to the NMS. When the bandwidth utilization falls below the threshold, the system generates an alarm recovery message and sends it to the NMS.

The threshold for bandwidth utilization should be set as required.

Bandwidth usage helps understand loads on the current device. If bandwidth usage exceeds a set threshold, bandwidth resources become insufficient and need an increase. For example, if bandwidth usage exceeds 95% of total bandwidth, a trap is generated, indicating that bandwidth is exhausting. Some services may be interrupted before the bandwidth is increased. To prevent service interruption, setting two bandwidth usage thresholds, one for generating a log and the other for generating a trap helps you increase bandwidth in time.

Outbound bandwidth usage = (Outbound interface rate/Outbound physical interface bandwidth) x 100

Inbound bandwidth usage = (Inbound interface rate/Inbound physical interface bandwidth) x 100

The log-threshold command sets the bandwidth usage threshold for generating a log.

The trap-threshold { input-rate | output-rate } command sets the bandwidth usage threshold for generating a trap.

trap-threshold input-rate bandwidth-in-use resume-rate resume-threshold: sets the inbound bandwidth usage threshold for generating a trap.
- If inbound bandwidth usage exceeds the threshold specified in bandwidth-in-use, an hwIfMonitorInputRateRising trap is generated, prompting for a bandwidth increase request.
- If outbound bandwidth usage goes below the threshold specified in resume-threshold, an hwIfMonitorInputRateResume trap is generated, indicating that bandwidth usage has been restored.
trap-threshold output-rate bandwidth-in-use resume-rate resume-threshold: sets the outbound bandwidth usage threshold for generating a trap.
- If outbound bandwidth usage value exceeds the value of bandwidth-in-use, an hwIfMonitorOutputRateRising trap is generated, prompting for a bandwidth increase.
- If outbound bandwidth usage goes below the threshold specified in resume-threshold, an hwIfMonitorOutputRateResume trap is generated, indicating that bandwidth usage has been restored.

If the offset between the value of bandwidth-in-use and the value of resume-threshold is too large or small, trap information may be frequently displayed.

The log threshold must be lower than the trap threshold, providing efficient protection for services. For example, when the inbound bandwidth usage reaches 80%, a log is generated. If the inbound bandwidth usage continues to increase and reaches 95%, a trap is generated. This ensures that a log is generated for inbound bandwidth usage of 80%, and a trap is generated for inbound bandwidth usage of 95%. Either the log or the trap prompts for a bandwidth increase, preventing service interruption.

Example

# Set the alarm threshold for bandwidth utilization of the outgoing traffic to 80% of the total bandwidth on GE 1/0/0.

<sysname> system-view

[sysname] interface GigabitEthernet 0/0/0

[sysname-GigabitEthernet0/0/0] trap-threshold output-rate 80

# Restore the threshold for bandwidth utilization of the incoming traffic to the default value on GE 1/0/0.

<sysname> system-view

[sysname] interface GigabitEthernet 0/0/0

[sysname-GigabitEthernet0/0/0] undo trap-threshold input-rate

# Set the outbound bandwidth usage threshold for generating a trap to 80% and the outbound bandwidth usage threshold for clearing the trap to 60%.

<sysname> system-view
[sysname] interface GigabitEthernet 0/0/0
[sysname-GigabitEthernet0/0/0] trap-threshold output-rate 80 resume-rate 60