ON THIS PAGE
View Network Topology Details
The topology map on the Topology page (Observability > Network > Topology) displays the network topology. The map is interactive, which means that you can use the features within the map to customize the map as well as the network information table that is displayed at the bottom of this page.
The map uses a geographic coordinate reference system that enables the following features:
-
Constrained zooming—The controller 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.
Topology Map
The topology map displays the network topology. You can right-click a device, link, or blank space in the topology map to access multiple menus. The menus and the options in each of these menus are described in the following table.
|
Option |
Description |
||
|---|---|---|---|
| Filter in Device Table |
You can select a device and filter details of the device in the network information table. Right click a device on the map (device is highlighted with a Yellow circle) and select Filter in Device Table. The Device Table in the Device tab is filtered to display details of only the device that you selected on the map. |
||
| Filter in Link Table | Right click a link on the map and select Filter in Device Table. The Link Table in the Link tab is filtered to display details of only the link that you selected on the map. | ||
|
Layout Manage the physical position of devices on the topology map using layout options. You can also import and export device information in CSV and GeoJSON formats. The layout options are available in node view. |
|||
|
Import from |
Note:
Only users with the Super User and Network Admin roles can perform this task. Import information (about the hostname, latitude, longitude, router id, and site information) for all devices in a layout from a comma-separated values (CSV) file or GeoJSON file. For more information about GeoJSON files, see GeoJSON.org. To import the file from your local file system, click Import From and navigate to the folder that contains the CSV or GeoJSON file. Then, click Open to upload the CSV or GeoJSON file. After the file is imported, the devices are automatically repositioned in the topology map according to the coordinates (latitude and longitude) in the imported file. To save the configured coordinates in the server, right-click a blank space in the topology map and select Layout > Set Coordinates from Map. |
||
|
Export to |
Note:
Only users with the Super User and Network Admin roles can perform this task. Export information (about the hostname, latitude, longitude, router id, and site information) for all devices in a layout as a CSV file or GeoJSON file. Based on the option you select, the CSV or GeoJSON file is automatically downloaded to your local system. |
||
|
Set Coordinates from Map |
Note:
Only users with the Super User and Network Admin roles can perform this task. Update the device coordinates in the server according to the current location of devices in the topology map. If you want to reposition the devices according to their coordinates, manually place the devices in the topology map as required. Alternatively, import the coordinates from a CSV or GeoJSON file. Then, use this option to save the current device coordinates in the server. |
||
|
Reset by Coordinates |
Note:
Only users with the Super User and Network Admin roles can perform this task. |
||
| Toggle Background Map | By default the 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, Paragon Automation loads the map again. | ||
| Label Size |
|
||
|
Device Label |
Select one of the following options to label the devices in the topology map:
|
||
|
Link Label |
Select one of the following options to label the links in the topology map:
|
||
|
Reload Network |
Reloads the network, and updates the displayed topology map. |
||
Topology Menu Bar
The topology menu bar is the vertical bar at the top-right corner of the Topology page, which consists of the following:
-
Reset icon—Center the topology map so that it zooms to fit the screen.
-
Plus icon—Zoom in (enlarge) the topology map.
-
Minus icon—Zoom out (reduce) the topology map.
-
Switch to Cluster View/Node View icon—Switch to Cluster View from the default Node View.
In Node View, all devices and links are displayed as is. In cases where devices and links are in proximity in the map, they might overlap with each other and clutter the map. In Cluster View, you can collapse devices and links in the topology map into clusters and bundles, respectively, to reduce clutter. For more information, see Cluster View.
-
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. For more information, see View Live Topology Updates.
Cluster View
By default, the GUI displays the topology map in the Node view. In this view, all devices and links are displayed as is. In cases where devices and links are in proximity in the map, they might overlap with each other and clutter the map. To reduce clutter, select the Switch to Cluster View option in the topology menu bar. The overlapping devices and links automatically collapse into clusters and bundles, respectively. Isolated devices and links remain as is. The clusters and bundles reduce visual clutter in the topology map and aggregate data, enabling you to view the network better, especially in case of large-scale networks with many devices and links.
To return to the default view, select the Switch to Node View option in the 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 devices 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 topology map).
-
You can drag clusters to reposition them in the topology map. As a result, the devices in the cluster and the links connecting these devices are also repositioned.
-
If two or more devices in a cluster are directly connected through a common link, the circle representing the cluster displays a colored outline. The color of the outline is the same as the color configured to denote the highest utilization for the link interconnecting those devices.
To identify interconnected devices in a cluster, double-click the cluster and zoom in to the next level.
View Live Topology Updates
Paragon Automation 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 Paragon Automation.
To view live updates in topology, you need to do the following:
Specify the IP address of the BGP-LS peer and autonomous system (AS) number on the Topology Settings page (Observability > Network > Topology > Topology Menu Bar > Settings icon).
Manually refresh the Topology page or you need to right-click on the topology map and select Reload Network.
In addition, on the topology map, you can view the latest operational status of devices, links, sites, and tunnels.