port-queue-alarm (slot view)

Function

The port-queue-alarm buffer command configures an alarm threshold for the usage of port queues.

The undo port-queue-alarm buffer command cancels the configuration.

By default, there are no default alarm threshold for the port queues.

Format

port-queue-alarm cos-value buffer percentage percentage

undo port-queue-alarm cos-value buffer

Parameters

Parameter	Description	Value
cos-value	Specifies the class of service.	The value is an enumerated type and can be cs7, cs6, ef, af4, af3, af2, af1, or be, case-insensitive.
percentage percentage	Specifies an alarm threshold for the usage of queues.	The value is an integer in the range 0 to 100. If the value is 0, an alarm is generated as long as packets are transmitted.

Parameter

Description

Value

cos-value

Specifies the class of service.

The value is an enumerated type and can be cs7, cs6, ef, af4, af3, af2, af1, or be, case-insensitive.

percentage percentage

Specifies an alarm threshold for the usage of queues.

The value is an integer in the range 0 to 100.

If the value is 0, an alarm is generated as long as packets are transmitted.

Views

Slot view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
qos	write

Usage Guidelines

Usage Scenario

To monitor the use of queues, you can run the port-queue-alarm buffer command to configure an alarm threshold for the usage of queues. If the usage of a queue (the ratio of the current queue length to the total queue length) exceeds the alarm threshold, an alarm is sent.

An alarm threshold for the buffer usage in the port queue can be configured both in the slot view and interface view. Therefore, the conditions for the configurations to take effect are as follows:

In the slot view, this configuration takes effect on all interfaces of a slot. If the function is configured both in the slot view and the interface view, the command configuration in the interface view takes precedence over that in the slot view.
If the function is configured both in the slot view and the interface view, after the function is deleted in the interface view, the configuration takes effect in the slot view. After the function is deleted in the slot view, the configuration still takes effect in the interface view.
In VS mode, this command applies only to the admin VSand cannot be configured in other VSs. This command takes effect on all VSs.

Follow-up Procedure

If the usage of a queue exceeds the configured alarm threshold, run the queue-depth command to adjust the size of the queue cache.

Example

# Set the alarm threshold to 60% for AF1 queues in the outbound direction of an interface.

<HUAWEI> system-view
[~HUAWEI] slot 9
[~HUAWEI-slot-9] port-queue-alarm af1 buffer percentage 20