If you are using the current version of Cumulus NetQ, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Validate Overall Network Health

The Validation Summary card in the NetQ UI lets you view the overall health of your network at a glance, giving you a high-level understanding of how well your network is operating. Successful validation results determine overall network health shown in this card.

View Network Health Summary

You can view a very simple summary of your network health including the distribution of validation check results across your network.

To view this summary:

  1. Open or locate the Validation Summary card on your workbench.

  2. Change to the small card using the card size picker.

    validation summary card displaying 11 of 11 system checks are successful

    In this example, all validation checks are successful.

View Key Metrics of Network Health

Overall network health in the NetQ UI is a calculated average of several key health metrics: interface, system, and network services health.

To view these key metrics:

  1. Open or locate the Validation Summary card on your workbench.

  2. Change to the medium card if needed.

    Each metric is shown with a distribution of the validation results for each category. Hover over the individual categories to view detailed metrics for specific validation checks.

    In this example, the health of each of the interface and system health are good, but network service health shows some validation failures.

View Network Health

Network health is divided into three categories:

  • System health
  • Network service health
  • Interface health

System health represents the NetQ Agent and sensor health validations. In all cases, validation is performed on the agents. If you are monitoring platform sensors, the validation checks include these as well.

Network services health represents the individual network protocol and services validations. In all cases, validation is performed on NTP. If you are running BGP, EVPN, MLAG, OSPF, or VXLAN protocols the validation checks include these as well.

Interface health represents the interfaces, VLAN, and link MTU validations.

To view details about your network’s health:

  1. Open or locate the Validation Summary card on your workbench.

  2. Change to the large card using the card size picker.

  1. By default, the System health tab is displayed.

The health of agents and sensors is represented on the left side of the card. Hover over the chart for each type of validation to see detailed results. The right side of the card provides a listing of devices with failures related to agents and sensors.

  1. Click the Network service health tab.

The health of each network protocol or service is represented on the left side of the card. Hover over the chart for each type of validation to see detailed results. The right side of the card provides a listing of devices with failures related to these protocols and services.

  1. Click the Interface health tab.

The health of interfaces, VLANs, and link MTUs is represented on the left side of the card. Hover over the chart for each type of validation to see detailed results. The right side of the card provides a listing of devices with failures related to interfaces, VLANs, and link MTUs.

View Devices with the Most Issues

It is useful to know which devices are experiencing the most issues with their system services, network services, or interfaces in general, as this can help focus troubleshooting efforts toward selected devices versus the service itself.

To view devices with the most issues, select Most failures from the filter above the table on the right.

Devices with the most issues are listed at the top. To further investigate critical devices, click on the hostname to open the device card, or use the Events card and filter on the indicated switches.

View Devices with Recent Issues

To view devices with recent issues, select Recent failures from the filter above the table on the right. The devices with the most-recent failures are listed at the top. To further investigate critical devices, click on the hostname to open the device card, or use the Events card and filter on the indicated switches.

Filter Results by Service

You can focus the data in the table on the right by unselecting one or more services. Select the checkbox next to the service you want to remove from the data. In this example, we have unchecked MTU.

Unselecting the service temporarily removes the data related to that service from the table.

View Details of a Particular Service

From the relevant tab (System Health, Network Service Health, or Interface Health) on the large Validation Summary card, you can select a chart to open a full-screen view of the validation data for that service.

The following example shows the EVPN chart:

EVPN validation data

View All Network Protocol and Service Validation Results

The Validation Summary card workflow lets you view all of the results of all validations run on the network protocols and services during a designated time period.

To view all the validation results:

  1. Open or locate the Validation Summary card on your workbench.

  2. Change to the large card using the card size picker.

  3. Click <network protocol or service name> tab in the navigation panel.

  4. Look for patterns in the data. For example, when did nodes, sessions, links, ports, or devices start failing validation? Was it at a specific time? Was it when you starting running the service on more nodes? Did sessions fail, but nodes were fine?

Where to go next depends on what data you see, but a few options include:

  • Look for matching event information for the failure points in a given protocol or service.
  • When you find failures in one protocol, compare with higher level protocols to see if they fail at a similar time (or vice versa with supporting services).
  • Export the data for use in another analytics tool, by clicking download and providing a name for the data file.