Editing Dashboards

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 95. 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 Mode

Figure 96. Dashboard Edit Mode


  1. Click the pencil icon on the top right. Change the following as required.

    • In the Dashboard Properties panel (the small arrow on the right opens/closes it):

      • Name — you can change the name of the dashboard.

      • Description — define, remove or change the description.

      • Default Time Settings — shows the current time selection. Click Set current time selection as default if you want to update the default time settings to match the time and liveness that is currently shown. The Time Selector field will show such default interval. See Time Interval Settings for more information on time settings.

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

    • When in edit mode, you can also:

      • 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 and edit the query to meet your needs, 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 try modifying it. You can also click the three dots on the widget and select Edit in Search view, as explained in Editing an Existing Widget.

      • Labels — add or edit the labels assigned to a dashboard.

    • When in edit mode, you can also drag and drop widgets to the required position, or edit them — for details, see Editing an Existing Widget.

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

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:

humio
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 the 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 Managing Dashboard Parameters.

Time Interval Settings

You can set the desired time interval for a dashboard, or make it running live, with the buttons on the top right of a dashboard:

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

    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 Expanding Time Frame.

    4. Click Apply to confirm your choice.

    Time Interval Settings

    Figure 97. Time Interval Settings


    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.

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