Last updated: May 23. 2016
1. Customising dashboards
A dashboard combines various contents such as views, history graphs and other elements on a single page. What makes Check_MK's dashboards special is that with the aid of an intelligent algorithm they can adapt themselves automatically to the user's screen dimensions. In this way a user with a large screen can make optimal use of the screen's area, but the dashboard can still function on a small screen. Here is an example of a start dashboard:
Check_MK includes a dashboard editor. Editing mode is accessed by clicking – appriopiate access rights in place – on the gearwheel symbol (below right on the screen) and choosing Edit Dashboard in the menu that opens.
In the above image you can also see the layout mechanisms that exactly adjust the sizes of the elements to the available screen space:
1.1. Adding an element
Click on the gearwheel symbol and then select Add dashlet ➳ Static text:
The configuration dialogue for the new element will open:
This dialogue contains two sections:
A static text displays a default text to the user. This text can be changed via the text entry field in the element's properties. Saving the element will take you to the dashboard.
The following symbols are displayed in edit mode:
1.2. Adding elements via context menus
The reverse direction is also possible: With every view and graph there is a context menu via which you can add an element to the dashboard. Here is a history graph for example:
Clicking on the highlighted button opens the following selection menu:
1.3. How a dashboard adjusts itself to fit a screen
Dashboards are able to dynamically-adjust themselves to diverse screen dimensions. The basic idea is that alongside elements with fixed dimensions, (such as e.g. Host Statistics and Service Statistics in the Main Overview dashboard), there are also those that can benefit from having more space. These dynamic elements scale themselves to make optimum use of the available space.
In order to simplify operation, a dashboard is generated as a raster composed of 10 x 10 pixel units. These units determine the dimensions of all elements:
This procedure occurs not only on starting, but also whenever the browser window or its zoom setting is altered.
Use the mouse to interactively edit the element's sizes, positions and dimensions:
2. Creating a new Dashboard
To create a new dashboard, in the Views element click on EDIT in the sidebar. This will open a list of views. Proceed from here with the Dashboards button.
There click on the New button ...
... and you will be forwareded to Select specific object type site:
You will generally not make any selections here but proceed by clicking on Continue. You will thereby create a global dashboard without any specific context (e.g. a host).
In the subsequent window you can specify the basic characteristics such as name, title, etc. If this new dashboard is to be displayed with existing ones, then enter Overview in the topic field. On saving you will be taken to the dashboard list.
3. Making dashboards available for other users
If you have the access rights for publishing dashboards then you can also determine who else can access your dashboards. This means that all users of your dashboard receive it rather than the default version.
4. Specifying a start dashboard
You can specify any existing dashboard as the start URL when Check_MK opens. To do this, open the dialogue via WATO ➳ Global settings ➳ User interface. Click on the Start-URL to display in mainframe link. Substitute the existing content dashboard.py for the desired dashboard name prod like this: dashboard.py?name=prod. Complete this procedure by clicking on Save. The next time you start Check_MK this specified dashboard will be displayed.
Via the Personal settings section in the user setup you can define an individual start dashboard for every user.