The health chart widget displays Health, Risk, Efficiency, or custom metric charts for selected objects. You use the widget to compare the status of similar objects based on the same value.

How the Health Chart Widget Works

You can add the health chart widget to one or more custom dashboards and configure it to display data that is important to the dashboard users. The information that it displays depends on how the widget is configured.

If the widget is configured to display Health, Risk, or Efficiency, the chart values are based on the generated alerts for the selected alert type for the selected objects.

If the widget is configured to display custom metrics, chart values are based on the metric value for the configured time period.

You edit the health chart widget after you add it to the dashboard. The changes you make to the options create a custom widget with the selected charts.

The charts are based either on Health, Risk, or Efficiency alert status, or you can base them on a selected metric. You can include a single object, multiple objects, or all objects of a selected type.

Where You Find the Health Chart Widget

In the menu, click Dashboards > Actions > Create Dashboard to add a dashboard or click Dashboards > Actions > Edit Dashboard to edit the selected dashboard. Toggle between the Views and Widgets option to view and add a widget to the dashboard. In the widgets list panel, you will see a list of all the predefined widgets. Drag a widget to the dashboard workspace in the upper panel. On the title bar of the selected widget, click the Edit Widget icon to access the configuration options.

Health Chart Widget and Configuration Options

To view the value of the object at a particular time, hover your mouse over the chart. A date range and metric value tool tip appear.

Table 1. Toolbar Options

Option

Description

Period Length

Amount of time that is displayed in the chart.

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.

Units

Select the units in which the widget displays data. This option is visible when you select a custom source of data in the widget configuration.

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

Table 2. Health Chart 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.

Mode

Determines if the widget displays data for the selected objects, child objects, or parent objects.

If you select Children or Parents, the selected objects do not appear in the widget. Only the related objects.

Auto Select First Row

Determines whether to start with the first row of data.

Order By

Determines how the object charts appear in the widget.

You can order them based on value or name, and in ascending or descending order.

Chart Height

Controls the height of all charts. Choose from three possible choices - Small, Medium, Large. Default is Medium.

Pagination number

Number of charts that appears on a page.

If you prefer scrolling through the charts, select a higher number. If you prefer to page through the results, select a lower number.

Metric

Determines the source of the data.

  • Health, Risk, or Efficiency. The displayed charts are based on one of these alert badges.

  • Custom. The displayed charts are based on the selected metric and use either alert symptom state colors or the selected custom color. You can select a unit for the custom metric from the drop-down menu or choose to allow the widget to automatically pic a unit.

    If you apply custom colors, type the value in each box that is the highest or lowest value that should be that color. You can select a unit for the metric.

Show

Select one or more of the following items to display in the widget:

  • Select Object Name to display the name of the object in the widget.

  • Select Metric Name to display the name of the metric in the widget.

Object Tag Tree

Object or object types for which to display charts.

If you select a tag with more than one object, the widget displays charts for each object. If you select more than one tag, the widget displays charts only for the objects that are members of all the tags.

If you select two tags an your widget does not display any charts, there were no common objects between the two tags.