Device Interfaces Test

In the Cisco SD-WAN overlay network, you can configure network interfaces within individual VPNs. For each network interface, you can configure a number of interface-specific properties, such as DHCP clients and servers, VRRP, interface MTU and speed, and PPPoE. You can configure up to 512 interfaces on each component of the Cisco SD-WAN appliance. This number includes physical interfaces, loopback interfaces, and subinterfaces.

For each such network interface configured, this test reports the following:

  • The current admin and operational state of the interface;

  • The duration for which the interface was up;

  • The bandwidth utilized by the interface and the nature of traffic handled by the interface - i.e., packets, data etc.

  • Errors experienced by the interface during transmission/reception of data/packets.

Target of the test : Cisco SD-WAN

Agent deploying the test : An external agent

Outputs of the test : One set of results for each component:network interface of the target Cisco SD-WAN appliance that is being monitored.

Configurable parameters for the test
Parameter Description

Test period

How often should the test be executed

Host

The IP address of the host for which this test is to be configured.

Port

Specify the port at which the specified Host listens to. By default, this is NULL.

Username

By default, the eG agent executes REST APIs on the target appliance to collect the required metrics. For the eG agent to execute the REST APIs, a special user with monitoring privilege is required. Specify the name of such a user in this text box.

Password

Specify the password corresponding to the user mentioned in the Username text box here.

Confirm Password

Confirm the Password by retyping it here.

REST API Port

By default, the REST API Port is set to none. This implies that by default, this test connects to the default port to execute the REST API commands and collect the required metrics. In some environments however, a different port can be used to execute the REST API commands. In such case, specify that port number against the REST API Port text box.

SSL

The eG agent collects performance metrics by executing REST APIs on the target appliance. Typically, the REST APIs can be invoked through HTTP or HTTPS mode. By default, the eG agent invokes REST APIs using the HTTPS mode. This is why, the SSL flag is set to Yes by default. If the target appliance is not SSL-enabled, then the REST APIs can be accessed through HTTP mode only. In this case, set the SSL flag to No.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Admin status

Indicates the current admin status of this network interface.

 

The table below indicates the values that this measure can report and their corresponding numeric equivalents:

Measure value Numeric Value
Up 1
Down 0

Note:

By default, this measure reports the above-mentioned Measure Values while indicating the current admin status of the network interface. However, in the graph of this measure, the admin status of the network interface will be represented using the corresponding numeric equivalents only.

Operational status

Indicates the current operational status of this network interface.

 

The table below indicates the values that this measure can report and their corresponding numeric equivalents:

Measure value Numeric Value
Up 1
Down 0

Note:

By default, this measure reports the above-mentioned Measure Values while indicating the current operational status of the network interface. However, in the graph of this measure, the operational status of the network interface will be represented using the corresponding numeric equivalents only.

Speed

Indicates the current speed of this network interface.

Mbps

 

Data received

Indicates the amount of data received by this network interface per second during the last measurement period.

Kbps

Compare the value of these measures across the network interfaces to identify the network interface that is transmitting/receiving the maximum amount of data.

Data transmitted

Indicates the amount of data transmitted through this network interface per second during the last measurement period.

Kbps

Packets received

Indicates the rate at which packets were received by this interface during the last measurement period.

Packets/sec

Compare the values of these measures across the interfaces to identify the interface that is transmitting/receiving maximum number of packets.

Packets transmitted

Indicates the rate at which packets were transmitted through this interface during the last measurement period.

Packets/sec

Error received

Indicates the number of errors encountered when data/packets were received by this interface.

Number

Ideally, the value of this measure should be zero.

Error transmitted

Indicates the number of errors encountered when data/packets were transmitted through this interface.

Number

Ideally, the value of this measure should be zero.

Uptime

Indicates the uptime of this interface.

Minutes

A high value is desired for this measure.