Connectivity Monitor

Connectivity Monitor provides unidirectional monitoring of network resources from an Arista switch. The monitored resources may or may not be Arista devices. In this section, all Connectivity Monitor commands have documentation for configuring the feature from the CLI. To configure the feature using a GUI, see the CloudVision Help Center Connectivity Monitor documentation.

Connectivity Monitor Command Reference

Connectivity Monitor Command Reference

 

Global Configuration commands

Client Configuration commands

Host Configuration commands

VRF Configuration commands

Show commands

client host

The monitor connectivity client host command configures clients to accept connectivity probes from a host.

 

Command Mode

Monitor Connectivity Client Configuration Mode

Monitor Connectivity VRF Configuration Mode

 

Command Syntax

monitor connectivity [clientclient_name | vrf vrf_name] host host_name

 

Parameters

host host_name - Specify a host to send connectivity probes to the client.

 

Example

Use the following commands to configure a host, cloudserver, to send connectivity probes to a client, MyClient:

switch(config)# monitor connectivity
switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-MyClient)# host cloudserver

Use the following commands to configure a VRF, purple, to send connectivity probes to a VRF, MyVRF:

switch(config)# monitor connectivity
switch(config-mon-connectivity)# vrf purple
switch(config-mc-vrf-purple)# host cloudserver

 

client interval

The client interval command configures the interval between probes on a client. By default, eos sets the interval to 10 seconds.

Command Mode

Connectivity Monitor Client Configuration Mode

 

Command Syntax

client interval interval

 

Parameters

interval interval - Configure the interval between probes as a value between 1 and 65535 seconds. eos has a default value of 10 seconds.

 

Example

Use the following command to set the interval between probes to 60 seconds on MyClient:

switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-myClient)# interval 60

client loss-threshold

The client loss-threshold command configures the sequential lost probe count threshold on a client.

Command Mode

Connectivity Monitor Client Configuration Mode

 

Command Syntax

client loss-threshold count probes

 

Parameters

loss-threshold count - Configure the sequential lost probe threshold as a value between 1 and 65535 probes. eos has a default value of 10 seconds and uses probes as a unit.

 

Example

Use the following command to set the sequential lost probe threshold to 60 seconds on MyClient:

switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-myClient)# loss-threshold 60 probes

host description

The host description command configures a brief description of the host.

Command Mode

Connectivity Monitor Host Configuration Mode

Connectivity Monitor VRF Configuration Mode

 

Command Syntax

host description description

vrf description description

 

Parameters

description description - Configure a description for the host or VRF.

 

Example

Use the following command to configure a description Remote-Host Rack 12 myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# description Remote-Host Rack 12

Use the following command to configure a description VRF-remote 12 myVRF:

switch(config-mon-connectivity)# vrf MyVRF
switch(config-mc-vrf-MyVRF)# description VRF-remote

host ip

The host ip command configures the endpoint for ICMP probing on the host.

Command Mode

Connectivity Monitor Host Configuration Mode

 

Command Syntax

host ip [ipv4_address | ipv6_address] [ hostname host_name resolution [ipv4 | ipv6]]

 

Parameters

  • ip - Specify the IP address for the endpoint as IPv4 or IPv6.
    • ipv4_address - Specify the IPv4 address in dotted decimal notation.
    • ipv6_address - Specify the IPv6 address in colon separated notation.
  • hostname host_name - Specify the host name to resolve to the endpoint.
    • resolution - Specify the preferred IP address family as IPv4 or IPv6
      • ipv4
      • ipv6

 

Example

Use the following command to configure the endpoint as an IPv4 address, 172.16.21.25, on the host, myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# ip 172.16.21.25

host tcp

The host tcp command configures a TCP probe for Connectivity Monitoring. When enabled, Connectivity Monitoring measures the total round trip time of a TCP 3-way handshake. The no version of this command disables the configuration and removes it from the running-config.

 

Command Mode

Connectivity Monitor Host Configuration Mode

 

Command Syntax

host ip [ipv4_address | ipv6_address] tcp port port_number resolution [ipv4 | ipv6]]

 

Parameters

  • ip - Specify the IP address for the endpoint as IPv4 or IPv6.
    • ipv4_address - Specify the IPv4 address in dotted decimal notation.
    • ipv6_address - Specify the IPv6 address in colon separated notation.
  • hostname host_name - Specify the host name to resolve to the endpoint.
    • resolution - Specify the preferred IP address family as IPv4 or IPv6
      • ipv4
      • ipv6
  • tcp port port_number - Specify TCP and a port number between 0 and 65535

 

Example

Use the following command to configure the IPv4 address, 172.16.21.25 with TCP and port 80: myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# ip 172.16.21.25
switch(config-mc-host-myHost)# tcp port 80

host url

The host url command configures a URL for the host.

Command Mode

Connectivity Monitor Host Configuration Mode

 

Command Syntax

host url url

 

Parameters

url url - Configure a URL for the host.

 

Example

Use the following command to configure a URL, https://172.16.21.1 for the host, myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# url https://172.16.21.1

monitor connectivity

The monitor connectivity command enters the Connectivity Monitor Configuration Mode on a switch.

 

Command Mode

Global Configuration Mode

 

Command Syntax

monitor connectivity

 

Example

Use the following command to enter Connectivity Monitor Configuration Mode:

switch(config)# monitor connectivity
switch(config-mon-connectivity)#

 

monitor connectivity client

The monitor connectivity client command enters the Connectivity Monitor Client Configuration Mode on a switch.

 

Command Mode

Connectivity Monitor Configuration Mode

 

Command Syntax

monitor connectivity client client_name

 

Example

Use the following command to enter Connectivity Monitor Client Configuration Mode and add a client MyClient:

switch(config)# monitor connectivity
switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-MyClient)#

monitor connectivity description

The monitor connectivity description command configures a brief description of the host or VRF.

Command Mode

Connectivity Monitor Host Configuration Mode

Connectivity Monitor VRF Configuration Mode

 

Command Syntax

host host_name description description

vrf vrf_name description description

 

Parameters

description description - Configure a description for the host or VRF.

 

Examples

Use the following command to configure a description Remote-Host of the host, myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# description Remote-Host

 

Use the following command to configure a description Remote-VRF of the VRF purple:

switch(config-mon-connectivity)# vrf purple
switch(config-mc-vrf-purple)# description Remote-VRF

monitor connectivity icmp echo qos dscp

The monitor connectivity icmp echo qos dscp command configures DSCP bit on a host or client to classify and manage network traffic such as prioritizing packets when network congestion occurs.

Command Mode

Connectivity Monitor Configuration Mode

Connectivity Monitor Host Configuration Mode

Connectivity Monitor Client Configuration Mode

 

Command Syntax

icmp echo qos dscp dscp_value

client client_name icmp echo qos dscp dscp_value

[hosthost_name | client client_name icmp echo qos dscp dscp_value

 

Parameters

  • host host_name - Configure the host name.
  • client client_name - Configure the client name.
  • icmp echo qos dscp - Set the DSCP value in the IP header.

 

Examples

Use the following command to globally set the ICMP echo to use a DSCP value of af11:

switch(config-mon-connectivity)# icmp echo qos dscp af11

Use the following command to set the ICMP echo to use a DSCP value of af11 on myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# icmp echo qos dscp af11

Use the following command to set the ICMP echo to use a DSCP value of af11 on MyClient:

switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-MyClient)# icmp echo qos dscp af11

monitor connectivity host

The monitor connectivity host command enters the Connectivity Monitor Host Configuration Mode on a switch.

 

Command Mode

Connectivity Monitor Configuration Mode

 

Command Syntax

monitor connectivity host host_name

 

Example

Use the following command to enter Connectivity Monitor Host Configuration Mode and add a host MyHost:

switch(config)# monitor connectivity
switch(config-mon-connectivity)# host MyHost
switch(config-mc-host-MyHost)#

monitor connectivity icmp

The monitor connectivity icmp command configures ICMP ping parameters globally, on a host, or a client.

Command Mode

Connectivity Monitor Configuration Mode

Connectivity Monitor Host Configuration Mode

Connectivity Monitor Client Configuration Mode

 

Command Syntax

icmp count ping_count

client client_name ] icmp count ping_count

hosthost_name icmp count ping_count

 

Parameters

  • host host_name - Configure the host name.
  • client client_name - Configure the client name.
  • icmp count ping_count - Configure the ping count between 1 and 100. eos sets the ping count to five (5) by default.

 

Examples

Use the following command to set the ping count to 10 globally:

switch(config-mon-connectivity)# icmp count 10

Use the following command to set the ping count to 10 on MyClient:

switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-MyClient)# icmp count 10

Use the following command to set the ping count to 10 on myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# icmp count 10

 

monitor connectivity icmp count

The monitor connectivity icmp count command configures ICMP ping parameters globally, on a host, or a client.

Command Mode

Connectivity Monitor Host Configuration Mode

Connectivity Monitor Host Configuration Mode

Connectivity Monitor Client Configuration Mode

 

Command Syntax

icmp count ping_count

client client_name icmp count ping_count

hosthost_name ] icmp count ping_count

 

Parameters

  • host host_name - Configure the host name.
  • client client_name - Configure the client name.
  • icmp count ping_count - Configure the ping count between 1 and 100. eos sets the ping count to five (5) by default.

 

Examples

Use the following command to globally set the ping count to 10:

switch(config-mon-connectivity)# icmp count 10

Use the following command to set the ping count to 10 on MyClient:

switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-MyClient)# icmp count 10

Use the following command to set the ping count to 10 on myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# icmp count 10

 

monitor connectivity icmp echo

The monitor connectivity icmp echo command configures DSCP bit on a host or client to classify and manage network traffic such as prioritizing packets when network congestion occurs.

 

Command Mode

Connectivity Monitor Configuration Mode

Connectivity Monitor Host Configuration Mode

Connectivity Monitor Client Configuration Mode

 

Command Syntax

icmp echo qos dscp dscp_value

client client_name icmp echo qos dscp dscp_value

hosthost_name icmp echo qos dscp dscp_value

 

Parameters

  • host host_name - Configure the host name.
  • client client_name - Configure the client name.
  • icmp echo qos - Configure ICMP QoS parameters.
  • dscp dscp_value - Set the DSCP value in the IP header.

 

Examples

Use the following command to globally set the ICMP echo to use a DSCP value of af11:

switch(config-mon-connectivity)# icmp echo qos dscp af11t

Use the following command to set the ICMP echo to use a DSCP value of af11 on myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# icmp echo qos dscp af11

Use the following command to set the ICMP echo to use a DSCP value of af11 on MyClient:

switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-MyClient)# icmp echo qos dscp af11

monitor connectivity interface

The monitor connectivity interface command configures a collection of interfaces used as a source interface for probing.

Command Mode

Connectivity Monitor Configuration Mode

Connectivity Monitor VRF Configuration Mode

 

Command Syntax

interface set set_name [Dps | Ethernet | Fabric | InternalRecirc | Loopback | Management | Port-Channel | Recirc-Channel | Tunnel | Vlan | Vxlan] interface

vrf vrf_nameinterface set set_name [Dps | Ethernet | Fabric | InternalRecirc | Loopback | Management | Port-Channel | Recirc-Channel | Tunnel | Vlan | Vxlan] interface

 

Parameters

interface set set_name - Configure an interface set using the following interfaces:
  • Dps
  • Ethernet
  • Fabric
  • InternalRecirc
  • Loopback
  • Management
  • Port-Channel
  • Recirc-Channel
  • Tunnel
  • Vlan
  • Vxlan

 

Example

Use the following command to configure an interface set, source_probe, and the interfaces, Ethernet1, Ethernet2:

switch(config-mon-connectivity)# interface set source_probe Ethernet 1, Ethernet2

Use the following command to configure an interface set, source_probe, and the interfaces, Ethernet1, Ethernet2 on VRF purple:

switch(config-mon-connectivity)# vrf purple
switch(config-mc-vrf-purple)# interface set source_probe Ethernet 1, Ethernet2

monitor connectivity interval

The monitor connectivity interval command configures the interval between probes globally or on a client.

Command Mode

Connectivity Monitor Configuration Mode

Connectivity Monitor Client Configuration Mode

 

Command Syntax

interval count

client client_name interval count

 

Parameters

interval count - Configure the probe interval as a value between 1 and 65535 probes. eos has a default value of 10 seconds.

 

Examples

Use the following command to set the probe interval to 60 seconds globally>:

switch(config-mon-connectivity)# interval 60

Use the following command to set the probe interval to 60 seconds on MyClient:

switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-myClient)# interval 60

monitor connectivity local-interfaces

The monitor connectivity local-interfaces command configures the default interface set for ICMP probing globally, on the host, or on a VRF. The default version of the command applies only to the global configuration. In the Connectivity Monitor Configuration Mode, the default parameter selects an existing interface set to use as the default interface set for probing in the ICMP mode.

Command Mode

Connectivity Monitor Configuration Mode

Connectivity Monitor Host Configuration Mode

Connectivity Monitor VRF Configuration Mode

 

Command Syntax

local-interfaces interface_sets address-only default

[host host_name local-interfaces interface_sets address-only default

vrf vrf_name local-interfaces interface_sets address-only default

 

Parameters

  • host host_name - Specify the name of the host to apply the interface sets.
  • local-interfaces interface_sets - Specify the name of the interface sets.
  • address-only - Specify using the interface sets for the source addresses only. Use this command in the Connectivity Monitor Host Configuration Mode. This sets the source IP address to the IP configured on the interface. If not configured, the probes send packets directly from the interface.
  • default - Configure the interface set as the default. Use this parameter in the Connectivity Monitor Configuration Mode only.

 

Examples

Use the following command to globally configure the interface set, MyLocalInterfaces as the default interface set:

switch(config-mon-connectivity)# local-interfaces MyLocalInterfaces default

 

Use the following command to configure the interface sets, MyLocalInterfaces on the host, myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# local-interfaces MyLocalInterfaces

 

Use the following command to configure the interface sets, MyLocalInterfaces on the VRF, purple:

switch(config-mon-connectivity)# vrf purple
switch(config-config-mc-vrf-purple)# local-interfaces MyLocalInterfaces

monitor connectivity loss-threshold

The monitor connectivity loss-threshold command configures the sequential lost probe count threshold globally or on a client.

 

Command Mode

Connectivity Monitor Configuration Mode

Connectivity Monitor Client Configuration Mode

 

Command Syntax

loss-threshold countprobes

client client_name loss-threshold count probes

 

Parameters

  • client client_name - Configure the name of the client.
  • loss-threshold count - Configure the sequential lost probe threshold as a value between 1 and 65535 probes. eos has a default value of 10 seconds.

 

Example

Use the following command to globally set the sequential lost probe threshold to 60 seconds:

switch(config-mon-connectivity)# 60 probes

Use the following command to set the sequential lost probe threshold to 60 probes on MyClient:

switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-myClient)# 60 probes

monitor connectivity name-server

The monitor connectivity name-server command configures the IP address of a DNS name server on a host or a client to resolve hostnames. The no version of the command disables the configuration.

Command Mode

Connectivity Monitor Configuration Mode

Connectivity Monitor Client Configuration Mode

Connectivity Monitor Host Configuration Mode

 

Command Syntax

name-server group group_name

clientclient_name name-server group group_name

| host host_name name-server group group_name

 

Parameters

  • client client_name - Configure the host name.
  • host host_name - Configure the client name.
  • name-server group group_name - Configure name of the DNS name server.

 

Examples

Use the following command to globally set the name server to myDNSserver:

switch(config-mon-connectivity)# name-server myDNSServer

Use the following command to set the name server to myDNSserver on MyClient:

switch(config-mon-connectivity)# client MyClient
switch(config-mc-client-MyClient)# name-server myDNSServer

Use the following command to set the name server to myDNSserver on myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# name-server myDNSServer

monitor connectivity shutdown

The monitor connectivity shutdown command shuts down connectivity monitoring on the switch.

Command Mode

Connectivity Monitor Configuration Mode

 

Command Syntax

shutdown

 

Parameters

shutdown - Shut down connectivity monitoring on the switch

 

Example

Use the following command to shutdown connectivity monitoring on the switch:

switch(config-mon-connectivity)# shutdown

monitor connectivity vrf

The monitor connectivity vrf command to configure a specific VRF to use default probing for hosts. Hosts configured globally use the default VRF.

Command Mode

Connectivity Monitor Configuration Mode

 

Command Syntax

monitor connectivity vrf vrf_name

 

Parameters

vrf vrf_name - Configure a VRF for hosts to use for probing.

 

Example

Use the following command to configure a VRF, purple, for connectivity monitoring on the switch:

switch(config-mon-connectivity)# vrf purple

no icmp echo

The no icmp echo command disables ICMP probes on the switch. Since TCP and ICMP share the same probing endpoint, it may be desirable to shut down ICMP while using TCP probes.

Command Mode

Connectivity Monitor Host Configuration Mode

 

Command Syntax

no icmp echo disabled

 

Parameters

  • host host_name - Configure the host name.
  • icmp echo disabled - Disables ICMP probing on the host.

 

Examples

Use the following command to disable ICMP probing on host myHost:

switch(config-mon-connectivity)# host myHost
switch(config-mc-host-myHost)# no icmp echo disabled

 

show monitor connectivity

The show monitor connectivity command displays information about the Connectivity Monitor status and configuration on the switch. Display statistics for all configured hosts or a specific host.

 

Command Mode

EXEC

 

Command Syntax

show monitor connectivity [host host_name]

 

Parameters

host host_name - Specify the host to display information about Connectivity Monitor.

 

Examples

Use the following command to display information about all configured hosts for Connectivity Monitor:

switch# show monitor connectivity
 VRF: default
 Host: h1
 HTTP statistics:
 http://myhomesite.com
    Local Interface    Response Time
 --------------------- -------------
 Ethernet31/1       2.444ms
 
 Host: hostdefault
 Network Statistics:
     IP Address       Local Interface       Latency       Jitter      Packet Loss
 ---------------- --------------------- ------------- -------------- -----------
 10.0.3.2          Ethernet31/1          9.711ms       18.089ms    0%
 10.0.3.2          Ethernet60/2          1.445ms       1.944ms     0%
 
 HTTP statistics:
 http://10.0.3.2
     Local Interface    Response Time
 --------------------- -------------
 Ethernet31/1       86.444ms
 Ethernet60/2       91.753ms
 
 Host: hostdefault2
 TCP Statistics:
 IP Address Local Interface Latency Probe Error
 ---------- --------------- ------- -----------
 1.0.1.2:80 none            0.25 ms n/a
 
 Host: hostlocal
 Network Statistics:
    IP Address       Local Interface       Latency       Jitter     Packet Loss
 ---------------- --------------------- ------------- ------------- -----------
 127.0.0.1        none       0.009ms       0.007ms    0%
 
 Host: hostlocal2
 Payload Size: 56 
 DSCP value: af11 (001010)
 Hostname: localhost
 Network Statistics:
  IP Address Local Interface  Latency   Jitter Packet Loss Probe Error
 ---------- --------------- -------- -------- ----------- -----------
 ::1        none            0.034 ms 0.001 ms          0% n/a
 127.0.0.1  none            0.045 ms 0.002 ms          0% n/a
 
 HTTP statistics:
 http://localhost
 Local Interface Response Time Probe Error
 --------------- ------------- -----------
 none                1.471 ms  n/a
 
 HTTP statistics:
 http://127.0.0.1
 Local Interface        Response Time
 --------------------- -------------
 none                  .234ms
 
 VRF: vrf1
 Host: hostvrf1
 Network Statistics:
    IP Address       Local Interface       Latency       Jitter     Packet Loss
 ---------------- --------------------- ------------- ------------- -----------
 10.0.7.2          Ethernet60/1          0.552ms       0.047ms    0%
 10.0.7.2          Ethernet60/4          1.022ms       0.0ms      80%
 
 HTTP statistics:
 http://10.0.7.2
    Local Interface     Response Time
 --------------------- -------------
 Ethernet60/1          91.698ms
 Ethernet60/4          86.528ms
 
 switch#show ip name-server group mygroup
 IP Address VRF     Priority
 ---------- ------- --------
 10.0.7.3   default        0

 

Use the following command to display information about the host, hostvrf1:

switch# show monitor connectivity host hostvrf1
VRF: vrf1
Host: hostvrf1
Network Statistics:
   IP Address       Local Interface       Latency       Jitter      Packet Loss
---------------- --------------------- ------------- -------------- -----------
   10.0.7.2          Ethernet60/1          1.186ms       1.505ms     0%
   10.0.7.2          Ethernet60/4          9.787ms       18.473ms    0%

HTTP statistics:
http://10.0.7.5
   Local Interface    Response Time
--------------------- -------------
   Ethernet60/1       90.122ms
   Ethernet60/4       90.704ms