This section provides the details of parameters that are common for dashboard widgets.
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:
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:
Some widgets have additional configuration parameters Override host and Time period. 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.
The Host groups, Hosts and Item parameters allow selecting either the respective entities or a data source containing either host groups, hosts or items for which the widget can display data. For Host groups and Item parameters, the data source can be a compatible widget from the same dashboard. For Hosts parameter, the data source can be a compatible widget from the same dashboard or the dashboard itself.
The Override host parameter is used to set a data source containing a host for which the widget can display data. The data source can be either a compatible widget from the same dashboard, or the dashboard itself.
To specify a compatible widget as the data source, 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 the user does not have the necessary permissions to the host.
The Time period parameter is used to set a data source containing a time period for which the widget can display data. The data source can be either 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, 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, other widgets will be able to use it as a data source.
Some widgets can broadcast configuration data to other widgets, some can listen for data, and some can do both. For example:
The following table outlines the broadcasting and listening capabilities of each widget.
Widget | Broadcasts | Listens |
---|---|---|
Action log | - | Time period |
Clock | - | - |
Data overview | - | Host groups, Hosts |
Discovery status | - | - |
Favorite graphs | - | - |
Favorite maps | - | - |
Gauge | - | Items |
Geomap | Host groups, Hosts | Host groups, Hosts |
Graph | Time period | Time period |
Graph (classic) | Time period | Items, Graphs, Time period |
Graph prototype | Time period | Time period |
Honeycomb | Hosts, Items | Host groups, Hosts |
Host availability | - | Host groups |
Host navigator | Hosts | Host groups |
Item history | Items | Time period |
Item navigator | Items | Host groups, Hosts |
Item value | - | Items, Time period |
Map | Host groups, Hosts | Maps |
Map navigation tree | Maps | - |
Pie chart | - | Time period |
Problem hosts | Host groups, Hosts | Host groups |
Problems | Events | Host groups, Hosts |
Problems by severity | Host groups | Host groups, Hosts |
SLA report | - | - |
System information | - | - |
Top hosts | Hosts | Host groups, Hosts |
Top triggers | - | Time period |
Trigger overview | - | Host groups, Hosts |
URL | - | - |
Web monitoring | Host groups | Host groups, Hosts |
When a widget has been configured to listen for data from another widget, which is not broadcasting this data, the widget will enter the Awaiting data state.
When a widget has been configured to listen for data from another widget, which has been deleted, replaced with an incompatible widget, or moved to another dashboard page, the widget will enter the Referred widget is unavailable state.