FEATURE AVAILABILITY: LogicMonitor Pro and Enterprise
The Mapping page is the heart of LogicMonitor’s topology mapping capabilities. From this page, topology maps are created, managed, and added to dashboards as Topology Map widgets. Topology maps provide visual context for monitoring operations and have the following abilities:
- Visualize and navigate resources based on topology relationships
- Troubleshoot alerts within your infrastructure on a topology map
- Discover and map relationships between resources
- Save relevant and frequently-used topology maps for monitoring continuity
- Generate topology maps based on alerts to streamline your troubleshooting workflow
For more information, see Topology Mapping Overview.
Note: In addition to rendering topology maps on the Mapping page, you can render maps from the Resources page. These maps are more limited in scope, reflecting the relationships that the currently selected resource has with other elements in your network. For more information on the Maps tab, see Maps Tab.
Creating Topology Maps
1. Navigate to Mapping > Saved Maps > Add and select “New Map”.
On the Mapping page, an Add Resources dialog box is displayed.
2. In the Add Resources dialog box, select the “Group” and the “Resource name” to add the required resource. You can also add multiple resources.
Note: You can only add the resources that are assigned with external resource IDs (ERIs). To verify if the resource has an ERI, check if the resource has the value for the host property
Note: If the resources are inaccurately displayed on your topology map, see the troubleshooting section of the Topology Mapping Overview.
3. (Optional) Enter the instance name to add instances.
4. Click Save.
5. Click on the newly-added resource, an Action drop-down menu is displayed.
6. Click Edges to filter relationships between resources.
Each added relationship consists of a second vertex, connected to the first vertex by an edge.
7. From the Actions drop-down menu, click “Unpin”, to unpin a resource.
When you click Unpin, the selected resources will be removed.
Note: You can expand any vertex whenever required. In addition, you can traverse relationships across your network environment indefinitely.
8. (Optional) From the Actions drop-down menu, click Connections to view the incoming or outgoing relationships between resources.
9. From the Layout field drop-down menu, select an organizing structure for the topology map’s layout from the following options:
- Hierarchical (top-down): This is the default layout. In this layout, vertices are organized in a top-down tree-like structure.
- Hierarchical (left to right): The horizontal layout is the hierarchical layout rotated ninety degrees counter-clockwise. Relationships flow left to right.
- Dynamic: This is a force-directed layout algorithm. Vertices repulse each other and edges act as “springs” to pull them together.
- Radial: The radial layout positions vertices in a circle that originates from a starting center vertex.
- Circular: The circular layout positions the groups related subsets of the nodes into circular patterns.
10. Click Recenter to set the map in the center.
11. Click – or + on the percentage zoom setting to zoom in gradual increments.
12. Click Clear to clear the canvas when viewing existing topology maps or building new ones. It does not permanently delete a saved map.
13. Click the Time Series drop-down, to select the time range for which you want to check the status of the monitored resources.
Note: The Time series filter is applied only to the alerts present on all nodes within the map.
14. (Optional) From the Time Series option, click Custom range to customize the time range. Once you enter the required time range, click Save.
15. Click Save. However, there are several configurations that must be completed upon first save. For more information, see Saving Topology Maps.
Saving Topology Maps
To repeatedly access a topology map or add it to a dashboard as a widget, click the Save button at any point while creating the map to save the map.
Note: Upon first save, there are several configurations to complete. Once these configurations are established, LogicMonitor returns you to the map canvas so that you can continue creating the topology map.
1. Click the Save icon located in the upper-right corner of the Mapping page and select Settings.
A Topology Properties dialog box is displayed.
2. Enter the name and description in the Topology Name and the Description fields.
3. In the Group field, enter the name of the group in which your topology map will be organized.
Note: LogicMonitor only allows you to select a group previously created; if you do not select a group, your topology map will be assigned to the default “Ungrouped” group.
4. To display alert status, toggle the Show alert status switch.
5. To display all the edges in the map, toggle the Display all edges switch.
6. To display the undiscovered vertices, toggle Display undiscovered vertices. For more information see Undiscovered Vertices.
7. Click Save.
Once saved, a topology map can be cloned (available in the More options).
Adding Topology Maps to Dashboards
You can add the saved topology maps to dashboards as Topology Map widgets. You can navigate to click the Add to dashboard ( ) icon from More Options on the top-right corner of the Mapping page. For more information on Topology Map widgets, see Topology Map Widget.
Open Relevant Alerts and Resources from Topology Maps
Topology maps offer convenient methods of portal navigation, allowing you to gather additional context.
Open Relevant Alerts
By default, topology maps identify the alert status of all mapped resources. This is key to troubleshooting alerts and identifying when a series of events are related to the same root cause.
If an alert icon is associated with a resource in your topology map, you can click the alert icon to open a complete list of active alerts for that resource.
Note: Not only can you generate a list of relevant alerts from a topology map, but you can also generate a relevant topology map from an individual alert on the Alerts page. For more information, see Managing Alerts from the Alerts Page.
Double-click any vertex on a topology map to navigate directly to the resource it represents. The Resources page opens in a new browser tab with the resource in focus on the Maps tab.
Displaying Header Graph
To display the Header Graph, you must enable the Header Graph option on the Alerts page.
For assistance, contact LogicMonitor Support.
1. Click the More Options icon located in the upper-right corner of the Mapping page and select “Header Graph”.
The graph retains your prior groupings (dimensions) while reflecting the alerts currently listed in the Alert table.
2. Click Header Graph to view visual grouping alerts.
The alerts in the alert table can also be viewed as a time-series graph.
You can do the following with the graph:
- Zoom in on a time range by clicking and dragging across the desired timeframe.
- Click on a grouping in the legend or in the graph to include or exclude that group of alerts.
As you interactively change the graph’s filters, the Alert table automatically updates to remain in sync
Topology Node Properties
The Node Properties panel provides details regarding the resources in the topology map. When you click on the nodes in the topology map, a panel containing details about the alerts and node properties is displayed.
The following information is displayed in the Node Properties section:
- Properties: Properties are used to store device credentials, system information, collector details, and custom property information that can be accessed in device communication, reports, and alert messages.
- Member of Groups: Devices can be members of multiple groups. Displays the list of the groups in which the device is added.
- Member of Services: Displays the list of services that are added to the device.
- External Resource IDs (ERIs): ERIs are properties set on devices, instances, and services (collectively referred to as resources on the LogicMonitor platform) that allow resources to be recognized for inclusion in topology maps.
Note: You can also view the node properties information in the Info tab on the Resources page.
In addition, you can view maps and node properties details on different pages in LogicMonitor. For example, on the Alerts Page and Resource page. For more information, see Explore Maps.
You can view the alert graphs for the alerted resources in the Node Graphs tab and based on the alerts you can troubleshoot and resolve the issues.
Note: The various graphs displayed are defined in the DataSource definition. For more information, see DataSource Graphs.
In addition, you can filter the graphs from the Chart Toggle section.
As you build your topology map, the following features are available for customized viewing and display:
- Hover for additional details: You can hover over a vertex to display the vertex name to the forefront (helpful on crowded maps with overlapping display names). Similarly, you can hover over an edge to display the edge type (For example, the name of the edge type).
- Drag vertices or entire map: You can drag and drop any vertex to a new location on your topology map. In addition, multiple vertices can be dragged at once.
To drag multiple vertices: (1) position the cursor in approximation to the desired vertices and hold down a left click until the cursor becomes a plus sign; (2) with the click still held, draw a box that encompasses all the vertices you want to move; (3) click any one of the vertices that you drew a box over to drag all selected vertices to a new location.
The entire topology map can be repositioned on the canvas by grabbing and dragging any point of white space.
Note: You can drag vertices only when the map is in the Dynamic layout.
- Right-click edges: When multiple edges connect two vertices, the default behavior is to collapse those edges into a single edge for cleaner viewing. However, you can right-click on a collapsed edge to show all edges between two vertices. (There is also the option to override this default behavior from a map’s settings using the Display All Edges option.)
When you create a topology map, it reflects up-to-date relationship information. Refreshes occur with each Collection interval, as specified in the TopologySource. If a Collector contributing to the topology map goes offline, the relationships are cached until the Collector comes back online. The relationships are updated if any changes occurred while the Collector was offline.
For more information, see Topology Mapping Overview.
Icons in the Topology Map
Each vertex on your topology map is designated with an icon. This icon denotes its type, which is determined by the external resource type (ERT) assigned to the resource. Vertex icons are organized by resource type categories. For more information, see External Resource Types.
Undiscovered resources are resources that are either not monitored or are deleted. LogicMonitor’s topology maps can display connections to undiscovered vertices. This helps you visualize the environment and see the status of each resource.
The () Undiscovered Vertices icon helps you distinguish if the resources are monitored or not monitored.
If you want to view the undiscovered resources, navigate to More options > Settings > Topology Properties and toggle the Show undiscovered vertices switch.
You can view maps on different pages in LogicMonitor. For example, on the Alerts Page and Resource page.
The Maps tab displays all incoming and outgoing relationships with one degree of separation from the selected resource.
Note: If you want to add or edit the map, click the Explore Maps icon. You are navigated to the Mapping page, where you can filter connections, edit the map, and add devices.
On the Alert page, click the required alert, a table is displayed with the alert details. You can click Maps, to view the topology map.
On the Resource Page, you can click the required Device group or a Device. Click Maps, to view the topology map.
Resource group information page
Resource information page