- Table of Contents
-
- 12-Network Management and Monitoring Command Reference
- 00-Preface
- 01-System maintenance and debugging commands
- 02-NQA commands
- 03-NTP commands
- 04-PoE commands
- 05-SNMP commands
- 06-RMON commands
- 07-NETCONF commands
- 08-EAA commands
- 09-Process monitoring and maintenance commands
- 10-Mirroring commands
- 11-NetStream commands
- 12-IPv6 NetStream commands
- 13-sFlow commands
- 14-Information center commands
- 15-GOLD commands
- 16-Packet capture commands
- Related Documents
-
Title | Size | Download |
---|---|---|
10-Mirroring commands | 70.25 KB |
mirroring-group mirroring-port (interface view)
mirroring-group mirroring-port (system view)
mirroring-group monitor-egress
mirroring-group monitor-port (interface view)
mirroring-group monitor-port (system view)
mirroring-group reflector-port
mirroring-group remote-probe vlan
Port mirroring commands
display mirroring-group
Use display mirroring-group to display mirroring group information.
Syntax
display mirroring-group { group-id | all | local | remote-destination | remote-source }
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4.
all: Specifies all mirroring groups.
local: Specifies local mirroring groups.
remote-destination: Specifies remote destination groups.
remote-source: Specifies remote source groups.
Usage guidelines
Mirroring group information includes the type, status, and content of a mirroring group. It is sorted by mirroring group number.
Examples
# Display information about all mirroring groups.
<Sysname> display mirroring-group all
Mirroring group 1:
Type: Local
Status: Active
Mirroring port:
GigabitEthernet1/0/1 Inbound
Monitor port: GigabitEthernet1/0/2
Mirroring group 6:
Type: Remote source
Status: Incomplete
Mirroring port:
GigabitEthernet1/0/4 Both
Remote probe VLAN: 1900
Mirroring group 9:
Type: Remote destination
Status: Active
Monitor port: GigabitEthernet1/0/6
Remote probe VLAN: 1901
Table 1 Command output
Field |
Description |
Mirroring group |
Number of the mirroring group. |
Type |
Type of the mirroring group: · Local. · Remote source. · Remote destination. |
Status |
Status of the mirroring group: · Active—The mirroring group has taken effect. · Incomplete—The mirroring group configuration is not complete and does not take effect. |
Mirroring port |
Source port. |
Mirroring CPU |
Source CPU. |
Monitor port |
Destination port. |
mirroring-group
Use mirroring-group to create a mirroring group.
Use undo mirroring-group to delete mirroring groups.
Syntax
mirroring-group group-id { local | remote-destination | remote-source }
undo mirroring-group { group-id | all | local | remote-destination | remote-source }
Default
No mirroring group exists on a switch.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4.
local: Specifies local mirroring groups.
remote-destination: Specifies remote destination groups.
remote-source: Specifies remote source groups.
all: Specifies all mirroring groups.
Examples
# Create local mirroring group 1.
<Sysname> system-view
[Sysname] mirroring-group 1 local
mirroring-group mirroring-cpu
Use mirroring-group mirroring-cpu to configure source CPUs for a mirroring group.
Use undo mirroring-group mirroring-cpu to remove source CPUs from a mirroring group.
Syntax
In standalone mode:
mirroring-group group-id mirroring-cpu slot slot-number-list { both | inbound | outbound }
undo mirroring-group group-id mirroring-cpu slot slot-number-list
In IRF mode:
mirroring-group group-id mirroring-cpu chassis chassis-number slot slot-number-list { both | inbound | outbound }
undo mirroring-group group-id mirroring-cpu chassis chassis-number slot slot-number-list
Default
No source CPU is configured for a mirroring group.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4. The specified mirroring group must already exist.
slot slot-number-list: Specifies the cards that hold the source CPUs. The slot-number-list argument specifies a space-separated list of up to eight card items. Each item specifies a card by its slot number or a range of cards in the format of start-slot-number to end-slot-number. The value for the end-slot-number argument must be equal to or greater than the value for the start-slot-number argument. (In standalone mode.)
chassis chassis-number slot slot-number-list: Specifies the cards that hold the source CPUs on the specified IRF member device. The chassis-number argument specifies the IRF member device ID. The slot-number-list argument specifies a space-separated list of up to eight card items. Each item specifies a card by its slot number or a range of cards in the format of start-slot-number to end-slot-number. The value for the end-slot-number argument must be equal to or greater than the value for the start-slot-number argument. (In IRF mode.)
both: Mirrors both received and sent packets.
inbound: Mirrors only received packets.
outbound: Mirrors only sent packets.
Usage guidelines
You can configure source CPUs only for local mirroring groups and remote source groups.
CPUs on the MPUs LSUM1MPU06B0 and LSUM1MPU10C0 cannot be configured as source CPUs.
In an IRF 3 system, CPUs on PEXs cannot be configured as source CPUs. For more information about IRF 3 systems and PEXs, see Virtual Technologies Configuration Guide.
Examples
# (In standalone mode.) Create local mirroring group 1 to monitor the bidirectional traffic of the CPU of the card in slot 1.
<Sysname> system-view
[Sysname] mirroring-group 1 local
[Sysname] mirroring-group 1 mirroring-cpu slot 1 both
# (In standalone mode.) Create remote source group 2 to monitor the bidirectional traffic of the CPU of the card in slot 2.
<Sysname> system-view
[Sysname] mirroring-group 2 remote-source
[Sysname] mirroring-group 2 mirroring-cpu slot 2 both
mirroring-group
mirroring-group mirroring-port (interface view)
Use mirroring-group mirroring-port to configure a source port for a mirroring group.
Use undo mirroring-group mirroring-port to remove a source port from a mirroring group.
Syntax
mirroring-group group-id mirroring-port { both | inbound | outbound }
undo mirroring-group group-id mirroring-port
Default
No source port is configured for a mirroring group.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4. The specified mirroring group must already exist.
both: Mirrors both received and sent packets.
inbound: Mirrors only received packets.
outbound: Mirrors only sent packets.
Usage guidelines
RPR logical interfaces support only local port mirroring and can only be configured as source ports for local mirroring groups. For more information about RPR logical interfaces, see High Availability Configuration Guide.
Layer 2 or Layer 3 aggregate interfaces cannot be configured as source ports for mirroring groups.
You can configure source ports only for local mirroring groups and remote source groups.
Do not assign a source port of a mirroring group to the remote probe VLAN of the mirroring group.
Do not configure an EVB-enabled port as a source port. For more information about EVB, see EVB Configuration Guide.
Typically, a port can act as a source port for only one mirroring group. On the switch, a port can be a source port for multiple mirroring groups that have different monitor ports.
A source port cannot be used as a reflector port, monitor port, or egress port.
Examples
# Create local mirroring group 1 to monitor the bidirectional traffic of GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] mirroring-group 1 local
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] mirroring-group 1 mirroring-port both
# Create remote source group 2 to monitor the bidirectional traffic of GigabitEthernet 1/0/2.
<Sysname> system-view
[Sysname] mirroring-group 2 remote-source
[Sysname] interface gigabitethernet 1/0/2
[Sysname-GigabitEthernet1/0/2] mirroring-group 2 mirroring-port both
Related commands
mirroring-group
mirroring-group mirroring-port (system view)
Use mirroring-group mirroring-port to configure source ports for a mirroring group.
Use undo mirroring-group mirroring-port to remove source ports from a mirroring group.
Syntax
mirroring-group group-id mirroring-port interface-list { both | inbound | outbound }
undo mirroring-group group-id mirroring-port interface-list
Default
No source port is configured for a mirroring group.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4. The specified mirroring group must already exist.
interface-list: Specifies a space-separated list of up to eight port items. Each item specifies a single port or a port range in the form of interface-type interface-number1 to interface-type interface-number2. The specified interfaces must be of the same type and on the same card. The value for the interface-number2 argument must be equal to or greater than the value for the interface-number1 argument.
both: Mirrors both received and sent packets.
inbound: Mirrors only received packets.
outbound: Mirrors only sent packets.
Usage guidelines
RPR logical interfaces support only local port mirroring and can only be configured as source ports for local mirroring groups. For more information about RPR logical interfaces, see High Availability Configuration Guide.
Layer 2 or Layer 3 aggregate interfaces cannot be configured as source ports for mirroring groups.
You can configure source ports only for local mirroring groups and remote source groups.
Do not assign a source port of a mirroring group to the remote probe VLAN of the mirroring group.
Do not configure an EVB-enabled port as a source port. For more information about EVB, see EVB Configuration Guide.
Typically, a port can act as a source port for only one mirroring group. On the switch, a port can be a source port for multiple mirroring groups that have different monitor ports.
A source port cannot be used as a reflector port, monitor port, or egress port.
Examples
# Create local mirroring group 1 to monitor the bidirectional traffic of GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] mirroring-group 1 local
[Sysname] mirroring-group 1 mirroring-port gigabitethernet 1/0/1 both
# Create remote source group 2 to monitor the bidirectional traffic of GigabitEthernet 1/0/2.
<Sysname> system-view
[Sysname] mirroring-group 2 remote-source
[Sysname] mirroring-group 2 mirroring-port gigabitethernet 1/0/2 both
mirroring-group
mirroring-group monitor-egress
Use mirroring-group monitor-egress to configure the egress port for a remote source group.
Use undo mirroring-group monitor-egress to remove the egress port from a remote source group.
Syntax
In system view:
mirroring-group group-id monitor-egress interface-type interface-number
undo mirroring-group group-id monitor-egress interface-type interface-number
In interface view:
mirroring-group group-id monitor-egress
undo mirroring-group group-id monitor-egress
Default
No egress port is configured for a mirroring group.
Views
System view, interface view
Predefined user roles
network-admin
mdc-admin
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4. The specified mirroring group must already exist.
interface-type interface-number: Specifies a port by its type and number.
Usage guidelines
You can configure egress ports only for remote source groups.
For port mirroring to work correctly, disable the following features on the egress port of a mirroring group:
· Spanning tree.
· 802.1X.
· IGMP snooping.
· Static ARP.
· MAC address learning.
Do not configure a port of an existing mirroring group as an egress port.
Examples
# Create remote source group 1. Configure GigabitEthernet 1/0/1 as its egress port in system view.
<Sysname> system-view
[Sysname] mirroring-group 1 remote-source
[Sysname] mirroring-group 1 monitor-egress gigabitethernet 1/0/1
# Create remote source group 2. Configure GigabitEthernet 1/0/2 as its egress port in interface view.
<Sysname> system-view
[Sysname] mirroring-group 2 remote-source
[Sysname] interface gigabitethernet 1/0/2
[Sysname-GigabitEthernet1/0/2] mirroring-group 2 monitor-egress
Related commands
mirroring-group
mirroring-group monitor-port (interface view)
Use mirroring-group monitor-port to configure a port as the monitor port for a mirroring group.
Use undo mirroring-group monitor-port to remove the monitor port from a mirroring group.
Syntax
mirroring-group group-id monitor-port
undo mirroring-group group-id monitor-port
Default
No monitor port is configured for a mirroring group.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4. The specified mirroring group must already exist.
Usage guidelines
You can configure monitor ports only for local mirroring groups and remote destination groups.
Do not enable the spanning tree feature on the monitor port of a mirroring group.
Do not configure an EVB-enabled port as a monitor port. For more information about EVB, see EVB Configuration Guide.
For a Layer 2 aggregate interface configured as the monitor port of a mirroring group, do not configure its member ports as source ports of the mirroring group.
Use a monitor port only for port mirroring, so the data monitoring device receives and analyzes only the mirrored traffic.
Do not configure a port of an existing mirroring group as a monitor port.
Examples
# Create local mirroring group 1 and configure GigabitEthernet 1/0/1 as its monitor port.
<Sysname> system-view
[Sysname] mirroring-group 1 local
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] mirroring-group 1 monitor-port
# Create remote destination group 2 and configure GigabitEthernet 1/0/2 as its monitor port.
<Sysname> system-view
[Sysname] mirroring-group 2 remote-destination
[Sysname] interface gigabitethernet 1/0/2
[Sysname-GigabitEthernet1/0/2] mirroring-group 2 monitor-port
Related commands
mirroring-group
mirroring-group monitor-port (system view)
Use mirroring-group monitor-port to configure a port as the monitor port for a mirroring group.
Use undo mirroring-group monitor-port to remove the monitor port from a mirroring group.
Syntax
mirroring-group group-id monitor-port interface-type interface-number
undo mirroring-group group-id monitor-port interface-type interface-number
Default
No monitor port is configured for a mirroring group.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4. The specified mirroring group must already exist.
interface-type interface-number: Specifies a port by its type and number.
Usage guidelines
You can configure monitor ports only for local mirroring groups and remote destination groups.
Do not enable the spanning tree feature on the monitor port of a mirroring group.
Do not configure an EVB-enabled port as a monitor port. For more information about EVB, see EVB Configuration Guide.
For a Layer 2 aggregate interface configured as the monitor port of a mirroring group, do not configure its member ports as source ports of the mirroring group.
Use a monitor port only for port mirroring, so the data monitoring device receives only the mirrored traffic.
Do not configure a port of an existing mirroring group as a monitor port.
Examples
# Create local mirroring group 1 and configure GigabitEthernet 1/0/1 as its monitor port.
<Sysname> system-view
[Sysname] mirroring-group 1 local
[Sysname] mirroring-group 1 monitor-port gigabitethernet 1/0/1
# Create remote destination group 2 and configure GigabitEthernet 1/0/2 as its monitor port.
<Sysname> system-view
[Sysname] mirroring-group 2 remote-destination
[Sysname] mirroring-group 2 monitor-port gigabitethernet 1/0/2
Related commands
mirroring-group
mirroring-group reflector-port
Use mirroring-group reflector-port to configure the reflector port for a remote source group.
Use undo mirroring-group reflector-port to remove the reflector port from a remote source group.
Syntax
In system view:
mirroring-group group-id reflector-port interface-type interface-number
undo mirroring-group group-id reflector-port interface-type interface-number
In interface view:
mirroring-group group-id reflector-port
undo mirroring-group group-id reflector-port
Default
No reflector port is configured for a mirroring group. A port does not act as the reflector port for a mirroring group.
Views
System view, interface view
Predefined user roles
network-admin
mdc-admin
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4. The specified mirroring group must already exist.
interface-type interface-number: Specifies a port by its type and number.
Usage guidelines
You can configure reflector ports only for remote source groups.
The port to be configured as a reflector port must be a port not in use. Do not connect a network cable to a reflector port.
When a port is configured as a reflector port, the port restores to the factory default settings. You cannot configure other features on a reflector port.
You can configure a port as a reflector port only when the port is operating with the default duplex mode, speed, and MDI settings. You cannot change these settings for a reflector port.
In an IRF 3 system, PEXs do not support reflector ports for Layer 2 remote port mirroring. For more information about IRF 3 and PEXs, see Virtual Technologies Configuration Guide.
Examples
# Create remote source group 1. Configure GigabitEthernet 1/0/1 as its reflector port in system view.
<Sysname> system-view
[Sysname] mirroring-group 1 remote-source
[Sysname] mirroring-group 1 reflector-port gigabitethernet 1/0/1
This operation may delete all settings made on the interface. Continue? [Y/N]: y
# Create remote source group 2. Configure GigabitEthernet 1/0/2 as its reflector port in interface view.
<Sysname> system-view
[Sysname] mirroring-group 2 remote-source
[Sysname] interface gigabitethernet 1/0/2
[Sysname-GigabitEthernet1/0/2] mirroring-group 2 reflector-port
This operation may delete all settings made on the interface. Continue? [Y/N]: y
Related commands
mirroring-group
mirroring-group remote-probe vlan
Use mirroring-group remote-probe vlan to specify a VLAN as the remote probe VLAN for a mirroring group.
Use undo mirroring-group remote-probe vlan to remove a remote probe VLAN from a mirroring group.
Syntax
mirroring-group group-id remote-probe vlan vlan-id
undo mirroring-group group-id remote-probe vlan vlan-id
Default
No remote probe VLAN is configured for a mirroring group.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
group-id: Specifies a mirroring group by its number in the range of 1 to 4. The specified mirroring group must already exist.
vlan-id: Specifies a VLAN by its ID.
Usage guidelines
You can configure remote probe VLANs only for remote source groups and remote destination groups.
When a VLAN is configured as a remote probe VLAN, use the VLAN for port mirroring exclusively.
The remote mirroring groups on the source device and destination device must use the same remote probe VLAN.
Only a static VLAN that already exists can be configured as a remote probe VLAN. A VLAN can be configured as the remote probe VLAN for only one mirroring group.
To delete a VLAN that is configured as a remote probe VLAN, remove the remote probe VLAN configuration first.
Examples
# Create remote source group 1 and configure VLAN 10 as its remote probe VLAN.
<Sysname> system-view
[Sysname] mirroring-group 1 remote-source
[Sysname] mirroring-group 1 remote-probe vlan 10
# Create remote destination group 2 and configure VLAN 20 as its remote probe VLAN.
<Sysname> system-view
[Sysname] mirroring-group 2 remote-destination
[Sysname] mirroring-group 2 remote-probe vlan 20
Related commands
mirroring-group
Flow mirroring commands
The flow mirroring commands are available on both Layer 2 and Layer 3 Ethernet interfaces. The term "interface" in this chapter collectively refers to these two types of interfaces. You can use the port link-mode command to configure an Ethernet port as a Layer 2 or Layer 3 interface (see Layer 2—LAN Switching Configuration Guide).
mirror-to
Use mirror-to to configure a mirroring action for a traffic behavior.
Use undo mirror-to to delete a mirroring action.
Syntax
mirror-to { cpu | interface interface-type interface-number }
undo mirror-to { cpu | interface interface-type interface-number }
Default
No mirroring action is configured for a traffic behavior.
Views
Traffic behavior view
Predefined user roles
network-admin
mdc-admin
Parameters
cpu: Specifies the CPU of the card that receives the packets matching the criteria defined in the traffic class.
interface interface-type interface-number: Specifies an interface by its type and number.
Usage guidelines
The switch supports mirroring traffic to multiple interfaces. You can configure multiple actions of mirroring traffic to these interfaces for a traffic behavior.
Examples
# Create traffic behavior 1 and configure the action of mirroring traffic to the CPU for the traffic behavior.
<Sysname> system-view
[Sysname] traffic behavior 1
[Sysname-behavior-1] mirror-to cpu
# Create traffic behavior 1 and configure the action of mirroring traffic to GigabitEthernet 1/0/1 for the traffic behavior.
<Sysname> system-view
[Sysname] traffic behavior 1
[Sysname-behavior-1] mirror-to interface gigabitethernet 1/0/1