View Route Topology Details

The map on the Route Topology page (Observability > Routing > Route Topology) displays the routing topology. The map is interactive, which means that you can use the features within the map to customize the map as well as the routing information table that is displayed at the bottom of the page.

The map uses a geographic coordinate reference system that enables the following features:

Constrained zooming—Routing Director checks the coordinates so that the view is constrained to the coordinates of the earth.
Repositioning devices according to their geographical coordinates—By default, each device is positioned in the map according to the geographical coordinates (latitude and longitude) of the site to which the device belongs. If a device is not associated with a site, the device is positioned randomly. You can reposition the devices in the map according to their geographical coordinates if you want to mimic your actual topology in the map.

Route Topology Map

The route topology map displays the route topology. You can right-click a device, link, or blank space in the topology map to access multiple menus. The options in each of these menus are described in Table 1.

Table 1: Options Displayed on the Topology Map
`Option`	`Description`
Filter in Device Table	You can select a device and filter details of the device in the topology information table. Right click a device on the map (device is highlighted with a yellow circle) and select Filter in Device Table. The IGP Nodes Table in the IGP Nodes tab is filtered to display details of only the node that you selected on the map.
Filter in Link Table	Right click a link on the map and select Filter in Link Table. The Adjacencies Table in the Adjacencies tab is filtered to display details of only the adjacency that you selected on the map.
Manage Map View	Create and manage multiple layouts of the route topology. You can also load, save, edit, import, and export the saved map layouts. Only users with the Super User and Network Admin roles can perform these tasks on the Manage Map View page: More > Import—Import information (about the host name, latitude, longitude, router id, and site information) for all devices in a layout from a comma-separated values (CSV) file or GeoJSON file. To import the file from your local file system, click Import and navigate to the folder that contains the CSV or GeoJSON file. Then, click Open to upload the CSV or GeoJSON file. More > Export-Selected—Export information (about the host name, latitude, longitude, router id, and site information) for all devices that you selected in a layout as a CSV file or GeoJSON file. More > Export-All Map Views—Export information (about the host name, latitude, longitude, router id, and site information) for all devices in a layout as a CSV file or GeoJSON file. For more information about GeoJSON files, see GeoJSON.org.
Toggle Background Map	By default the route topology map view loads the world map. Right click and select Toggle Background Map to turn off the world map background. If you repeat the action, Routing Director reloads the map again.
Save to Default Map Layout	Saves the current map layout as the default map layout. For example, if you turn off the world map background and select Save to Default Map Layout, Routing Director saves this setting. Next time when you revisit the Route Topology page, the route topology map will not load the world map.
Label Size	Select a Label Size: Select one of the following values as the font size for the node labels: 10 12 14 16 18 20
Device Label	Select one of the following options to label the nodes in the route topology map: Hostname Hostname, SID IP Address IP, SID OS Version SID Hide Label—Hides all the labels for the nodes in the topology map
Link Label	Select one of the following options to label the links in the route topology map: Hostname A::Z Interface A::Z IP A::Z IP SID A::Z Interface Util A::Z RSVP Bandwidth A::Z RSVP Util A::Z RSVP Live Util A::Z Measured Delay A::Z SID A::Z TE Admin Group A::Z Link Health—Displays the health status of each link (Healthy or Unhealthy) Hide Label—Hides all the labels for the links in the route topology map

Route Topology Menu Bar

The route topology menu bar is the vertical bar at the top-right corner of the Route Topology page, which consists of the following:

Reset icon—Center the route topology map so that it zooms to fit the screen.
Plus icon—Zoom in (enlarge) the route topology map.
Minus icon—Zoom out (reduce) the topology map.
Switch to Cluster View/Node View icon—Switch to Node View from the default Cluster View.

In Node View, all nodes and links are displayed as is. In cases where nodes and links are in proximity in the map, they might overlap with each other and clutter the map. In Cluster View, you can collapse nodes and links in the topology map into clusters and bundles, respectively, to reduce clutter.
Settings icon—Configure display properties of the topology map, and specify the neighbor (peer) IP address and autonomous system (AS) number for viewing the live changes in your network.

Cluster View
Topology Settings Options

Cluster View

By default, the GUI displays the route topology map in Cluster View. The nodes and links are displayed as clusters and bundles, respectively. Isolated nodes and links remain as is. The clusters and bundles reduce visual clutter in the route topology map and aggregate data, enabling you to view the network better, especially in case of large-scale networks with many nodes and links.

To switch to the Node View, select the Switch to Node View option in the route topology menu bar. In this view, all nodes and links are displayed as is. In cases where nodes and links are in proximity in the map, they might overlap with each other and clutter the map. To reduce clutter, switch back to the Cluster View. To return to the default view, select the Switch to Cluster View option in the route topology menu bar.

Cluster View has the following features:

Each cluster is represented by a circle. The number in each circle indicates the number of nodes in the cluster. Similarly, each bundle is represented by a thick line. The number on the line indicates the number of links in the bundle.
When you double-click a cluster, the topology map zooms in to expand the cluster into its child devices. When you double-click a bundle, the bundle expands to display individual links. To collapse the links back into a bundle, double-click the underlay hull.

A hull is a visual representation that is drawn behind a bundle to allow the user to expand or collapse curved lines (that is, the links in the route topology map).
You can drag clusters to reposition them in the route topology map. As a result, the nodes in the cluster and the links connecting these nodes are also repositioned.
If two or more nodes in a cluster are directly connected through a common link, the circle representing the cluster displays a colored outline.

To identify interconnected nodes in a cluster, double-click the cluster and zoom in to the next level.

Color classification in IGP heat map

The topology map uses color coding to represent the severity of alerts for each node (device) and link. This color classification helps to quickly identify the health status of the network. Clusters are displayed as circles with surrounding rings, where circles represent aggregated node data and rings represent aggregated link data. The color of each circle and ring reflects the highest severity alert raised within the cluster or bundle.

Node and Cluster Circle Colors—Each node or cluster circle is colored based on the severity of associated alerts. If there are one or more alerts, the highest severity determines the base color. When multiple nodes are grouped into a cluster, the severities are aggregated, and the most severe alert determines the color of the circle. The alerts can be of the following severities:
- Critical—Indicated in red
- Major—Indicated in orange
- Minor—Indicated in yellow
- Info—Indicated in white
How is color intensity determined?

Color intensity (brightness or saturation) of a node or cluster is influenced by both the number of alerts and the duration for which those alerts have been active. The base color of each node is determined by its highest severity alert, following this priority levels: Critical > Major > Minor > Info/Null.

When nodes are clustered, the overall severity of the cluster is calculated using the following formula and this ratio determines how severe the cluster is:

Severity Ratio = Number of nodes with the highest severity ÷ Total number of nodes in the cluster.
- A higher severity ratio results in a darker or more intense color.
- A lower severity ratio results in a lighter or less intense color.
For example, in a cluster of three nodes where only one has a critical alert and the others have Info alerts, the severity ratio is 1/3, and the cluster will appear as a light red circle. This visual gradient helps users quickly assess the severity of alerts across clusters.
Link and Bundle Ring Colors—The ring around each cluster circle indicates the health of all links connected to that cluster. A ring can be segmented into colored arcs, with each arc representing a severity level. The size of each arc is proportional to the number of alerts at that severity.

For example, a cluster has 10 link-related alerts. If six of the alerts are Critical, 60% of the ring is displayed in red. If two alerts are Major, then 20% of the ring appears orange, and if two alerts are Minor, the remaining 20% of the ring appears yellow. The color coding allows you to quickly understand the proportion of different severity levels and health of the links.

When bundles are expanded or you are in Node View, individual links are displayed with a single severity color, determined by the most severe alert associated with that link.

Topology Settings Options

Table 2 describes the tabs on the Topology Settings pane.

Table 2: Route Topology Settings Options
Tab	Description
Nodes	You can perform the following tasks: Click the Label drop down to choose the label that you want to be displayed on the route topology map. The following options are available: None—No labels are displayed on the route topology map. Hostname—The hostname of the node is displayed on the route topology map IP Address—The IP address of the node is displayed on the route topology map OS Version—The OS version of the node is displayed on the route topology map After you select a label, you can enable the following toggle buttons: Background Shadow—To view the background shadow of node labels. Hide Pseudo Node Label—To hide the pseudo node label Show only Favorite Labels—To view only favorite node labels Hide Isolated Nodes—To hide isolated nodes Hide Pseudo Nodes—To hide pseudo nodes Show Site in a Circle—To display site in a circle
Links	You can perform the following tasks: Click the Label drop down to choose the label that you want to be displayed on the route topology map. The following options are available: Hostname A::Z Interface A::Z IP A::Z IP, SID A::Z Interface Util A::Z RSVP Bandwidth A::Z RSVP Util A::Z RSVP Live Util A::Z Measured Delay A::Z SID A::Z TE Admin Group A::Z You can select the network element that you want to be displayed in the color legend (bottom right corner of the Route Topology map). You can select one of the following network elements: RSVP Utilization RSVP Live Utilization Interface Utilization Measured Interface Delay Click the toggle button to: Show or hide the link down markers Draw down links as a dashed line Draw a link line width in proportion to the interface speed Draw parallel links as a curve: Toggle the button to draw parallel links between two nodes as a curve, so that the parallel links do not overlap and appear separately (as curves) on the topology map. If the parallel links between two nodes are drawn as straight lines, they would overlap on the route topology map (as a bundle). Wrap links as great arcs: Distinguishes links that would have to wrap around the world map. Hide Partially Visible links: Hides any link whose end nodes are outside the visible area. This is useful for focusing on a subset of a large network.
General	You can perform the following tasks: Click the Enable Animation while calculating Topology Layout toggle button to enable animation while calculating the route topology layout. Select a Label Size: Select one of the following values as the font size for the node and link labels: 10 12 14 16 18 20 Apply Opacity effects. Move the Opacity Effects slider to select the percent opacity for topology map elements that are not highlighted. Select the color for nodes and links.
Dynamic Topology	Routing Director establishes a BGP-LS peering session with the devices in your network and enables you to view live changes in the network even if the devices are not managed by Routing Director. To view live updates in topology, you must enable BGP-LS peering and then establish PCEP sessions. To enable BGP-LS peering: Specify the IP address of the BGP-LS peer and autonomous system (AS) number on the Topology Settings page (Observability > Routing > Route Topology > Topology Menu Bar > Settings icon > Dynamic Topology). Manually refresh the Topology page or right-click a blank space on the topology map and select Reload Network. To establish PCEP sessions: Specify a VIP address either at the time of installing Routing Director or post-installation of the cluster. For more information, see Configure a PCE Server. Configure PCEP on each PE router. For more information, see Configuring PCEP on a PE Router. You can view live IGP Link State Database (LSDB) updates in the topology. A cluster view with color coded link bundles and circles indicating detected anomalies, is also displayed. If BGP-LS peering is not enabled, IGP LSDB data is displayed. If BGP-LS peering is enabled, BGP-LS and IGP LSDP data is reconciled and displayed. In addition, on the topology map, you can view the latest operational status of devices and links (adjacencies).

ON THIS PAGE