Edit Dashboards
Security Requirements and Controls
Change dashboards
permission
Dashboards are managed from the three small icons on the top right, which allow you to perform these actions:
Edit dashboard — enters the dashboard's editing mode. For details see next section Working in Edit Mode.
Toggle full screen — gives more space to the dashboard area by entering in full-screen mode.
Open dropdown — opens the menu that allows to perform several operations with the dashboard. See Main Operations for more details.
Figure 109. Manage Dashboards
Working in Edit Mode
Once a few widgets have been created in a dashboard, you may want to make some changes as to how it's organized, how it's labeled, and what time frame it covers.
Figure 110. Dashboard Edit
Click the pencil icon on the top right to enter Editing Dashboard mode: this allows you to resize your widget, or drag and move it next to other widgets in the dashboard.
Change the following as required.
General where you can change the name of the dashboard, add a description and assign labels.
Default time — shows the current default time selection.To update the default, adjust the time setting you wish to change and save the dashboard. You will be prompted to confirm the change. See Default Time Settings for Dashboards for more information.
Time selector arrows — click to customize the skip interval used when moving the interval earlier or later in time with the and buttons. Click to use the default skip interval.
Time skip — field to enter the customized jump size (in milliseconds).
Once you are happy with editing the dashboards and widgets click
, otherwise .
When in edit mode, you can also use:
Add Note — adds a Note Widget. Note widgets allow you to use markdown to format the text and add other elements, such as, links to other dashboards and to external web pages, as well as dashboards on external systems.
Show Queries — displays the queries used by each widget so that you may edit the query or, if the results aren't quite right for a widget, you might want to copy a particular query, switch to the Search page and paste it in the query input box there so that you can modify it. You can also click the three dots on the widget and select Edit in Search view, as explained in Manage Widgets.
Filters
Filters are a powerful way of reducing data displayed on a dashboard to allow you to look at a subset of your data. Save a filter to quickly jump between different configurations and reuse the dashboard for, e.g., different environments, systems, or customers.
On the top left of the dashboard, click
→ .Enter a filter expression in the box: the filter specified here will be prefixed to all queries of all widgets on the dashboard.
Click
and .
Typically, you will only use filter expressions like for example:
env=prod or
in(service, values=[nginx, mysql])
as opposed to aggregate functions like groupBy()
and timeChart()
.
Parameters
From the top of the dashboard area, you can also set parameters.
Parameters allow you to filter and modify dashboard results. Using
parameters like for example
?username
or
?host
or
?{env=staging}
in a query will
show an input field on dashboards, and will be read from the URL when
the dashboard loads.
For all the details about parameters and how to configure them in dashboards, see Manage Dashboard Parameters.
Time Interval Settings
You can set the desired time interval and time zone for a dashboard, or make it running live, with the following buttons — they are available from the top right of the dashboard:
Time Zone Selector — assign a temporary timezone to all widgets on the dashboard without going into edit mode. When you change it, the new timezone is displayed e.g.
Europe/Copenhagen
and will be also read from the URL when the dashboard loads.Copying and pasting the dashboard URL in another tab keeps the selected timezone.
The new timezone is temporary because logging out/in brings it back to default (your timezone).
You can use the revert icon to reset the timezone to default (see Figure 111, “Time Interval Settings”.)
Time Selector — Only available when is toggled on, allows to change the time interval for the entire dashboard, and the change will overwrite whatever is already selected in the individual queries/widgets themselves.
Click
to enable it.Click the small arrow in the Time Selector field: the Time interval dialog pops up.
Select the fixed or relative time range of your choice. For more details on the available time interval options, see Change Time Interval.
Click
to confirm your choice.
Figure 111. Time Interval Settings