You can use the Metric Chart widget to monitor the workload of your objects over time. The widget displays data based on the metrics that you select.

How the Metric Chart Widget Works

You can add the Metric Chart widget to one or more custom dashboards and configure it to display the workload for your objects. The data that appears in the widget is based on the configured menu items for each widget instance.

You edit the Metric Chart widget after you add it to a dashboard. The changes you make to the menu items create a custom widget with the selected metrics that display the workload on your objects.

To select metrics, you can select an object from the object list, then select the metrics. Or, you can select a tag from the object tag list to limit the object list, then select an object. You can configure multiple charts for the same object or multiple charts for different objects.

To use the metric configuration, which displays a set of metrics that you defined in an XML file, the dashboard and widget configuration must meet the following criteria:

  • The dashboard Widget Interaction menu items are configured so that another widget provides objects to the target widget. For example, an Object List widget provides the object interaction to a chart widget.

  • The widget Self Provider options are set to Off.

  • The custom XML file in the Metric Configuration drop-down menu is in the /usr/lib/vmware-vcops/tools/opscli directory and has been imported into the global storage using the import command.

Where You Find the Metric Chart Widget

The widget might be included on any of your custom dashboards. On the menu, click Dashboards to see a list of dashboards in the left pane.

The Metric Chart widget is also displayed on the Workload Utilization dashboard with the name Workload Trend.

Metric Chart Widget Toolbar Options

The toolbar at the top of the Metric Chart widget contains icons that you can use to change the view of the graphs.

Option

Description

Split Charts

Displays each metric in a separate chart.

Stacked Chart

Consolidates all charts into one chart. This chart is useful for seeing how the total or sum of the metric values vary over time. To view the stacked chart, ensure that the split chart option is turned off.

Dynamic Thresholds

Shows or hides the calculated dynamic threshold values for a 24-hour period.

Show Entire Period Dynamic Thresholds

Shows or hides dynamic thresholds for the entire time period of the graph.

Anomalies

Shows or hides anomalies. Time periods when the metric violates a threshold are shaded. Anomalies are generated when a metric crosses a dynamic or static threshold, either above or below.

Trend Line

Shows or hides the line and data points that represents the metric trend. The trend line filters out metric noise along the timeline by plotting each data point relative to the average of its adjoining data points.

Show Data Values

Enables the data point tooltips if you switched to a zoom or pan option. Show Data Point Tips must be enabled.

Zoom All Charts

Resizes all the charts that are open in the chart pane based on the area captured when you use the range selector.

You can switch between this option and Zoom the View.

Zoom the View

Resizes the current chart when you use the range selector.

Pan

When you are in zoom mode, allows you to drag the enlarged section of the chart so that you can view higher or lower, earlier or later values for the metric.

Zoom to Fit

Resets the chart to fit in the available space.

Remove All

Removes all the charts from the chart pane, allowing to you begin constructing a new set of charts.

Refresh Charts

Reloads the charts with current data.

Date Controls

Opens the date selector.

Use the date selector to limit the data that appears in each chart to the time period you are examining.

Generate Dashboard

Saves the current charts as a dashboard.

The graph selector options determine how individual data appears in the graph.

Option

Description

Close

Deletes the chart.

Save a snapshot

Creates a PNG file of the current chart. The image is the size that appears on you screen.

You can retrieve the file in your browser's download folder.

Save a full screen snapshot

Downloads the current graph image as a full-page PNG file, which you can display or save.

You can retrieve the file in your browser's download folder.

Download comma-separated data

Creates a CSV file that includes the data in the current chart.

You can retrieve the file in your browser's download folder.

Select the units for the widget display

You can display the data with dots or as a percentage.

Move Down

Moves the chart down one position.

Move Up

Moves the chart up one position.

You can take the following actions on the Metric Chart graph.

Option

Description

Y Axis

Shows or hides the Y-axis scale.

Chart

Shows or hides the line that connects the data points on the chart.

Data Point Tips

Shows or hides the data point tooltips when you hover the mouse over a data point in the chart.

Zoom by X

Enlarges the selected area on the X axis when you use the range selector in the chart to select a subset of the chart. You can use Zoom by X and Zoom by Y simultaneously.

Zoom by Y

Enlarges the selected area on the Y axis when you use the range selector in the chart to select a subset of the chart. You can use Zoom by X and Zoom by Y simultaneously.

Zoom by Dynamic Thresholds

Resizes the Y axis of the chart so that the highest and the lowest values on the axis are the highest and the lowest values of the dynamic threshold calculated for this metric.

Metric Chart 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.

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.

Object Tag Tree

Filters the list of objects in the object list. You can select one or more object types and all objects from this type are displayed in the object list.

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.

The objects show based on the selected tag. If no tag is selected, the list shows all objects in the system.

Metric List

List of metrics available for the object selected in the object list.

Double-click the metrics to show in the widget.

Selected Metric List

Objects and metrics that are displayed in the widget.

The objects appear on the widget in the order they are presented in the list. To change the order of the displayed charts, reorder the list.