configure ports monitor vlan

configure ports [port_list|all] monitor vlan [vlan_name | vlan_list] {rx-only | tx-only}

Description

Starts counting VLAN statistics on a port or a group of ports.

Syntax Description

port_list Specifies one or more ports. May be in the form: 1, 2, 3-5, 2:5, 2:6-2:8.
all Specifies all ports.
vlan_name Specifies a VLAN name.
vlan_list Specifies a VLAN list of IDs.
rx-only Specifies receive statistics. (BlackDiamond X8 series switches, BlackDiamond 8000 series modules and Summit family switches only.)
tx-only Specifies transmit statistics. (BlackDiamond X8 series switches, BlackDiamond 8900 series modules and Summit X460, X480, and X670 switches only.)

Default

N/A.

Usage Guidelines

Use this command to configure access to VLAN statistics per port.

The rx-only and tx-only parameters are intended for, but not restricted to, use on ports that support both receive and transmit statistics. Ports on slots that do not support transmit statistics do not require explicit use of the rx-only keyword. In the absence of specifying either rx-only or tx-only, both RX and TX VLAN statistics are gathered if both are supported on the configured port.

When both receive and transmit statistics are configured and resources for either receive or transmit are not available, neither receive nor transmit statistics will be configured.

On BlackDiamond 8000 series modules and Summit family switches, the number of VLANs that can be monitored is dependent on filtering resources on the involved module or switch.

When per-port monitoring is configured, the following commands display the latest statistics directly from the hardware in real time. This information is not logged.

To display VLAN statistics at the port level, use the following command:

show ports {port_list} vlan statistics {no-refresh | refresh}

To display VLAN statistics at the VLAN level, use the following command:

show vlan {vlan_name | vlan_list} statistics

Example

The following example configures per-port monitoring of transmit statistics for a set of ports for the VLAN named finance on a Summit X480 switch:

configure ports 2,3 monitor vlan finance tx-only

History

This command was first available in ExtremeXOS 12.0.

Support for BlackDiamond 8000 series modules, SummitStack, and Summit family switches was added in ExtremeXOS 12.5.

The vlan_list variable was added in ExtremeXOS 16.1.

Platform Availability

This command is available only on BlackDiamond X8 series switches, BlackDiamond 8000 series modules, SummitStack and Summit family switches.