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 OS 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 |
The point in tjme for displaying historical information. |
start-time date/time: yyyy-mm-ddThh:mm:ss |
The start time for vPort history collection. |
end-time date/time: yyyy-mm-ddThh:mm:ss |
The end time for vPort history collection. |
duration duration: #d#h#m#s |
The duration to collect the vPort history. |
interval duration: #d#h#m#s |
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 |
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 |
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 |
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 |
The 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 |
The changes 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 |
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 |
The vCenter connection service name. |
hostname hostname-string |
The host name of the switch. |
entity entity-string |
The VM or VM Kernel device name. |
power none|powered-off|powered-on|standby|suspended|unknown |
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 |
The Port Group name associated with VM MAC address. |
pg-vlans vlan-list |
The valid VLANs for the port group. |
vswitch vswitch-string |
The virtual switch name associated with the NIC. |
vs-type none|host-vs|distributed-vs|unknown |
The virtual switch type. |
vnic-type untagged|tagged|trunked|vm-mgmt|vm-kernel|vMotion|vSAN|FTL|rep|p-NFC|r-NFC|mgmt|unknown |
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|host-disabled|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 |
The VTEP IP address. |
tunnel tunnel-string |
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. |
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