vport-history-show
This command is used to display historical information about virtual ports on a fabric. Virtual ports track information about servers, virtual machines, and switches in a fabric.
Informational Note: Netvisor does not automatically populate the output fields for hypervisor and VM. In future releases, Netvisor gathers this information using a multicast communication across the fabric.
Syntax vport-history-show
time date/time: yyyy-mm-ddThh:mm:ss |
Specifies a point in tjme for displaying historical information. |
start-time date/time: yyyy-mm-ddThh:mm:ss |
Specifies the start time for vPort history collection. |
end-time date/time: yyyy-mm-ddThh:mm:ss |
Specifies the end time for vPort history collection. |
duration duration: #d#h#m#s |
Specifies the duration to collect the vPort history. |
interval duration: #d#h#m#s |
Specifies the intervals to collects vPort history. |
since-start |
Specifies to display all of the vPort history since collection began on the fabric. |
older-than duration: #d#h#m#s |
Specifies to display vPort information older than a specific duration. |
within-last duration: #d#h#m#s |
Specifies to display vPort information with a specific duration. |
log-type l2-save|l3-save|restart|l2-modify|l2-delete|l3-modify|l3-delete |
Filter output by the log type of each entry. The log-type column displays when a vPort is created, modified, saved, or deleted. |
caller init|config|status|switch-cb|cluster|gre|ARP|router|flow-cb|vdp|vlag|port|inject|evict|vxlan|stats|vnm-vnic|adjacency|stp|trunk|intsw|ttl1|flood|flush|retire|loop|dhcp|fabric|table|l3-age-out|vlan|l2-checker|igmp|l2-age-out|port-mirror|mac-move|cluster-status|cluster-status-delete|vxlan-routing|subnet|br-dom|vrf|ND|VSG|excess-move-protection|retire-tunnel-up|evpnsnoop-browse |
Specifies the feature that made the change for this entry. |
last-caller init|config|status|switch-cb|cluster|gre|ARP|router|flow-cb|vdp|vlag|port|inject|evict|vxlan|stats|vnm-vnic| adjacency|stp|trunk|intsw|ttl1|flood|flush|retire|loop|dhcp| fabric|table|l3-age-out|vlan|l2-checker|igmp|l2-age-out|port-mirror|mac-move|cluster-status|cluster-status-delete|vxlan-routing|subnet|br-dom|vrf|ND|VSG|excess-move-protection|retire-tunnel-up|evpnsnoop-browse |
Specifies the most recent caller for this entry. |
reason activate|deactivate|port-move|ip-move|ip-remove|batch-move|retire|break-loop|break-loop-timeout|create|modify|delete|policy|owner-status|remove-node|port-flags|check-owner|trunk-port-add|trunk-port-remove|move-router-if|age-out|hw-remove|restart|undo|flush|update-vxlan-vlan|needs-peer-status|owner-lost|owner-change|update-peer-only| user-delete|done|vm-metadata|excess-move-state-change |
Specifies the reason for history entry. |
last-reason activate|deactivate|port-move|ip-move|ip-remove|batch-move|retire|break-loop|break-loop-timeout|create|modify|delete|policy|owner-status|remove-node|port-flags|check-owner|trunk-port-add|trunk-port-remove|move-router-if|age-out|hw-remove|restart|undo|flush|update-vxlan-vlan|needs-peer-status|owner-lost|owner-change|update-peer-only|user-delete|done|vm-metadata|excess-move-state-change |
Specifies most recent reason for this entry. |
changes owner|mac|vnet|bd|inner-vlan|public-vlan|vxlan|num-ips|config-intf|intf|ports|state|local-intf|local-ports|local-state|alt-owner|alt-owner-port|alt-owner-ports|alt-owner-state|svc-name|hostname|entity|power|cpus|os|portgroup|pg-vlans|vswitch|vs-type|vnic-type|config|rem-switch|rem-intf|rem-ports|peer-intf|peer-state|peer-owner-state|status|vtep-ip|tunnel|create-time|last-seen|last-seen-since|vxlan-lru|hit|migrate|drops|hw-index|rt-if|hw-flags|mc-index |
Specifies what changed in this entry. |
count count-number |
Filter output by the number of entries summed using the sum-by argument. |
owner node-name |
the switch-id of the vPort. |
mac mac-address |
Filter output by the Filter output by MAC address. |
vnet vnet-name |
vNET assigned to the vPort. |
bd bridge-domain-name |
Bridge Domain assigned to vPort. |
vlan vlan-id |
Filter output by the VLAN ID. |
inner-vlan 0..4095 |
Q-in-Q inner VLAN assigned to vPort. |
vxlan vxlan-id |
Filter output by the VXLAN ID. |
public-vlan vlan-id |
Specify the ID of the public VLAN. |
ip ip-address |
Filter output by the IP address. |
num-ips num-ips-number |
Specify the number of IP addresses for the vPort. |
intf intf-number |
Filter output by the interface number. This is the port or trunk number of the vPort. |
config-intf config-intf-number |
Filter output by the configured interface of the vPort. |
ports port-list |
Filter output by the list of ports. |
state active|static|vrrp|tunnel|software|needs-peer-status|port-mac|hit|ageout-check|moving|loop-probe|local-tunnel|igmp-mac|user-flush|vxlan-loopback|router|update-peer-only|active-state-mismatch|peer-port-missing|peer-port-not-vlag|peer-port-not-orphaned|peer-port-not-cluster-link|sw-active|anycast|hsrp|invalid-vlan|owner-lost|cluster-link-down|vxlan-router|peer-force-resync|excess-mac-move-detected|excess-ip-move-detected|retry|evpn|evpn-wo-bgp|evpn-def-gw|evpn-delete |
Filter output by the state of the vPort. |
svc-name svc-name-string |
Specify the vCenter connection service name. |
hostname hostname-string |
Specify the host name of the switch. |
entity entity-string |
Specify the VM or VM Kernel device name. |
power none|powered-off|powered-on|standby|suspended|unknown |
Specify the vPort entry power status. |
cpus cpus-number |
Filter output by the number of CPUs assigned to the VM. |
os os-string |
Filter output by the OS installed on the VM. |
portgroup portgroup-string |
Specify the Port Group name associated with VM MAC address. |
pg-vlans vlan-list |
Specify the valid VLANs for the port group. |
vswitch vswitch-string |
Specify the vitual switch name associated with the NIC. |
vs-type none|host-vs|distributed-vs|unknown |
Specify the virtual switch type. |
vnic-type untagged|tagged|trunked|vm-mgmt|vm-kernel|vMotion|vSAN|FTL|rep|p-NFC|r-NFC|mgmt|unknown |
Specify the type of vNIC attached to the VM or VM Kernel. |
config none|owner|ip|port|hostname|entity|cpus|os |
The VM configuration. |
rem-switch node-name |
Filter output by the remote switch name. |
rem-intf rem-intf-number |
Filter output by the remote interface number. |
rem-ports port-list |
Filter output by the remote ports. |
peer-intf peer-intf-number |
Filter output by the peer interface. |
peer-state active|static|vrrp|tunnel|software|needs-peer-status|port-mac|hit|ageout-check|moving|loop-probe|local-tunnel|igmp-mac|user-flush|vxlan-loopback|router|update-peer-only|active-state-mismatch|peer-port-missing|peer-port-not-vlag|peer-port-not-orphaned|peer-port-not-cluster-link|sw-active|anycast|hsrp|invalid-vlan|owner-lost|cluster-link-down|vxlan-router|peer-force-resync|excess-mac-move-detected|excess-ip-move-detected|retry|evpn|evpn-wo-bgp|evpn-def-gw|evpn-delete |
Filter output by peer-state. |
peer-owner-state active|static|vrrp|tunnel|software|needs-peer-status|port-mac|hit|ageout-check|moving|loop-probe|local-tunnel|igmp-mac|user-flush|vxlan-loopback|router|update-peer-only|active-state-mismatch|peer-port-missing|peer-port-not-vlag|peer-port-not-orphaned|peer-port-not-cluster-link|sw-active|anycast|hsrp|invalid-vlan|owner-lost|cluster-link-down|vxlan-router|peer-force-resync|excess-mac-move-detected|excess-ip-move-detected|retry|evpn| evpn-wo-bgp|evpn-def-gw|evpn-delete |
Filter output by owner state. |
status phy-up|up|disabled|hw-nat-loop|mirror-loop|mirror-to|PN-switch|PN-fabric|PN-other|PN-cluster|PN-internal|host|uplink|STP-BPDUs|LLDP|trunk|l3-port|remote-l3-port|dhcp|dhcpsvr|blocked|no-BPDU|LACP-PDUs|vlag-active|vlag-blocked|stp-edge-port|LACP-wait|LACP-fallback|adjacency-wait|adjacency-check|vlag-wait|multicast-router|loop|congested|vxlan-loopback|vlan-up|vle|vle-wait|phy-down|down|enabled|err-disabled|err-bpdu-guard|mac-violation|stp-bpdu-guard|stp-root-guard|defer-bringup-wait |
Filter output by the status of the vPort. |
vtep-ip ip-address |
Displays the VTEP IP address. |
tunnel tunnel-string |
Specifies the vPort tunnel. |
create-time date/time: yyyy-mm-ddThh:mm:ss |
Filter output by the time that the vPort was created. |
last-seen date/time: yyyy-mm-ddThh:mm:s |
Filter output by the time that the vPort was last seen on the fabric. |
vxlan-lru date/time: yyyy-mm-ddTHH:mm:ss |
Filter output by the VXLAN LRU. |
hit hit-number |
Filter output by the number of received hits. |
migrate migrate-number |
Filter output by the number of times that the vPort migrated on the fabric. |
drops drops-number |
Filter output by the number of drops on the fabric. |
hw-index hw-index-number |
Filter by the hardware index. |
rt-if rt-if-string |
Filter by the router interface. |
hw-flags invalid-vlan|invalid-port |
Filter by hardware flags. |
mc-index mc-index-number |
L2 multicast group index in hardware. |
Defaults None
Access CLI
History
Version 2.2 |
Command introduced. |
Version 2.2.6 |
The parameters, stp-edge-port|LACP-wait| adjacency-wait|adjacency-check|vlag-wait|multicast-router, added. |
Version 2.3 |
The parameters, num-ips and vm-status, added. |
Version 2.3.1 |
The parameters, caller, last-call, reason, last-reason, and changes added. |
Version 2.4 |
The options, l3-modify, l3-save, and l3-delete, added to log-type. The parameters, peer-intf, peer-state, and peer-owner-state added. |
Version 2.4.1 |
The parameters, vnet and public-vlan, added. The options, retire|break-loop|break-loop-timeout, added to the parameter reason. The options vxlan-loopback|router, added to the parameter, state. The parameters, hw-index, rt-if, and hw-flags, added. |
Version 2.6.2 |
The parameter, svc-name, power, entity, portgroup, pg-vlans, vswitch, vs-type, and vnic-type, added. The parameters, hypervisor, vm-id, vm-name, vm-flavor, vm-status, memory, deprecated. |
Version 3.1.0 |
The parameters vtep-ip and ND added. |
Version |
The option host-disabled deprecated. |
Usage Use this command to display vPort history on the switch. vPorts are mirrored across the fabric so that every switch knows about all the L2 entries on the fabric. This is useful for troubleshooting connections across the fabric.
Examples To display vPort history, with the parameter since-start, use the following syntax:
CLI network-admin@switch > vport-history-show since-start format all layout vertical
time: 09-10,15:17:03
log-type: l2-modify
switch-id: pleaides24
mac: 64:0e:94:28:03:3e
vlan: 1
intf: 65
ports: 65
local-intf: 65
local-ports: 65
create-time: 09-10,15:17:06
time: 09-10,15:17:06
log-type: l2-modify
switch-id: pleaides24
mac: 64:0e:94:28:03:3e
vlan: 1
intf: 65
ports: 65
state: active
local-intf: 65
local-ports: 65
local-state: active
create-time: 09-10,15:17:06
last-seen: 09-10,15:17:06
hit: 1
time: 09-10,15:17:07
log-type: l2-modify