printPrint Page

feedbackDocument Feedback

supportSupport & Services

businessPluribus Networks

LinkedIn

facebookFacebook

Twitter

connection-clear

To clear connection statistics for a switch, use the connection-clear command.

Syntax   connection-clear

Specify any of the following options:

time date/time: yyyy-mm-ddThh:mm:ss

Clear statistics from a specific timestamp period.

start-time date/time: yyyy-mm-ddThh:mm:ss

Clear statistics from a specific start time and date.

end-time date/time: yyyy-mm-ddThh:mm:ss

Clear statistic from a specific end time and date.

duration: #d#h#m#s

Clear statistics for a specific duration.

interval duration: #d#h#m#s

Clear statistics for a specific interval duration.

since-start

Clear statistics from the start of collection.

older-than duration: #d#h#m#s

Clear statistics older than a specified date and time.

within-last duration: #d#h#m#s

Clear statistics within a specified duration time.

count count-number

Clear the count number.

vlan vlan_id

Specifies the VLAN identifier.

egress-vnet vnet-name 

Specifies the egress VNET.

egress-bd bridge-domain name

Specifies the bridge domain of the connection information.

egress-vlan vlan_id

Specifies the egress VLAN of the connection.

vxlan vxlan-id

Specifies the VXLAN identifier.

vnet vnet-string

Specifies the name of the virtual network (VNET).

src-switch-port

Specifies the physical port number on the switch where a client requested a connection.

dst-switch-port

Specifies the physical port number on the switch where a server responded to a connection.

ether_type

Specifies the EtherType value or keyword of the connection. The keywords can be arp, dot1X, fcoe, fcoe-init, ipv4, ipv6, jumbo, lldp, macsec, mpls-multi, mpls-uni, ptp, qing, rarp, vlan, and wake.

src-mac-addr

Specifies the MAC address of the client requesting a connection.

dst-mac-addr

Specifies the MAC address of the server responding to a connection.

src-ip

Specifies the IP address of the client requesting a connection.

dst-ip

Specifies the IP address of the server responding to a connection.

src-port

Specifies the type of port used by the client requesting a connection. This includes HDFS, Hive, Ganglia, Cassandra, Nutanix and other server types.

dst-port

Specifies the type of port used by the server responding to a connection. This includes HDFS, Hive, Ganglia, Cassandra, Nutanix and other server types.

dscp

Specifies the 6-bit Differentiated Services Code Point (DSCP).

protocol tcp|udp|icmp|igmp|ip

Specifies the protocol.

tunnel-vnet vnet-name

Specifies the tunnel VNET name.

tunnel-bd bridge-domain name

Specifies the tunnel bridge domain.

tunnel-vlan vlan-id

Specifies the VLAN ID.

tunnel-src-mac mac-address

Specifies the tunnel source MAC address.

tunnel-dst-mac mac-address

Specifies the tunnel destination MAC address.

tunnel-src-ip ip-address

Specifies the tunnel source IP address

tunnel-dst-ip ip-address

Specifies the tunnel destination IP address.

tunnel-src-port

Specifies the type of port used by the client requesting a connection. This includes HDFS, Hive, Ganglia, Cassandra, Nutanix and other server types.

tunnel-dst-port

Specifies the type of port used by the client requesting a connection. This includes HDFS, Hive, Ganglia, Cassandra, Nutanix and other server types.

tunnel-proto tcp|udp|icmp|igmp|ip|icmpv6

Specifies the protocol assigned to the tunnel.

cur-state syn|est|fin|rst

Specifies the current state of the connection.

dur high resolution time:#ns

Specifies the duration for high resolution time in nano seconds.

latency high resolution time:#ns

Specifies the latency for high resolution time in nano seconds

latency(us)

Specifies the network transmit time (latency) experienced by the connection in microseconds.

obytes

Specifies the number of bytes sent from the client side of the connection.

ibytes

Specifies the number of bytes received by the client side of the connection.

total-bytes

Specifies the total number of bytes for the connection.

update-id high resolution time: #ns

Specifies the last update to the connection in elapse time (nanoseconds).

started-time-ns high resolution time: #ns

Specifies the started time of the connection in nanoseconds.

started-time date/time: yyyy-mm-ddThh:mm:ss

Specifies the time and date of the initial connection.

ended-time date/time: yyyy-mm-ddThh:mm:ss

Specifies the time and date when the connection ended.

transition-state

any|started-and-ended |started|ended|ongoing

Specifies the transition state of the connection.

Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

 Version 1.2.2

Command changed to connection-clear. bytes-sent and bytes-recvd changed to obytes and ibytes. older-than and within-last parameters added.

Version 2.1

The parameters, client and server, changed to src and dst. The parameter, service, is deprecated. The parameters, started-time, ended-time, and transition-state added.

Version 2.2

The parameter, no-since-start, deprecated.

Version 2.2.5

The parameters, HDFS-, added.

Version 2.4

The parameter, egress-vlan, added.

Version 2.4.1

The parameter, egress-vnet, added.

Version 2.6.2

The parameters, tunnel-*, added.

Version 5.1.1

The parameters, egress-bd, tunnel-bd, update-id high resolution time, and started-time-ns high resolution time added.

Usage   Clears statistical information about the current connections on the switch.

connection-show

To display connection statistics for a switch, use the connection-show command.

Syntax   connection-show

start-time date/time: yyyy-mm-ddThh:mm:ss

Specifies statistics from a specific start time and date.

end-time date/time: yyyy-mm-ddThh:mm:ss

Specifies statistic from a specific end time and date.

duration: #d#h#m#s

Specifies statistics for a specific duration.

interval duration: #d#h#m#s

Specifies statistics for a specific interval duration.

since-start

Specifies statistics from the start of collection. This is another way to specify the start time for the connection output.

older-than duration: #d#h#m#s

Specifies statistics older than a specified date and time. This is another way to specify the end time for the connection output.

within-last duration: #d#h#m#s

Specifies statistics within a specified duration time. This is another way to specify the start time for the connection output. Also, only the closed connections are displayed.

vlan vlan-id

Specifies the VLAN identifier.

egress-vnet vnet-name 

Specifies the egress VNET.

egress-vlan vlan_id

Specifies the egress VLAN of the connection.

vnet vnet-name

Specifies the name of the virtual network (VNET).

src-switch-port

Specifies the physical port number on the switch where a client requested a connection.

dst-switch-port

Specifies the physical port number on the switch where a server responded to a connection.

ether_type

Specifies the EtherType value or keyword of the connection. The keywords can be arp, dot1X, fcoe, fcoe-init, ipv4, ipv6, jumbo, lldp, macsec, mpls-multi, mpls-uni, ptp, qing, rarp, vlan, and wake.

src-mac-addr

Specifies the MAC address of the client requesting a connection.

dst-mac-addr

Specifies the MAC address of the server responding to a connection.

src-ip

Specifies the IP address of the client requesting a connection.

dst-ip

Specifies the IP address of the server responding to a connection.

src-port

 

Specifies the type of data on the source port. HDFS indicates ports connected to Hadoop systems. Also includes HDFS, Hive, Ganglia, Cassandra, Nutanix and other server types.

dst-port

Specifies the type of data on the destination port. This includes HDFS, Hive, Ganglia, Cassandra, Nutanix and other server types.

dscp

Specifies the 6-bit Differentiated Services Code Point (DSCP).

tunnel-vnet vnet-name

Specifies the tunnel VNET name.

tunnel-vlan vlan-id

Specifies the VLAN ID.

tunnel-src-mac mac-address

Specifies the tunnel source MAC address.

tunnel-dst-mac mac-address

Specifies the tunnel destination MAC address.

tunnel-src-ip ip-address

Specifies the tunnel source IP address

tunnel-dst-ip ip-address

Specifies the tunnel destination IP address.

tunnel-src-port

Specifies the type of port used by the client requesting a connection. This includes HDFS, Hive, Ganglia, Cassandra, Nutanix and other server types.

tunnel-dst-port

Specifies the type of port used by the client requesting a connection. This includes HDFS, Hive, Ganglia, Cassandra, Nutanix and other server types.

tunnel-proto tcp|udp|icmp|igmp|ip|icmpv6

Specifies the protocol assigned to the tunnel.

proto

[tcp|udp|icmp|igmp|ip

Specifies the protocol.

cur-state syn|est|fin|rst

Specifies the current state of the connection.

syn — synchronized

est — established

fin — finished

rst — reset

dur high resolution time: #ns

Specifies the duration of the connection.

latency(us)high resolution time: #ns

Specifies the network transmit time (latency) experienced by the connection in microseconds.

obytes

Specifies the number of bytes sent from the client side of the connection.

ibytes

Specifies the number of bytes received by the client side of the connection.

active

Specifies whether the connection is currently active or inactive.

age duration:#d#h#m#s

Specifies the duration of the connection in days, hours, minutes and seconds.

transition-state

any|started-and-ended |started| ended|ongoing

Specifies the transition state of the connection.

Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

 Version 1.2.2

Command changed to connection-clear. bytes-sent and bytes-recvd changed to obytes and ibytes. older-than and within-last parameters added.

Version 2.1

The parameters, client and server, changed to src and dst. The parameter, service, is deprecated. The parameters, started-time, ended-time, and transition-state added.

Version 2.2

The parameter, no-since-start, deprecated.

Version 2.2.5

The parameters, HDFS-, added.

Version 2.4

The parameter, egress-vlan, added.

Version 2.4.1

The parameter, egress-vnet, added.

Version 2.6.2

The parameters, tunnel-*, added.

Version 5.1.1

The parameters, egress-bd, tunnel-bd, update-id high resolution time, and started-time-ns high resolution time added.


Usage   Each switch maintains a set of standard flow-based statistics that are “always-on”, meaning that they are continuously tracked and updated by the switch. This command displays the TCP connections transiting the local switch as identified through the SYN/FIN protocol handshake between the client and the server of the application.

Examples  To show the connection statistics for vnet MyVNET, use the following command:

CLI network-admin@switch > connection-show vnet MyVNET layout vertical

switch:                              pleiades24

vlan:                                51

vxlan:                               0

vnet:                                

src-ip:                              10.222.1.1

dst-ip:                              10.222.1.2

client-switch-port:                  8000

server-switch-port:                  

client-port:                         

server-port:                         

dscp:                                

proto:                               

service dur(s:                       

latency(us):                         

bytes-sent:                          

bytes-recv:                          

active:                              

connection-latency-show

This command is used to display latency information for connections on the switch. Comparing latency information for connections at various times can show whether the network performance has changed or stayed the same, and potentially eliminate the network as the cause of the problem

Syntax   connection-latency-show

min high resolution time: #ns

Displays the minimum latency in nanoseconds.

max high resolution time: #ns

Displays the maximum latency in nanoseconds.

num-bins num-bins-number

Specify the number of bins to divide the latency range. Bins display the number of connections at each latency interval.

Defaults   None

Access   CLI

History   Command introduced in Version 2.0.

Usage   You can display all of the latency information about a connection or you can filter by the number of bins to display. Comparing latency information for connections at various times can show whether the network performance has changed or stayed the same, and potentially eliminate the network as the cause of the problem

Examples  To display all latency information on pleiades24, use the following command:

CLI network-admin@switch > connection-latency-show

switch     min    max   num-conns percent  avg-dur  obytes  ibytes  total-bytes

--------   ------ ------ --------- ------- ------- ------ ------ -----------

pleiades2  40.00ns 20.0us 13        0%              0      0      0           

pleiades24 20.0us 40.0us 80        3%      1.28us  146K   305K   451K        

pleiades24 40.0us 60.0us 671       28%     14.9us  1.19M  2.50M  3.69M       

pleiades24 60.0us 80.0us 649       27%     19.2us  1.16M  2.42M  3.57M       

pleiades24 80.0us 100us  337       14%     12.9us  615K   1.25M  1.86M       

pleiades24 100us  120us  219       9%      10.2us  400K   835K   1.21M       

pleiades24 120us  140us  114       4%      6.33us  208K   434K   642K        

pleiades24 140us  160us  63        2%      4.01us  115K   241K   356K        

pleiades24 160us  180us  58        2%      4.19us  106K   222K   327K        

pleiades24 180us  200us  35        1%      2.85us  63.9K  134K   198K        

pleiades24 200us         94        4%      13.2us  172K   359K   530K

connection-stats-clear

This command clears statistics collected while connected to the host.

Syntax   connection-stats-clear

time date/time: yyyy-mm-ddThh:mm:ss

Specify a time to clear the connection statistics.

start-time date/time:
yyyy-mm-ddThh:mm:ss

Clear statistics from a specific start time and date.

end-time date/time:
yyyy-mm-ddThh:mm:ss

Clear statistic from a specific end time and date.

duration: #d#h#m#s

Clear statistics for a specific duration.

interval duration: #d#h#m#s

Clear statistics for a specific interval duration.

since-start

Clear statistics from the start of collection.

older-than duration: #d#h#m#s

Clear statistics older than a specified date and time.

within-last duration: #d#h#m#s

Clear statistics within a specified duration time.

count count-number 

Clear a specific number of statistics.

mac mac-address

Clear statistics for a MAC address.

vnet vnet-name 

Clears statistics for a specific VNET.

vlan vlan_id

Clear the VLAN identifier.

ip ip-address

Clear the IP address of the connection.

port port-number

Clear the port number of the connection.

iconns iconns-number

Clear the number of incoming connections.

oconns oconns-number

Clear the number outgoing connections.

obytes

Clear the number of bytes sent from the client side of the connection.

ibytes

Clear the number of bytes received by the client side of the connection.

total-bytes total-bytes-number

Clear the total number of bytes.

first-seen date/time: yyyy-mm-ddThh:mm:ss

Clear statistics from the time a connection is first seen.

last-seen date/time: yyyy-mm-ddThh:mm:ss

Clear statistics from the time a connection was last seen.

Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

Version 1.2.2

Command changed to connection-stats-show.

Version 2.2

The parameter, no-since-start, deprecated.

Version 2.4.1

The parameters, vnet and total-bytes, added.

Usage   Used to clear statistics for a connection to a host.

Examples  To clear the statistics from port 23, use the following command:

CLI network-admin@switch > connection-stats-clear port 23

connection-stats-show

This command displays statistics collected when connected to host.

Syntax   connection-stats-show

time date/time: yyyy-mm-ddThh:mm:ss

Specify a time to display connection statistics.

start-time date/time:
yyyy-mm-ddThh:mm:ss

Specifies statistics from a specific start time and date.

end-time date/time:
yyyy-mm-ddThh:mm:ss

Specifies statistic from a specific end time and date.

duration: #d#h#m#s

Specifies statistics for a specific duration.

interval duration: #d#h#m#s

Specifies statistics for a specific interval duration.

since-start|
no-since-start

Specifies statistics from the start of collection.

older-than duration: #d#h#m#s

Specifies statistics older than a specified date and time.

within-last duration: #d#h#m#s

Specifies statistics within a specified duration time.

count count-number 

Clear a specific number of statistics.

mac mac-address

Clear statistics for a MAC address.

vnet vnet-name 

Clears statistics for a specific VNET.

vlan vlan_id

Specifies the VLAN identifier.

ip ip-address

Specifies the IP address of the connection.

port port-number

Specifies the port number of the connection.

iconns iconns-number

Specifies the number of incoming connections.

oconns oconns-number

Specifies the number outgoing connections.

obytes

Specifies the number of bytes sent from the client side of the connection.

ibytes

Specifies the number of bytes received by the client side of the connection.

total-bytes

total-bytes-number

Specifies the total number of bytes for the connection.

first-seen date/time: yyyy-mm-ddThh:mm:ss

Clear statistics from the time a connection is first seen.

last-seen date/time: yyyy-mm-ddThh:mm:ss

Clear statistics from the time a connection was last seen.

Access   CLI

History   

Version 1.2

Command introduced.

Version 1.2.2

Command changed to connection-stats-show.

Version 2.2

The parameter, total-bytes, added.

Version 2.4

The parameter, age, deprecated.

Version 2.4.1

The parameter, vnet, added.

Usage   Used to clear statistics about a connection to a host.

Examples  To display the statistics from port 23, use the following command:

CLI network-admin@switch > connection-stats-show format all layout vertical

switch:        pubdev02

mac:           64:0e:94:28:03:56

vnet:          vnet-global

vlan:          1

ip:            192.168.42.30

port:          41

iconns:        184

oconns:        0

ibytes:        0

obytes:        0

total-bytes:   0

first-seen:    01-14,10:33:44

last-seen:     01-14,10:35:22

last-seen-ago: 5d23h29m53s

switch:        pubdev02

mac:           64:0e:94:28:00:5e

vlan:          1

ip:            192.168.42.20

port:          47

iconns:        3

oconns:        0

ibytes:        1.47K

obytes:        14.8K

total-bytes:   16.3K

first-seen:    01-13,13:59:35

last-seen:     01-19,22:45:21

last-seen-ago: 11h19m54s

connection-stats-clear-history

This command is used to clear the history of connection statistics.

Syntax   connection-stats-clear-history

Defaults   None

Access   CLI

History   Command introduced in Version 2.2.3.

connection-stats-settings-modify

This command allows you to modify the settings for collecting statistical data about connections.

Syntax   connection-settings-modify

i

Specify one or more of the following options:

enable|disable

Enable or disable collecting connections statistics.

connection-max-memory connection-max-memory-number

Specify the maximum memory allowed for connection statistics.

connection-backup-enable|
connection-backup-disable

Enable backup for connection statistics collection.

 connection-backup-interval duration: #d#h#m#s

Specify backup interval for connection statistics collection.

client-server-stats-max-memory client-server-stats-max-memory-numbe

Specify maximum memory for client server statistics.

client-server-stats-log-enable|
client-server-stats-log-disable

Enable or disable statistics

client-server-stats-log-interval duration: #d#h#m#s

Specify the interval to collect statistics.

client-server-stats-log-disk-space disk-space-number

Specify the disk-space allocated for statistics.

connection-stats-max-memory connection-stats-max-memory-number

Specify the maximum memory allowed for connection statistics.

connection-stats-log-enable|
connection-stats-log-disable

Enable or disable statistics.

connection-stats-log-interval duration: #d#h#m#s

Specify the interval to collect statistics.

connection-stats-log-disk-space disk-space-number

Specify the disk-space allocated for statistics.

service-stat-max-memory service-stat-max-memory-number

Specify tjhe maximum memory allowed for service statistics.

fabric-connection-max-memory fabric-connection-max-memory-number   

Specify the maximum memory allowed for fabric connection statistics.

fabric-connection-backup-enable|fabric-connection-backup-disable

Enable backup for fabric connection statistics collection.

fabric-connection-backup-interval duration: #d#h#m#s

Specify the backup interval for fabric connection statistics collection.

redirect-analytics-interface none|span1|span2|span3

Specify if you want to redirect analytics flow to a rear-facing NIC.

Defaults   None

Access   Network Administrator

History   Command introduced in Version 2.6.0.

Usage   Use this command to modify connection statistics collection.

Examples  To disable statistics collection, use the following syntax:

CLI network-admin@switch > collection-stats-settings-modify disable

connection-stats-settings-show

This command allows you to display the settings for collecting statistical data about connections.

Syntax   connection-stats-settings-show

Defaults None

Access   Network Administrator

History   Command introduced in Version 2.6.0.

Usage   Use this command to display connection statistics settings.

Examples  To display connection statistics settings, use the following syntax:

CLI network-admin@switch > connection-stats-settings-show