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

north
    keyboard_arrow_up
    keyboard_arrow_down
    description
    print
    feedback
    support
    business
    rss_feed
    south