log-threshold input-rate output-rate
Function
The log-threshold input-rate output-rate command sets the inbound and outbound bandwidth usage thresholds for generating a log.
The undo log-threshold input-rate output-rate command restores the default inbound and outbound bandwidth usage thresholds for generating a log.
The default inbound and outbound bandwidth usage thresholds for generating a log is 80.
Format
log-threshold { input-rate | output-rate } bandwidth-in-use [ resume-rate resume-threshold ]
undo log-threshold { input-rate | output-rate }
Parameters
| Parameter | Description | Value |
|---|---|---|
input-rate |
Specifies the inbound bandwidth. |
- |
output-rate |
Specifies the outbound bandwidth. |
- |
bandwidth-in-use |
Specifies the bandwidth usage threshold for generating a log. |
The value is an integer that ranges from 1 to 100. |
resume-rate resume-threshold |
Specifies the bandwidth usage threshold for clearing a log. |
The value is an integer that ranges from 1 to the value of bandwidth-in-use. The default value is the value of bandwidth-in-use. |
Views
Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 25GE interface view, 40GE interface view, 100GE interface view
Usage Guidelines
Monitoring bandwidth usage helps you know current load on a device. If the bandwidth usage exceeds a threshold, bandwidth resources are insufficient and the device capacity needs to be expanded. For example, if the bandwidth usage exceeds 95%, an alarm is generated, indicating that bandwidth resources are almost exhausted. As a result, some services may be interrupted before device capacity expansion.
You can configure two thresholds: low threshold (log threshold) and high threshold (alarm threshold). The system generates a log when the bandwidth usage exceeds the low threshold and generates an alarm when the bandwidth usage exceeds the high threshold. This configuration ensures that you can expand the device capacity in advance to avoid service interruptions caused by bandwidth exhaustion.
Outbound bandwidth usage threshold = (Outbound interface rate/Outbound physical interface bandwidth) x 100
Inbound bandwidth usage threshold = (Inbound interface rate/Inbound physical interface bandwidth) x 100
The trap-threshold command is used to set the bandwidth usage threshold for generating a trap.
- log-threshold input-rate bandwidth-in-use resume-rate resume-threshold: sets the inbound bandwidth usage threshold for generating a log to provide the following functions:
- If inbound bandwidth usage value exceeds the value of bandwidth-in-use, an IFNET_BWRATE_IN_RISING log is generated, indicating that inbound bandwidth usage exceeds the configured threshold.
- If inbound bandwidth usage value is lower than the value of resume-threshold, an IFNET_BWRATE_IN_RESUME log is generated, indicating that inbound bandwidth usage is lower than the configured threshold.
- log-threshold output-rate bandwidth-in-use resume-rate resume-threshold: sets the outbound bandwidth usage threshold for generating a log to provide the following functions:
- If outbound bandwidth usage value exceeds the value of bandwidth-in-use, an IFNET_BWRATE_OUT_RISING log is generated, prompting for a bandwidth increase request.
- If outbound bandwidth usage falls below the threshold specified by resume-threshold, an IFNET_BWRATE_OUT_RESUME log 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 small, log 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
# Configure GE0/0/1 to generate a log when the outbound interface rate exceeds 80% of the bandwidth.
<HUAWEI> system-view [HUAWEI] interface gigabitethernet 0/0/1 [HUAWEI-GigabitEthernet0/0/1] log-threshold output-rate 80
# Configure GE0/0/1 to generate a log when the outbound interface rate exceeds 80% of the bandwidth and to clear a log when the outbound interface rate is lower than 60% of the bandwidth.
<HUAWEI> system-view [HUAWEI] interface gigabitethernet 0/0/1 [HUAWEI-GigabitEthernet0/0/1] log-threshold output-rate 80 resume-rate 60