You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

1 Dashboard widgets

Overview

This section provides the details of parameters that are common for dashboard widgets.

Common parameters

The following parameters are common for every single widget:

Name Enter a widget name.
Refresh interval Configure default refresh interval. Default refresh intervals for widgets range from No refresh to 15 minutes depending on the type of widget. For example: No refresh for URL widget, 1 minute for action log widget, 15 minutes for clock widget.
Show header Mark the checkbox to show the header permanently.
When unchecked the header is hidden to save space and only slides up and becomes visible again when the mouse is positioned over the widget, both in view and edit modes. It is also semi-visible when dragging a widget to a new place.

Refresh intervals for a widget can be set to a default value for all the corresponding users and also each user can set his own refresh interval value:

  • To set a default value for all the corresponding users switch to editing mode (click the Edit dashboard button, find the right widget, click the Edit button opening the editing form of a widget), and choose the required refresh interval from the dropdown list.
  • Setting a unique refresh interval for each user separately is possible in view mode by clicking the button for a certain widget.

Unique refresh interval set by a user has priority over the widget setting and once it's set it's always preserved when the widget's setting is modified.

To see specific parameters for each widget, go to individual widget pages for:

Deprecated widgets:

Deprecated widgets will be removed in the upcoming major release.

Dynamic widgets

Some widgets have the Override host and Time period configuration parameters. These parameters can be used to configure a single data source to control the data displayed in one or multiple widgets without reconfiguring the widgets.

Override host

The Override host parameter sets a data source containing a host for which the widget can display data. The data source can be a compatible widget from the same dashboard or the dashboard itself.

To specify a compatible widget as the data source (see individual widget pages for compatibility information), enter the name of the widget and select it. The Override host field is auto-complete, so starting to type the name of the widget will offer a dropdown of matching widget names. Alternatively, click the Select button (or the dropdown button and then "Widget") to open a pop-up containing widgets available for selection.

To specify a dashboard as the data source, click the dropdown button and then "Dashboard". After configuring the widget and saving the dashboard, the Host field (for selecting a host) will appear at the top of the dashboard.

The widget will display an error if the host specified in the data source does not have the entity (item, graph, map, etc.) configured in the widget or if the user does not have the necessary permissions to the host.

Time period

The Time period parameter sets a data source containing a time period for which the widget can display data. The data source can be a compatible widget from the same dashboard, the dashboard itself, or the widget itself.

To specify a dashboard as the data source, set Time period to "Dashboard". After configuring the widget and saving the dashboard, the Time period selector will appear at the top of the dashboard.

To specify a compatible widget as the data source (see individual widget pages for compatibility information), set Time period to "Widget", enter the name of the widget and select it. The Widget field is auto-complete, so starting to type the name of the widget will offer a dropdown of matching widget names. Alternatively, click the Select button to open a pop-up containing widgets available for selection.

To specify the widget itself as the data source, set Time period to "Custom" and enter or select the start and end of the time period. After configuring the widget, compatible widgets can use it as a data source.