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:  The output fields for hypervisor and VM information are not automatically populated. In future releases, this information is gathered 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.


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|

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|

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

Specifies the most recent caller for this entry.

[reason activate|deactivate|port-move|

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

Specifies most recent reason for this entry.

changes owner|mac|ip|num-ips|config-intf|intf|ports|state|local-intf|local-ports|local-state|alt-owner|

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.

vlan vlan-id

Filter output by the VLAN ID.

vxlan vxlan-id

Filter output by the VXLAN ID.

vnet vnet-name

Specify the VNET assigned to the vPort.

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

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.

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

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

Filter output by owner state.

status hy-up|up|disabled|hw-nat-loop|mirror-loop|mirror-to|inuse|PN-switch|PN-fabric|PN-other|PN-cluster|PN-internal|PN-hypervisor|PN-guest|snmp-host|host|uplink|drop-pkts|no-pktin|no-fwd|no-flood|STP-BPDUs|LLDP|trunk|l3-port|remote-l3-port|vdp|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|vxlan-loopback|

Filter output by the status of the vPort.

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.

Formatting Options

format fields-to-display

Display output using a specific parameter. Use all to display all possible output.

parsable-delim character

Display output formatted for machine parsing using a specified delimiter.


Display output in ascending order.


Display output in descending order.

show dups

Display duplicate entries in the output.

layout vertical|horizontal

Format the output in a vertical or horizontal layout.

show-interval seconds-interval

Repeat the show command at a specified interval.


Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.


Display the number of entries in the output. This is useful with vRouter show commands.


Display full values in the output instead of scaled approximate values.


Display integer values instead of mapped values


Aggregate output by specific parameters. If sum-by fields are specified, records that have the same value in sum-by fields are combined and displayed as one aggregate record. NOTE: This option is only available for show commands that collect statistics such as connection-stats-show.

Defaults   None

Access   CLI


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.

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

See Also