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 two 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

Create and add controls

edit

To add interactive filters, create 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 options.

    1. To allow users to select multiple options, select Allow multiple selections in dropdown.
    2. To populate the entire list of options, even when the Options list takes longer to populate than expected, select Run past timeout.
  7. Click Save and close.

Filter the data with Options lists

edit

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

  1. Open the Options list dropdown.
  2. Select the options for the data you want to display on the dashboard.

    The dashboard displays only the data for the options you selected.

  3. To clear the selection, click The icon to clear all selected options in the Options list.
  4. 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 sliders

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.

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 controls

edit

Change the settings for a control.

  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.