Edit Dashboards

Security Requirements and Controls

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.

Manage Dashboards

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.

Dashboard Edit

Figure 110. Dashboard Edit


  1. 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.

  2. 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).

  3. Once you are happy with editing the dashboards and widgets click Save, otherwise Discard Changes.

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.

  1. On the top left of the dashboard, click No Filter → Open Filters Panel.

  2. Enter a filter expression in the box: the filter specified here will be prefixed to all queries of all widgets on the dashboard.

  3. Click Apply Filter and Save.

Typically, you will only use filter expressions like for example:

logscale
env=prod or
 in(service, [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”.)

  • Shared Time — assign a given time selection to all widgets on the dashboard irrespective of the time set in a specific query/widget.

    If this Shared time option is toggled off, the Time Selector field will be hidden, and the time that was defined in each widget will apply.

  • Time Selector — Only available when Shared time 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.

    1. Click Shared time to enable it.

    2. Click the small arrow in the Time Selector field: the Time interval dialog pops up.

    3. Select the fixed or relative time range of your choice. For more details on the available time interval options, see Change Time Interval.

    4. Click Apply to confirm your choice.

    Time Interval Settings

    Figure 111. Time Interval Settings


  • Zoom out — Only available when Shared time is toggled on, the magnifier icon makes the interval of time twice as large e.g., from 5 min to 10 min ago.

  • Live checkbox — Only enabled when relative time ranges are selected from Shared time, makes the dashboard running live. The live mode applies to either the shared time or the time set in each widget.