2019-11-21 20:57:21 +01:00
|
|
|
[[for-dashboard]]
|
|
|
|
== Markdown and controls
|
|
|
|
|
|
|
|
[float]
|
|
|
|
[[markdown-widget]]
|
|
|
|
=== Markdown widget
|
|
|
|
|
|
|
|
The Markdown widget is a text entry field that accepts GitHub-flavored Markdown text. Kibana renders the text you enter
|
|
|
|
in this field and displays the results on the dashboard. You can click the *Help* link to go to the
|
|
|
|
https://help.github.com/articles/github-flavored-markdown/[help page] for GitHub flavored Markdown. From the widget
|
|
|
|
you can:
|
|
|
|
|
|
|
|
* Click *Apply* to display the rendered text in the Preview panel
|
|
|
|
* Click *Discard* to revert to a previously saved version
|
|
|
|
|
|
|
|
|
|
|
|
[float]
|
2018-05-29 20:31:19 +02:00
|
|
|
[[controls]]
|
2019-11-21 20:57:21 +01:00
|
|
|
=== Controls widget
|
2018-05-29 20:31:19 +02:00
|
|
|
experimental[]
|
|
|
|
|
2019-11-21 20:57:21 +01:00
|
|
|
The Controls widget enables you to add interactive inputs
|
|
|
|
to a dashboard. You can create two types of inputs:
|
2018-05-29 20:31:19 +02:00
|
|
|
|
2019-11-21 20:57:21 +01:00
|
|
|
* Dropdown menu
|
|
|
|
* Radio slider
|
2018-05-29 20:31:19 +02:00
|
|
|
|
|
|
|
[role="screenshot"]
|
|
|
|
image::images/controls/controls_in_dashboard.png[]
|
|
|
|
|
2019-11-21 20:57:21 +01:00
|
|
|
[float]
|
2018-05-29 20:31:19 +02:00
|
|
|
[[add-input-controls]]
|
2019-11-21 20:57:21 +01:00
|
|
|
=== Add input controls
|
2018-05-29 20:31:19 +02:00
|
|
|
|
|
|
|
To start a *Controls* visualization, open the Visualization application
|
|
|
|
and click the *+* button. Scroll to the *Others* section and
|
|
|
|
select *Controls*.
|
|
|
|
|
|
|
|
In the visualization builder, choose the type of control to add to
|
|
|
|
your visualization.
|
|
|
|
|
2019-11-21 20:57:21 +01:00
|
|
|
[float]
|
2018-05-29 20:31:19 +02:00
|
|
|
==== Dropdown menu
|
|
|
|
|
|
|
|
A dropdown menu allows users to filter content by selecting
|
|
|
|
one or more options from a list. The dropdown menu is dynamically populated
|
|
|
|
with the results of a terms aggregation.
|
|
|
|
|
|
|
|
[role="screenshot"]
|
|
|
|
image::images/controls/dropdown_control_editor.png[]
|
|
|
|
|
|
|
|
*Control Label*:: The label for the dropdown menu. By default, the
|
|
|
|
label is the field name.
|
|
|
|
|
|
|
|
*Index Pattern*:: The <<index-patterns,index pattern>> that contains
|
|
|
|
the data set to visualize.
|
|
|
|
|
|
|
|
*Field*:: The field used to populate the list of options
|
|
|
|
and filter on when users interact with the input.
|
|
|
|
The list of available fields is derived from the specified
|
|
|
|
index pattern.
|
|
|
|
|
|
|
|
*Parent control*:: The control for chaining dropdown menus so that the
|
|
|
|
selection in the first menu
|
|
|
|
filters the terms in the second menu. Only available when
|
|
|
|
creating multiple dropdown menus.
|
|
|
|
|
|
|
|
*Multiselect*:: When enabled, the dropdown menu allows users to select multiple options.
|
|
|
|
|
|
|
|
*Size*:: The number of options to include in the list.
|
|
|
|
|
2019-11-21 20:57:21 +01:00
|
|
|
[float]
|
2018-05-29 20:31:19 +02:00
|
|
|
==== Range slider
|
|
|
|
|
|
|
|
A range sliders allow users to filter content within a range of numbers.
|
|
|
|
The range slider minimum and maximum values are dynamically populated with
|
|
|
|
the results of a min and max aggregation.
|
|
|
|
|
|
|
|
[role="screenshot"]
|
|
|
|
image::images/controls/range_slider_editor.png[]
|
|
|
|
|
|
|
|
*Control Label*:: The label for the range slider. By default, the
|
|
|
|
label is the field name.
|
|
|
|
|
|
|
|
*Index Pattern*:: The <<index-patterns,index pattern>> that contains
|
|
|
|
the data set to visualize.
|
|
|
|
|
|
|
|
*Field*:: The field used to populate the range slider
|
|
|
|
and filter on when users interact with the input.
|
|
|
|
The list of available fields is derived from the
|
|
|
|
specified index pattern.
|
|
|
|
|
|
|
|
*Step Size*:: The increment/decrement size of the slider.
|
|
|
|
|
|
|
|
*Decimal Places*:: The number of decimal places.
|
|
|
|
|
2019-11-21 20:57:21 +01:00
|
|
|
[float]
|
2018-05-29 20:31:19 +02:00
|
|
|
[[global-options]]
|
2019-11-21 20:57:21 +01:00
|
|
|
=== Global options
|
2018-05-29 20:31:19 +02:00
|
|
|
|
|
|
|
Open the *Options* tab to configure settings that apply to all input
|
|
|
|
controls in a Controls visualization.
|
|
|
|
|
|
|
|
[role="screenshot"]
|
|
|
|
image::images/controls/controls_options.png[]
|
|
|
|
|
|
|
|
*Update Kibana filters on each change*:: When enabled, all input interactions
|
|
|
|
immediately create filters that cause the dashboard to refresh. When disabled,
|
|
|
|
Kibana filters are only created
|
|
|
|
when the user clicks *Apply changes* image:images/apply-changes-button.png[].
|
|
|
|
|
|
|
|
*Use time filter*:: When enabled, the aggregations used to generate
|
|
|
|
the dropdown options list and range minimum and maximum are bound
|
|
|
|
to <<set-time-filter,Kibana's global time range>>.
|
|
|
|
|
|
|
|
*Pin filters to global state*:: When enabled, all filters created by
|
|
|
|
interacting with the inputs are automatically pinned.
|