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.
tx-only Specifies transmit statistics.

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.

The number of VLANs that can be monitored is dependent on filtering resources on the involved 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 switch:

configure ports 2,3 monitor vlan finance tx-only

History

This command was first available in ExtremeXOS 12.0.

Support for ExtremeSwitching switches was added in ExtremeXOS 12.5.

The vlan_list variable was added in ExtremeXOS 16.1.

Platform Availability

This command is available on ExtremeSwitching 5320, 5420, 5520, and 5720 series switches.