Filter dashboard data with controls

edit

Controls are interactive panels you add to your dashboards to filter and display only the data you want to explore.

There are three types of controls:

  • Options list — Adds a dropdown that allows you to filter the data with one or more options that you select.

    For example, if you are using the [Logs] Web Traffic dashboard from the sample web logs data, you can add an options list for the machine.os.keyword field that allows you to display only the logs generated from osx and ios operating systems.

    Options list control for the `machine.os.keyword` field with the `osx` and `ios` options selected
  • Range slider — Adds a slider that allows you to filter the data within a specified range of values.

    For example, if you are using the [Logs] Web Traffic dashboard from the sample web logs data, you can add a range slider for the hour_of_day field that allows you to display only the log data from 9:00AM to 5:00PM.

    Range slider control for the `hour_of_day` field with a range of `9` to `17` selected
  • Time slider — Adds a time range slider that allows you to filter the data within a specified range of time, advance the time range backward and forward, and animate your change in data over the specified time range.

    For example, you are using the [Logs] Web Traffic dashboard from the sample web logs data, and the global time filter is Last 7 days. When you add the time slider, you can click the previous and next buttons to advance the time range backward or forward, and click the play button to watch how the data changes over the last 7 days.

    Time slider control for the the Last 7 days

Create and add Options list and Range slider controls

edit

To add interactive Options list and Range slider controls, create the controls, then add them to your dashboard.

  1. Open or create a new dashboard.

    • If you are adding a Control to an existing dashboard, click Edit, click Controls in the dashboard toolbar, then select Add control.
    • If you are adding a Control to a new dashboard, click Controls in the dashboard toolbar, then select Add control.
  2. From the Data view dropdown, select the data view with the field you want to appear in the Control.
  3. In the Field list, select the field with the documents you want to filter.

    The Control type is automatically applied for the field you selected.

  4. In the Label field, enter a clear and self-explanatory label.
  5. Select the control width:

    • To specify the control size, select the Minimum width.
    • To expand the width of the control to fit the available space on the dashboard, select Expand width to fit available space.
  6. If you are creating an Options list, specify the additional settings:

    • To allow multiple options to be selected in the dropdown, select Allow multiple selections in dropdown.
    • To allow options to be inlcluded or excluded on the dashboard, select Allow selections to be excluded.
    • To allow an exists query to be created, select Allow exists query.
    • To populate the entire list of options, even when the list takes longer to populate than expected, select Ignore timeout for results.
  7. Click Save and close.

Add time slider controls

edit

To add interactive time slider controls, create the control, then add it to your dashboard.

  1. Open or create a new dashboard.
  2. In the dashboard toolbar, click Controls, then select Add time slider control.
  3. The time slider control uses the time range from the global time filter. To change the time range in the time slider control, change the global time filter.
  4. Save the dashboard.

Filter the data with Options list controls

edit

Filter the data with one or more options that you select.

  1. Open the Options list dropdown.
  2. Select the available options.

    The Exists query returns all documents that contain an indexed value for the field.

  3. Select how to filter the options.

    • To display only the data for the options you selected, click Include.
    • To exclude the data for the options you selected, click Exclude.
  4. To clear the selections, click The icon to clear all selected options in the Options list.
  5. To display only the options you selected in the dropdown, click The icon to display only the options you have selected in the Options list.

Filter the data with Range slider controls

edit

Filter the data within a specified range of values.

  1. On the Range slider, click a value.
  2. Move the sliders to specify the values you want to display.

    The dashboard displays only the data for the range of values you specified.

  3. To clear the specified values, click The icon to clear all specified values in the Range slider.

Filter the data with time slider controls

edit

Filter the data within a specified range of time.

  1. To view a different time range, click the time slider, then move the sliders to specify the time range you want to display.
  2. To advance the time range forward, click The icon to advance the time range forward.
  3. To advance the time range backward, click The icon to advance the time range backward.
  4. To animate the data changes over time, click The icon to clear all specified values in the Range slider.
  5. To clear the specified values, click The icon to clear all specified values in the Range slider.

Configure the controls settings

edit
  1. In the dashboard toolbar, click Controls, then select Settings.
  2. On the Control settings flyout, configure the settings:

    • Label position — Specifies where the label appears on the control.
    • Validate user selections — When selected, any selected option that results in no data is ignored.
    • Chain controls — When selected, any selected options in one control narrows the available options in the next control.
    • To remove all controls from the dashboard, click Delete all.
  3. Click Save and close.

Edit Options list and Range slider control settings

edit

Change the settings for the Options list and Range slider controls.

  1. Hover over the control you want to edit, then click The Edit control icon that opens the Edit control flyout.
  2. On the Edit control flyout, change the options, then click Save and close.

Remove controls

edit

Remove controls from your dashboard.

  1. Hover over the control you want to remove, then click The Remove control icon that removes the control from the dashboard.
  2. On the Delete control? window, click Delete.