The Topology Graph widget gives a graphical presentation of objects and their relationships in the inventory. You can customize each instance of the widget in your dashboard.

How the Topology Graph Widget and Configuration Options Work

The Topology Graph widget enables you to explore all nodes and paths connected to an object from your inventory. Connection between the objects might be a logical, physical, or network connection. The widget can display a graph that shows all of the nodes in the path between two objects, or that shows the objects related to a node in your inventory. You select the type of graph in the Exploration Mode when you configure the widget. You can select the levels of exploration between nodes in the displayed graph by using Relationship check boxes when you edit the widget. The widget displays all object types in the inventory by default, but you can select object types to view by using the Object View list during the configuration process. Double-clicking an object on the graph takes you to a detailed page about the object.

Where You Find the Topology Graph Widget and Configuration Options

The widget might be included on any of your custom dashboards. In the left pane, click Home to see your configured dashboards.

To customize the data that appears in the dashboard widget, click Content > Dashboards. On the Dashboards toolbar, click the Add icon to add a dashboard or the Edit icon to edit the selected dashboard. In the Dashboard workspace, on the left, click Widget List, and drag a widget to the right pane of the dashboard. On the title bar of the selected widget, click the Edit icon to access the configuration options.

Topology Graph Widget Toolbar Options

Option

Description

Action

Use to select from predefined actions for each object type. To see available predefined actions, select an object in the graph and click the toolbar to select an action. For example, when you select a datastore object in the graph, you can click Delete Unused Snapshots for Datastore to apply this action to the object.

Dashboard Navigation

Takes you to a predefined object . For example, when you select a datastore from the graph and click Dashboard Navigation, you can open the datastore in the vSphere Web Client .

Pan

Use to move the entire graph.

Show values on point

Provides a tool tip with parameters when you point to an object in the graph.

Zoom in

Zooms in the graph.

Zoom out

Zooms out the graph.

Hierarchical View

Use to switch to hierarchical view. Hierarchical view is enabled only for Node Exploration mode and with selected inventory tree.

Graph View

Use to switch to graph view.

Object Detail

Select an object and click this icon to show the Object Detail page for the object.

Expand Node

Selects which object types related to your object to show on the graph. For example, if you select a virtual machine from the graph and click Expand Node toolbar icon and select Host System, the host on which the virtual machine is located is added to the graph.

Hide Node(s)

Use to remove a given object from the graph

Reset To Initial Object

Use to return to the initially displayed graph and configured object types.

Explore Node

Use to explore a node from a selected object in the graph. For example, if the graph displays a connection between a VM, a host, and a datastore, and you want to check the connection of the host with the other objects in the inventory, you can select the host and click Explore Node.

Status

Use to select objects based on their status or their state.

Topology Graph Widget Configuration Options

To configure a widget, click the Edit icon on the widget title bar.

Option

Description

Title

Enter a custom title that identifies this widget from other instances that are based on the same widget template.

Exploration Mode

Use Node Exploration mode to observe a selected object from an object list and the objects related to it. For example, if you select a virtual machine and select node exploration mode, the widget shows the host where the VM is placed and the datastore storing the files of the VM.

Use Path Exploration mode to observe the relation between two objects. You must select them from the Select First Object list and the Select Second Object list. For example, if you select to explore the path between a VM and a vCenter Server, the graph shows you both objects and all nodes in the path between the VM and server as datastore, datastore cluster, and datacenter .

Important:

To select object view is mandatory for the widget to start working in path exploration mode.

Use Show All Path to observe connections between a node and nodes related to it as well as connections between the nodes. For example, if you are using node exploration mode and you select to observe a VM and all objects types, the graph shows a VM connected to its datastore and host and the connection between the host and datastore.

Use Discovered Path only to observe directly related nodes. For example, if you are using node exploration mode and you select to observe a VM and all objects types, the graph will shows the VM connected to its datastore and to its host, but without the connection between the host and datastore .

Refresh Content

Enable or disable the automatic refreshing of the data in this widget.

If not enabled, the widget is updated only when the dashboard is opened or when you click the Refresh button on the widget in the dashboard.

Refresh Interval

If you enable the Refresh Content option, specify how often to refresh the data in this widget .

Configuration file

The default configuration includes parent and child relationship. Drop-down options depend on the installed Solutions. You can add a new type of relationship to the Relationship pane.

Metric Configuration

Specifies a list with attributes to display, when the information is based on the interaction with another widget.

To add a resource interaction XML file through the CLI directory, seeAdd a Resource Interaction XML File. To add a resource interaction XML file through the UI, see Manage Metric Configuration.

The newly created XML file appears in the Metric Configuration drop-down menu of the widget.

Self Provider

Indicates whether the objects for which data appears in the widget are defined in the widget or provided by another widget.

  • On. You define the objects for which data appears in the widget.

  • Off. You configure other widgets to provide the objects to the widget using the dashboard widget interactions options.

Selected Object

Object that is the basis for the widget data.

Degree of separation

Available only when node exploration mode is selected. Use to define the levels of exploration in Node Exploration mode. The lowest degree configuration shows only directly related nodes rather than higher degrees that show the inventory in details.

Object List

List of objects in your environment that you can search or sort by column so that you can locate the object on which you are basing the data that appears in the widget.

If you select an object in the list, the object becomes the selected object for the widget.

Object view

Use to select which types of objects to observe in the graph.

Relationship

Select the type of relationship between objects to observe in the graph, respectively the details about your inventory . The common relationships for all objects are parent and child, but the list of relationships can vary depending on added Solutions to vRealize Operations Manager.

Select First Object

Available only in path exploration mode. Select the first object from the object list.

Select Second Object

Available only in path exploration mode. Select the second object from the object list.