The Top-N widget displays the top n results from analysis of an object or objects that you select.

How the Top-N Widget and Configuration Options Work

You can select an object when you configure the Top-N widget or you can select an object on another widget. The widget can show analysis of the applications, alerts, and metrics of an object and its child objects depending on your selection when you configure the widget. The widget can show an analysis of the current values or values for a period of time. See Top-N Widget Configuration Options. You can receive detailed information about each object on the widget. When you double-click an object, the Object Detail page appears.

You edit a Top-N widget after you add it to a dashboard. To configure the widget, click the pencil at the upper-right corner of the widget window. You can configure a widget to receive data from another widget by selecting Off for Self Provider. You can configure a widget to display results from analysis of an object that you select on the source widget.

For example, you can select a host on a Topology widget and observe the metric analysis of VMs on the host. To set a receiver widget that is on the same dashboard, use the Widget Interactions menu when you edit a dashboard. To set a receiver widget that is on another dashboard, use the Dashboard Navigation menu when you edit a source dashboard.

Where You Find the Top-N 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 in the left pane, and click Dashboards. On the Dashboards toolbar, click the plus sign to add a dashboard or the pencil 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 pencil to access the configuration options.

Top-N Widget and Configuration Options

Table 1. Top-N Widget Toolbar Icons

Icon

Description

Dashboard Navigation

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

Object details

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

Display Filtering Criteria

Shows the filtering settings for the widget in a pop-up window.

Table 2. Top-N Widget Configuration Options

Option

Description

Title

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

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 .

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.

Image Redraw Rate

Set the redraw rate.

Period Length

Use the Range menu to select a range of time for which to display data.

Use the From and To menus to select a specific start and stop date and time period.

Note:

If you select Current Value as the range, the result is based on the last data collected. For any other range you select, the result is based on the aggregated value.

Application Health and Performance

Available when you use the Tag tab.

  • Top Least Healthy. The top n results from an analysis of the object or objects that are the least healthy.

  • Top Most Healthy. The top n results from an analysis of the object or objects that are the most healthy.

  • Top Most Volatile. The sorted list of values based on the standard deviation of values for a several of alerts over time.

Select the criteria for analysis of the objects.

Alert Analysis

Available when you use the Tag tab.

Select the criteria for analysis of the alerts.

Metric Analysis

Available when you use the Metric tab

  • Top Highest Utilization. A list of objects with similar object types that have the highest utilization on configuring usage metrics like CPU usage and memory usage.

  • Top Lowest Utilization. A list of objects with similar object types that have the lowest utilization on configuring usage metrics like CPU usage and memory usage.

  • Top Abnormal States. The objects are ordered by the duration of all alarms that are triggered on the selected metric for a selected interval.

  • Top Highest Volatility. The sorted list of values based on the standard deviation of values for a number of alerts over time.

Select the criteria for analysis of the metric that you select from the metric tree.

Bars Count

Select the number of top results.

Depth

Select the number of the child objects.

Filter old metrics

Select or deselect whether the analysis includes old metric values.

Selected Object

Object that is the basis for the widget data.

The object that you select from the Objects data grid when you expand Objects is propagated to the text box.

Selected Object Type

The object type or types that you select from the Object Types data grid. Click the Clear Selection toolbar icon from the Object Type pane to clear the text box.

Tag

  • Objects

    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.

  • Tag Picker. Use the Objects tag to select objects that are the basis for the widget. For example, you can click Collapse All, expand Object Types and select Datacenter and Datastore from the tag tree to observe data center and datastore objects from your inventory.

Metric

  • Tag tree Select the object tag that is the basis for the widget . For example, you can expand Object Types and select Host System to observe a metric analysis of the hosts in your environment .

  • Object type data grid Select one or more object types that are the basis for the widget. For example, you can select Virtual Machine and Compute Resource from the data grid and pick a common metric for both object types for analysis. The object types that you select from the data grid are propagated to the Selected Object Type text box.

  • Metric tree Select a metric that is the basis for the analysis that the widget shows. You can select a common metric or a metric that is specific for each object. To select a metric, first select an object type or object types from the data grid. For example, you can select Virtual Machine and Datacenter from the object types list and click Show common metrics to select a common metric for a VM and data center. You can click Select Object to select an object and pick a specific metric.