This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

1 Dashboard

Overview

The Monitoring → Dashboard section is designed to display summaries of all the important information.

A dashboard consists of widgets and each widget is designed to display information of a certain kind and source, which can be a summary, a map, a graph, the clock, etc.

Widgets are added and edited in the dashboard editing mode. Widgets are viewed in the dashboard viewing mode.

While in a single dashboard you can group widgets from various sources for a quick overview, it is also possible to create several dashboards containing different sets of overviews and switch between them.

The time period that is displayed in graph widgets is controlled by the time period selector located above the widgets. The time period selector label, located to the right, displays the currently selected time period. Clicking the tab label allows to expand and collapse the time period selector.

Note that when the dashboard is displayed in kiosk mode (accessible from the fullscreen mode) and widgets only are displayed, it is possible to zoom out the graph period by double clicking in the graph.

Viewing dashboards

To access all configured dashboards, click on the All dashboards link just below the section title.

To view a single dashboard, click on its name in the list of all dashboards.

To delete one or several dashboards, mark the checkboxes of the respective dashboards and click on Delete below the list.

Creating a dashboard

When viewing all dashboards, you can click on the Create dashboard button to create a new dashboard:

Initially the dashboard is empty. To populate the dashboard, you can add widgets.

Click on the Save changes button to save the dashboard. If you click on Cancel, the dashboard will not be created.

Adding widgets

To add a widget to a dashboard:

  • Click on the Add widget button in dashboard editing mode. The widget will be created in its default size and placed after the existing widgets (if any);

Or

  • Move your mouse to the desired empty spot for the new widget. Notice how a placeholder appears, on mouseover, on any empty slot on the dashboard. Then click to open the widget configuration form. After filling the form the widget will be created in its default size or take up all the available space if its default size is bigger. Alternatively you may click and drag the placeholder to the desired widget size, then release.

Then, in the widget configuration form:

  • Select the Type of widget
  • Enter widget parameters
  • Click on Add

The following widgets can be added to a dashboard:

In dashboard editing mode widgets can be resized and moved around the dashboard by clicking on the widget title bar and dragging it to a new location. Also, you can click on the following buttons within the widget to:

  • - edit a widget;
  • - remove a widget

Click on Save changes for the dashboard to make any changes to the widgets permanent.

Dynamic widgets

When configuring some of the widgets:

  • Graphs (simple and custom)
  • Plain text
  • URL

there is an extra option called Dynamic item. You can check this box to make the widget dynamic - i.e. capable of displaying different content based on the selected host.

Now, when saving the dashboard, you will notice that two new dropdowns have appeared atop the dashboard for selecting the host group/host:

Thus you have a widget, which can display content that is based on the data from the host that is selected in the dropdown. The benefit of this is that you do not need to create extra widgets just because, for example, you want to see the same graphs containing data from various hosts.

Viewing and editing a dashboard

When viewing a single dashboard, the following options are available:

Switch to the dashboard editing mode.
Open the action menu.
Sharing Edit sharing preferences for the dashboard. Dashboards can be made public or private.
Public dashboards are visible to all users.
Private dashboards are visible only to their owner. Private dashboards can be shared by the owner to other users and user groups.
For details on configuring sharing, see the map configuration section.
Create new Create a new dashboard.
First you are prompted to enter general properties of the new dashboard - owner and name. Then, the new dashboard opens in editing mode and you can add widgets.
Clone Create a new dashboard by copying properties of the existing one.
First you are prompted to enter general properties of the new dashboard - owner and name. Then, the new dashboard opens in editing mode with all the widgets of the original dashboard.
Delete Delete the dashboard.
Display dashboard in fullscreen mode.
Fullscreen mode can also be accessed with the following URL parameters:
/zabbix.php?action=dashboard.view&fullscreen=1. To exit: /zabbix.php?action=dashboard.view&fullscreen=0
Display dashboard in kiosk mode. In this mode only widgets are displayed.
The kiosk mode button appears when the fullscreen mode is activated.
To exit kiosk mode, move the mouse cursor until the exit button appears and click on it. Note that you will be taken back to normal mode (not fullscreen mode).
Kiosk mode can also be accessed with the following URL parameters:
/zabbix.php?action=dashboard.view&kiosk=1. To exit to normal mode: /zabbix.php?action=dashboard.view&fullscreen=0

Editing mode is opened:

  • when a new dashboard is being created
  • when you click on the edit button of a widget
  • when you click the Edit dashboard button for an existing dashboard

In the dashboard editing mode the following options are available:

Edit general dashboard properties - name and owner.
Add a new widget.
Save dashboard changes.
Cancel dashboard changes.

Permissions to dashboards

Permissions to dashboards for regular and Zabbix Admin users are limited in the following way:

  • They can see and clone a dashboard if they have at least READ rights to it;
  • They can edit and delete dashboard only if they have READ/WRITE rights to it;
  • They cannot change the dashboard owner.

Host menu

Clicking on a host in the Problems widget brings up the host menu. It includes links to custom scripts, inventory, latest data, problems, graphs and screens for the host.

The host menu is accessible by clicking on a host in several other frontend sections:

Problem event popup

The problem event popup includes the list of problem events for this trigger and, if defined, the trigger description and a clickable URL.

To bring up the problem event popup:

  • roll a mouse over the problem name in the Problem-Severity column of the Problems widget. The popup disappears once you remove the mouse from the problem name.
  • click on the problem name in the Problem-Severity column of the Problems widget. The popup disappears only if you click on the problem name again.

Resolved values of {ITEM.VALUE} and {ITEM.LASTVALUE} macros in trigger descriptions are truncated to 20 characters. To see the entire values you may use macro functions with these macros, e.g. {{ITEM.VALUE}.regsub("(.*)", \1)}, {{ITEM.LASTVALUE}.regsub("(.*)", \1)} as a workaround.