Published On: August 6ᵗʰ, 2019 02:08
Cisco Enterprise Network Function Virtualization Infrastructure Software Command Reference
Span Session and Packet Capture Commands
source
To configure the source interface for a SPAN session, use the source command in session configuration mode. To remove the source configuration, use the no form of the command.
source { all interface interface-name vlan vlan-id vm-vnic vm-name vnic-id }
no source { all interface interface-name vlan vlan-id vm-vnic vm-name vnic-id }
Syntax Description
| all |
Specifies all supported interfaces for a SPAN session. |
| interface interface-name |
Specifies a physical interface. |
| vlan vlan-id |
Specifies a VLAN interface. Range: 1 to 4094. |
| vm-vnic vm-name |
Specifies a vNIC interface with the VM name. |
| vnic-id |
Specifies the VNIC ID. Range: 0 to 8. |
Command Default
None
Command Modes
Session configuration (config-session-2)#
Command History
| Release | Modification |
|---|---|
| 3.5.1 |
This command was introduced. |
Usage Guidelines
In the case of virtio net or SRIOV VF, you have to specify the VM group name and NIC ID of the VM interface. If the VM vNIC is virtio net type, then the SPAN session is applied on the OVS bridge. If VM vNIC is SRIOV VF, then the mirror is applied to the hardware bridge. The interface name is specified for a physical interface, for example, GE0-0 or eth0.
Examples
The following configuration shows how to configure a source interface for a SPAN session:
nfvis(config)# monitor session 2 nfvis(config-session-2)# bridge lan-br nfvis(config-session-2)# source interface GE0-0 nfvis(config-session-2)# commit
destination
To configure the destination interface for a SPAN session, use the destination command in session configuration mode. To remove the destination configuration, use the no form of the command
destination { interface interface-name vlan vlan-id vm-vnic vm-name vnic-id }
no destination { interface interface-name vlan vlan-id vm-vnic vm-name vnic-id }
Syntax Description
| interface interface-name |
Specifies a physical interface. |
| vlan vlan-id |
Specifies a VLAN interface. Range: 1 to 4094. |
| vm-vnic vm-name |
Specifies a vNIC interface with the VM name. |
| vnic-id |
Specifies the VNIC ID. Range: 0 to 8. |
Command Default
None
Command Modes
Session configuration (config-session-2)#
Command History
| Release | Modification |
|---|---|
| 3.5.1 |
This command was introduced. |
Usage Guidelines
You must dedicate a destination port for SPAN use. Except for traffic that is required for the SPAN session, destination ports do not receive or forward traffic. When the SPAN is configured on the system, there might be some performance hit.
Examples
The following configuration shows how to configure a destination interface for a SPAN session:
nfvis(config)# monitor session 2 nfvis(config-session-2)# bridge lan-br nfvis(config-session-2)# destination vm-vnic 0
show system monitor session
To display the Switched Port Analyzer (SPAN) session details, use the show system monitor session command in privileged EXEC mode.
show system monitor session
Syntax Description
|
This command has no arguments or keywords. |
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
| Release | Modification |
|---|---|
| 3.5.1 |
This command was introduced. |
Examples
The following is a sample output of the show system monitor session command:
nfvis# show system monitor session system monitor session 2 bridge wan-br destination_vlan "" destination_interface vnic0 source_vlans "" source_rx_interfaces "GE0-0" source_tx_interfaces "GE0-0" source_all false statistics "tx_bytes=142660, tx_packets=1380"
monitor session
To create a SPAN session, use the monitor session command in global configuration mode. To remove the SPAN session, use the no form of the command.
monitor session number
no monitor session
Syntax Description
| number |
Specifies the SPAN session number. Valid range: 1-64 |
Command Default
None
Command Modes
Global configuration (config)
Command History
| Release | Modification |
|---|---|
| 3.5.1 |
This command was introduced. |
Examples
The following example shows how to create a SPAN session:
nfvis(config)# monitor session 2 nfvis(config)# commit
tcpdump port
To configure the packet capture feature on a physical port, use the tcpdump port command in global configuration mode. Use the no form of the command to remove the packet capture.
tcpdump port port-name [ filter filter-name protocol { ARP | ICMP | TCP | UDP } time seconds ]
no tcpdump port port-name
Syntax Description
Command Default
None
Command Modes
Global configuration (config)
Command History
| Release | Modification |
|---|---|
| 3.5.1 |
This command was introduced. |
Examples
The following example shows how to configure packet capture on a physical port:
nfvis(config)# tcpdump port eth0 filter filter1 time 30 pcap-location /data/intdatastore/pktcaptures/tcpdump_eth0.pcap nfvis(config)# commit
tcpdump vnic
To configure the packet capture feature on a virtual network interface controller, use the tcpdump vnic command in global configuration mode. Use the no form of the command to remove the packet capture.
tcpdump vnic tenant-name name deployment-name name vm-name name vnic-id id [ filter filter-name protocol { ARP | ICMP | TCP | UDP } time seconds ]
no tcpdump vnic tenant-name name deployment-name name vm-name name vnic-id id
Syntax Description
Command Default
None
Command Modes
Global configuration (config)
Command History
| Release | Modification |
|---|---|
| 3.5.1 |
This command was introduced. |
Examples
The following example shows how to configure packet capture on a vNIC:
nfvis(config)# tcpdump vnic tenant-name admin deployment-name 1489084431 vm-name ROUTER vnic-id 0 time 30 pcap-location /data/intdatastore/pktcaptures/1489084431_ROUTER_vnic0.pcap nfvis(config)# commit