Custom widgets

Custom widgets are charts with user-defined connectors, data sources, monitoring elements, instances, widget properties, filters, background image, and chart properties.

Based on the state of the data definition, a custom widget can display any of the following Set Data Definition icons:
  • When the data definition is incomplete, then the custom widget displays an incomplete data definition Incomplete data definition icon.
  • When the data definition is complete, then the custom widget displays a complete data definition Complete data definition icon.
  • When the data definition is deleted, then the custom widget displays a deleted data definition Data definition deleted icon.
While you are creating custom widgets, you can complete the following tasks:
Change widget layout
Before you add a chart or template to a widget, you can edit the layout of the widget to add multiple widget placeholders and save the widget as an independent multi-chart widget. Thus, a single widget can host multiple widgets or charts within it.

For more information, see Specialized widgets.

Embed a website or web application
You can embed a web application or website in a widget by entering an external URL within a widget and save the widget as an independent web widget.

For more information, see Specialized widgets.

Change chart types
If the widget contains Area, Line, Pie, Donut, and Clustered or Stacked Bars and Columns charts, then you can replace these charts with other charts that belong to the same category. For example, if you use a Pie chart, then you can replace it with a Donut chart. You can change chart types during and after widget creation. However, on Dashboard Designer, you cannot change the chart type for Stacked Columns chart with X-axis data as time series data.
Set multiple data sources
Setting data definition is an important step during widget or template creation. It is in this step that you connect a data source to the chart and define the attributes that must be displayed on the widget. You can set data definitions by using any one of the following options:

You can add multiple data sources in a single widget by using multiple connectors.

Set widget-level filters
You can set default and custom filters for a widget. If the filters are already set in a widget template, then you can add, delete, or rearrange the already set filters. The total number of default and custom filters, including conditional or dependent filters, cannot exceed five. You can drag filters and change their display order. Parent (Direct or Independent) filters and child (Conditional or Dependent filters) filters cannot be switched. A parent filter always precedes its child filter. If you delete a parent filter, then its child filters are also deleted. If you select child (Conditional or Dependent filters) filters, then its parent (Direct or Independent) filters are added automatically.

After you set widget-level filters, you must map metrics to filters when you set assisted data definition or in manual data definition.

If widget-level filters are set for a custom widget, then it displays a checkmark on Set Filters Set Filter icon. Else, Set Filters icon does not display any checkmark.

You can set default PM filters for the following data sources only:
  • Cloud APM
  • Monitoring
  • ITM

You can set CEM filter and CEMWidgetFilters for Cloud Event Management data sources only. Date under the CEMWidgetFilters category is displayed at widget-level only. Use this filter to view entire data from any past date to the current date or just the current day data.

For more information about default filters, see Filters.

Set properties
After you set data definition, you must set toolbar and chart properties before you save the custom widget.
Set background image
You can add, replace, or delete a background image in a widget. You can also add, replace, or delete a background image in a widget after you add the widget to a dashboard.

For more information about setting a background image in an independent widget, see Creating custom widgets.

You can also create a custom widget that lists all the instances of a specific source. For more information, see Creating custom widgets to list all instances.

After you create custom widgets, you can also publish the custom widgets. For more information, see Publishing custom widgets.

Both widgets and templates are useful when you want to create dashboards within minimal time. You can use a template when you want to monitor different data sources and instances against preselected monitoring parameters.

The All Widgets page displays the audit trail information for all the custom widgets. The audit trail information provides details of the user who created or modified the custom widgets and the data and time when the custom widget was created or modified.