Network Map

NVIDIA MELLANOX NEO DOCUMENTATION

The Network Map screen shows the fabric, its topology, elements and properties. NEO performs automatic fabric discovery and displays the fabric elements and the connectivity between the elements. In the Network Map screen, you can see how the fabric and its elements are organized (e.g., switches and servers). In addition, it helps to utilize resources and traffic by performing telemetry and monitoring actions on the fabric in a colorful, user-friendly interface.

Warning

The network map and its inner components are automatically refreshed every 30 seconds.

image2019-3-25_15-42-16.png


The zoom slider enables zooming in and out on the map, while the compass icon serves as a reset button.

"Search By Property" allows users to search for keywords using free text.

Component

Description

Mellanox Onyx Switches*

image2019-3-25_15-55-42.png

Represents Mellanox-OS switches discovered/ managed by Mellanox NEO.

Non-Mellanox OS Switches*

image2019-3-25_15-55-52.png

Represents third party switches discovered/ managed by Mellanox NEO.

Servers

image2019-3-25_15-56-6.png

Represents the computer (host) connected to the discovered/managed switches.

Links

image2019-3-25_15-56-16.png

In the Network Map view, you may also see the connections (represented by a line) between each of the devices and between switches and servers.

Network icon

image2019-3-25_15-56-24.png

Represents a group of unknown discovered devices.

Unknown connection

image2019-3-25_15-56-53.png

Represents an unknown physical connection (while one of the peers is unknown).

Warning

The color of the device varies according to its severity level. For further information, refer to Devices' Severity Levels.

The Network Map window includes physical hierarchies of the fabric. Hovering over one element in the map will highlight its connections and blur the other elements.

The View tab in the right pane enables filtering for certain elements to be viewed in the Network Map (see below).

Warning

The views created are saved per user, thus cannot be accessed using a different username.

image2019-3-25_16-0-3.png

In the example above, only Mellanox Switches that have three levels of severity will be viewed in the map; those in Warning level, Error level, and Critical level. This customized filter can be saved by clicking the "Save As" button above (

image2019-3-25_16-1-11.png

).

image2019-3-25_16-1-41.png

After clicking “Save”, the view will be saved and can be accessed from the drop down menu next to “Views:”. It can be deleted by clicking the “x” icon.

image2019-3-25_16-3-38.png

Note that the view can be edited by selecting it, modifying the filters, and saving it using the Save button (

image2019-3-25_16-1-11.png

). The refresh button (

image2019-3-25_16-4-45.png

) is used for reset. Network map layouts can be exported and saved to text files by clicking on the Export icon (

image2019-3-25_16-5-35.png

). In addition, they can be imported from text files by clicking on the Import icon (

image2019-3-25_16-6-24.png

). This allows the sharing of a layouts between different users.

You can also filter for the devices allocated to one or more VLANs by selecting the VLAN number/numbers in the right pane (see below).

image2019-3-25_16-6-57.png

Note that when filtering for the members that belong to a certain VLAN number, the option to hover over any device in the map will be disabled.

Properties Tab

  • The Properties tab in the same pane provides the following:

    • When selecting an element in the network map, its name, vendor, profile, status, IP, system type, and health information will be displayed.

    • When selecting a link connecting between two devices, various types of information will be displayed in the following order:

    1. A list of all ports' links.

      image2019-3-25_16-12-18.png

    2. Port cable information is available when at least one of the devices connected in the link is a Mellanox switch of communication status “OK”. Cable info can be exposed by clicking “+”. When this information is called for the first time, it will take a few minutes for the server to request and upload it.

      image2019-3-25_16-14-2.png

Device Info

When selecting a system in the network map, its name, vendor, profile, status, IP, system type, and health information will be displayed in a table under the properties tab.

image2019-3-25_16-14-40.png


Links Info

When selecting a link on the map connecting two devices, the following information will be displayed:

  1. A list of links between the two devices, recognized by the corresponding ports of each device.

  2. A table of basic port information.

Cable Info

The cable info can be viewed by clicking the [+] icon. It may be available when at least one of the devices of the link edges is a Mellanox switch of communication status "OK".

image2019-3-25_16-17-11.png

View Tab

The View tab in the right pane enables filtering for certain elements to be viewed in the Network Map, and allows performing monitoring and telemetry actions for network analysis (see below).

image2019-4-30_17-18-8.png


Type and Severity Filters

In the example above, there are three available system types; Mellanox Switch, Linux Host and Cumulus Linux, listed under the Type section. It is possible to filter the displayed systems in the map by toggling the buttons next to each system type. It is also possible to filter according to the severity of the system status - Info, Warning, Error, Critical or Unknown.

Network Analysis

The Network Analysis pane provides several network monitoring and analysis options. One option may be enabled at a given time.

  1. Link Analysis: Performs monitoring on the links based on specific counters and conditions.

  2. RoCE Congestion: Performs monitoring on the links based on the ECN Normalized Packets counter.

  3. Network Path: Finds a path composed of links between a switch & an In-Band IP and performs monitoring on these links based on Out Bandwidth Rate counter.

  4. Buffers Utilization: Indicates the status of the buffers utilization for the switches, if a threshold event occurs. In addition, provides an option to view the switch buffers histograms in a bar chart.

    Warning

    To enable histograms, run the following template: NEO GUI → Managed Elements → SwitchXXX → Provisioning → template → enable histogram

  5. Link Monitoring: Retrieves telemetry data on switches and ports and presents it in line or bar charts.

    image2019-4-30_17-21-30.png

Link Analysis

Link analysis allows you to display the link analytics according to a selected static counter, and define the conditions on which the analysis is based. The links will be colored according to the specified conditions. You may define up to five conditions.

image2019-3-25_16-21-23.png

To define a condition, select the desired counter, and click on the [+] button.

image2019-3-25_16-21-40.png

A form will pop up. Choose the appropriate operator, and define the desired threshold and color. This color will be applied on the link, if the link monitoring value matches the respective condition.

image2019-3-25_16-22-21.png

The added conditions are listed in the Network Analysis section, if Link Analysis is enabled. The links are colored and labeled accordingly.

image2019-3-25_16-23-19.png

Warning

Instead of aggregating all values, the displayed value represents the worst-case scenario:

  • If: (Condition) > X, the highest value will be shown

  • If: (Condition) < X, the lowest value will be shown

Warning

The data samples are retrieved using the Telemetry Agent, if it is installed on the switch. Otherwise, NEO uses the SNMP requests to retrieve the data. Sampling using the Telemetry Agent is done in higher resolution.


RoCE Congestion

The RoCE Congestion sub-pane provides monitoring based on ECN Normalized packets, given that there are 4 predefined conditions.

image2019-3-25_16-25-25.png

Network Path

The Network Path sub-pane allows you to display the paths between a selected source switch and a specific target host (In-Band IP). The display includes the Out-Bandwidth Rate values on top of these paths.

image2019-3-25_16-26-4.png

Warning

The Network Path capability is supported by both Onyx and Cumulus operating systems. For the OS versions, please refer to the latest Release Notes document.

Warning

The displayed out bandwidth rate value is the highest value of the interfaces. Thus, if two switch systems are connected by several links, only the highest value will be displayed. You may click on the link on the map for a table with all the values.

To do so, select the source switch from the drop-down menu, type the In-Band IP in the IP Field, and click the Trace button. The optional detected paths (can be more than one path) will be colored, and the Out-Bandwidth Rate value will be displayed on the map.

image2019-3-25_16-28-56.png

Warning

When entering a Loopback interface as the destination in NEO, one path is displayed.


Buffers Utilization

The Buffers Utilization feature samples and summarizes the capacity of admitted packets stored and queued in the buffer. This sub-pane allows a view on the switches' buffers utilization status, and provides an option to view the buffers histograms for each switch in a bar chart per interface.

The buffer icon beside each switch indicates the Buffer Utilization status. Each color corresponds to a specific status:

  1. Grey: Unknown

  2. Green: OK

  3. Orange: Degraded

  4. Red: Major or Critical

image2019-3-25_16-30-7.png

To view the histograms data for a switch if a threshold event occurs, select a switch in the map, and the interface for which you wish to see the histograms. The histograms are viewed in a bar chart. The X-axis represents the bin number, and the Y-axis represents the buffer size distribution.

image2019-3-25_16-31-18.png

For a live view of the current buffer utilization histogram, right-click on a device, and select “Live Buffers Utilization”:

image2019-3-25_16-31-33.png

image2019-3-25_16-31-46.png

In order to configure Live Buffer Utilization follow this procedure:

  1. Right-click the desired switch under Managed Elements → Devices and install/run telemetry on it.

  2. Right-click the switch under Devices and click on Provisioning and choose the“Enable Histogram” template.

    Warning

    By default, the priority configured with NEO is 3 (i.e. TC=3 on the switch side). The priority can be changed under controller.cfg if desired.

    Enable_histograms.PNG

  3. Fill out the following global variables for this template.

    Enable_histograms_global_variables.PNG

  4. Click on Live Buffer Utilization to show histogram samples based on switch histogram configuration.

    Live_buffer_utilization_configured.png

Link Monitoring

Link Monitoring displays telemetry data in the form of line charts and bar charts. There are 3 cases of monitoring:

  1. No selection: All the switches that support monitoring are monitored.

  2. A switch is selected: The ports of the selected switch are monitored.

  3. A link is selected: The ports of the two devices making that link are monitored.

Monitoring All Switches

If nothing is selected, we perform telemetry of all the supported switches.

image2019-4-30_17-27-18.png


Switch Monitoring

When a switch is selected, all its running ports are monitored.

image2019-4-30_17-28-10.png

If you select the Last 5 Minutes mode, telemetry is streamed from the Telemetry Agent, and more counters are available.

image2019-4-30_17-29-8.png


Link Monitoring

If a link selected, the ports of the two devices taking part in this link are monitored.

image2019-4-30_17-31-39.png

To run operations on more than one element in the map, hold the ctrl key down and select the elements, right-click on one of them and choose the action.

image2019-3-25_16-32-57.png

The level of severity of the devices’ health state varies from OK to Critical, and is indicated by the device’s icon color.

Devices' Severity Levels

Icon

Heath State

image2019-3-25_16-34-56.png

Info/OK

image2019-3-25_16-35-8.png

Error/Major

image2019-3-25_16-35-17.png

Warning/Unknown/Degraded

image2019-3-25_16-35-24.png

Critical

A view is a combination of a topology of nodes with (x, y) positions, filters state and Network Analysis state. By default, NEO offers a view (called "All Elements") which provides a multi-layer topology, based on either Spine-Leaf topology or user-defined tiers.

It is possible to save custom views with their own topology. The following parameters can be customized, saved in a view, and accessed later, on another machine or browser:

  1. Systems positions in the map

  2. VLANs filter selection

  3. Type filters state

  4. Severity filters state

  5. Network Analysis state

Saving Customized Views

To save a customized view, click the "Save As" button above (

image2019-3-25_16-1-11.png

).

image2019-3-25_16-41-31.png

After clicking “Save”, the view will be saved and can be accessed from the drop-down menu next to "Views". It can be deleted by clicking the “x” icon.

image2019-3-25_16-41-55.png

Note that the view can be edited by selecting it, modifying the filters, and saving it using the “Save” button (

image2019-3-25_16-1-11.png

). The refresh button (

image2019-3-25_16-4-45.png

) is used for reset.

Network map layouts can be exported and saved to text files by clicking on the Export icon (

image2019-3-25_16-5-35.png

). In addition, they can be exported from text files by clicking on the Import icon (

image2019-3-25_16-6-24.png

). This allows the sharing of a layouts between different users.

All Elements View

In the All Elements View display type, the devices are shown in layers (tiers), for better understanding of the network. To select the All Elements view, click on the “Views” drop-down menu, and select “All Elements”.

Default All Elements View

This view follows the concept of Spine-Leaf topology, where the hosts are in the bottom line of a topology, the leaves are switches directly connected to those hosts, and the spines are switches connected to the leaves.

image2019-3-25_16-45-22.png


Sites View

Sites, once configured under Managed Elements, can be viewed from the Network Map screen.

The color for each site indicates the worst status for a device in that site.

Sites_Network_Map_View.png

At the top of the Network Map panel, there are several View options:

  • You can choose to display a device by its name or its IP address and search for it accordingly.

    image2019-3-25_16-46-48.png

    The device will be highlighted in the network map.

  • MLAG visualization drop down menu: will only appear if there is one/more instances of MLAG service in NEO. MLAG members of the instance selected will be highlighted in the Network Map.

    image2019-3-25_16-47-42.png

  • Any change in the devices view using the filtering options can be saved using the “Save As” icon.

    image2019-3-25_16-48-9.png

These new views can be saved and later accessed from the Views drop down menu.

© Copyright 2023, NVIDIA. Last updated on Nov 14, 2023.