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

north
    keyboard_arrow_up
    keyboard_arrow_down
    description
    print
    feedback
    support
    business
    rss_feed
    south