The Scoreboard widget shows the current value for each metric of objects that you select.

How the Scoreboard Widget and Configuration Options Work

Each metric appears in a separate box. The value of the metric determines the color of the box. You define the ranges for each color when you edit the widget. You can customize the widget to use a sparkline chart to show the trend of changes of each metric . If you point to a box, the widget shows the source object and metric data.

You edit a Scoreboard widget after you add it to a dashboard. To configure the widget, click the pencil at the upper-right corner of the widget window. The widget can display metrics of the objects selected during editing of the widget or selected on another widget. When the Scoreboard widget is not in Self Provider mode, it shows metrics defined in a configuration XML file that you select in the Metric Configuration. It shows 10 predefined metrics if you do not select an XML file or if the type of the selected object is not defined in the XML file.

For example, you can configure the Scoreboard widget to use the sample Scoreboard metric configuration and to receive objects from the Topology Graph widget. When you select a host on a Topology Graph widget, the Scoreboard widget shows the workload, memory, and CPU usage of the host.

To set a source widget that is on the same dashboard, you must use the Widget Interactions menu when you edit a dashboard. To set a source widget that is on another dashboard, you must use the Dashboard Navigation menu when you edit the source dashboard.

Where You Find the Scoreboard 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.

Table 1. Scoreboard 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.

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.

Layout Mode

Select a Fixed Size or Fixed View layout.

Box Height

Box Columns

Use these menus to customize the size of the box for each object.

Visual Theme

Select a predefined visual style for each instance of the widget. The options are: Original, Theme 1, Theme 2, Theme 3, and Theme 4. The default style is Theme 2.

Label Size

Value Size

Use these menus to customize the format of the scores that the widget displays.

Show Object Name

Select whether to display the object name.

Show Metric Name

Select whether to display the name of the metric in the widget.

  • On. The name of the metric you select is displayed in the widget.

  • Off. The name of the metric you select is not displayed in the widget.

Show Metric Unit

Select whether to display the metric unit in the widget.

  • On. The name of the metric you select is displayed in the widget.

  • Off. The name of the metric you select is not displayed in the widget.

Show Sparkline

Select whether to display the Sparkline chart for each metric. If you select the widget to display sparkline, you can select the time frame from thePeriod Length option that the chart includes.

Period Length

Select a length of time for statistic information that the sparkline chart shows.

Objects

Object that is the basis for the widget data.

  • Object tree

    You can filter the list of objects in the object data grid. You can select one or more object types and the data grid displays all objects from these types. For example, to observe information about the VMs and vCenter Server in the inventory, click Collapse All, expand Object Types in the object tree, and select Virtual Machine and vCenter Server. The data grid shows only VMs and vCenter Server objects from the inventory. To deselect adapter types, click Deselect All.

  • Object data grid

    Lists objects in your environment that you can search or sort by column so that you can locate the object to pick its metrics.

    When you click an object from the list, its metrics appear in the metric tree. You can select multiple objects from the data grid when you mark objects in the list and click the Perform Multi-Select Interaction toolbar icon. To deselect an object or objects, click the Clear Selections toolbar icon.

Object Types

List of available object types. Use to select an object type that is the basis for the metrics tree. You can select an object from an object type and to pick its metrics when you click Select Object toolbar icon from the metrics pane. The Select Object takes you to the list of objects from selected object type. For example, you can select Datacenter from Object Types data grid and click Select Object that takes you to the list with datacenters in your environment.

Metric Tree

Shows available metrics of an object or object type that you select from the data grid. Use the metric tree to select a metric that is basis for the widget. The metric tree can show common metrics for several objects when you click the Show common metrics toolbar icon. To pick several metrics, select the metrics from the tree and click Perform Multi-Select Interaction.

The Select Object toolbar icon appears when you use the Object Types tab.

Objects List

List of the objects and their metrics that the widget displays.

Your selection of an object and a metric from the object data grid and metrics tree is propagated to the Object and Metric columns.

You can use the Box Label text box to customize the label of each metric box on the widget.

You can use the Measurement Unit text box to define a measurement unit of each metric.

You can use the Color Method option to define a coloring criteria. To define values for the metric box colors, enter values in the text boxes.

You can use the Apply to All toolbar icon to customize a metric box and apply the same customization to all metrics.

For example, to select to observe a remaining memory capacity of a VM. select Virtual Machine as an object type, expand the Memory from the metric tree and double-click Capacity Remaining(%). Define a meaningful label name and measurement unit to help you when you observe the metrics. You can select Custom from the Color Method drop-down menu and specify different values for each color, for example 50 for yellow, 20 for orange, and 10 for red. To apply the same label and color criteria to all other selected metrics, select the metric and click Apply To All .