diff --git a/docs/images/controls/controls_in_dashboard.png b/docs/images/controls/controls_in_dashboard.png deleted file mode 100644 index 5ea6b3ad0ca88a..00000000000000 Binary files a/docs/images/controls/controls_in_dashboard.png and /dev/null differ diff --git a/docs/images/dashboard-controls.png b/docs/images/dashboard-controls.png new file mode 100644 index 00000000000000..d121ce561e341b Binary files /dev/null and b/docs/images/dashboard-controls.png differ diff --git a/docs/images/markdown-example.png b/docs/images/markdown-example.png new file mode 100644 index 00000000000000..79daa1298883dd Binary files /dev/null and b/docs/images/markdown-example.png differ diff --git a/docs/images/markdown_example_1.png b/docs/images/markdown_example_1.png new file mode 100644 index 00000000000000..71dd9b76b8cafd Binary files /dev/null and b/docs/images/markdown_example_1.png differ diff --git a/docs/images/markdown_example_2.png b/docs/images/markdown_example_2.png new file mode 100644 index 00000000000000..f2094c3cbb3f1b Binary files /dev/null and b/docs/images/markdown_example_2.png differ diff --git a/docs/images/markdown_example_3.png b/docs/images/markdown_example_3.png new file mode 100644 index 00000000000000..eca9735b495d0f Binary files /dev/null and b/docs/images/markdown_example_3.png differ diff --git a/docs/images/markdown_example_4.png b/docs/images/markdown_example_4.png new file mode 100644 index 00000000000000..d4a0829fef64e7 Binary files /dev/null and b/docs/images/markdown_example_4.png differ diff --git a/docs/user/visualize.asciidoc b/docs/user/visualize.asciidoc index 5692fe6d1ae01d..1bcbd51a9629ae 100644 --- a/docs/user/visualize.asciidoc +++ b/docs/user/visualize.asciidoc @@ -53,9 +53,9 @@ data sets. * *<>* [horizontal] -<>:: Provides the ability to add interactive inputs to a Dashboard. +Controls:: Adds interactive inputs to a Dashboard. -<>:: Display free-form information or instructions. +Markdown widget:: Display free-form information or instructions. * *For developers* [horizontal] diff --git a/docs/visualize/for-dashboard.asciidoc b/docs/visualize/for-dashboard.asciidoc index a197998ecdc9de..d6e39d35b7b23f 100644 --- a/docs/visualize/for-dashboard.asciidoc +++ b/docs/visualize/for-dashboard.asciidoc @@ -1,117 +1,51 @@ [[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 +== Dashboard tools +Visualize comes with controls and Markdown tools that you can add to dashboards for an interactive experience. [float] [[controls]] -=== Controls widget +=== Controls experimental[] -The Controls widget enables you to add interactive inputs -to a dashboard. You can create two types of inputs: +The controls tool enables you to add interactive inputs +on a dashboard. -* Dropdown menu -* Radio slider +You can add two types of interactive inputs: -[role="screenshot"] -image::images/controls/controls_in_dashboard.png[] +* *Options list* - Filters content based on one or more specified options. The dropdown menu is dynamically populated with the results of a terms aggregation. For example, use the options list on the sample flight dashboard when you want to filter the data by origin city and destination city. -[float] -[[add-input-controls]] -=== Add input controls - -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. - -[float] -==== 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. +* *Range slider* - Filters data within a specified range of numbers. The minimum and maximum values are dynamically populated with the results of a min and max aggregation. For example, use the range slider when you want to filter the sample flight dashboard by a specific average ticket price. [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 <> 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. +image::images/dashboard-controls.png[] [float] -==== Range slider +[[markdown-widget]] +=== Markdown -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. +The Markdown tool is a text entry field that accepts GitHub-flavored Markdown text. When you enter the text, the tool populates the results on the dashboard. -[role="screenshot"] -image::images/controls/range_slider_editor.png[] +Markdown is helpful when you want to include important information, instructions, and images on your dashboard. -*Control Label*:: The label for the range slider. By default, the -label is the field name. +For information about GitHub-flavored Markdown text, click *Help*. -*Index Pattern*:: The <> that contains -the data set to visualize. +For example, when you enter: -*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. +[role="screenshot"] +image::images/markdown_example_1.png[] -*Decimal Places*:: The number of decimal places. +The following instructions are displayed: -[float] -[[global-options]] -=== Global options +[role="screenshot"] +image::images/markdown_example_2.png[] -Open the *Options* tab to configure settings that apply to all input -controls in a Controls visualization. +Or when you enter: [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[]. +image::images/markdown_example_3.png[] -*Use time filter*:: When enabled, the aggregations used to generate -the dropdown options list and range minimum and maximum are bound -to <>. +The following image is displayed: -*Pin filters to global state*:: When enabled, all filters created by -interacting with the inputs are automatically pinned. +[role="screenshot"] +image::images/markdown_example_4.png[] diff --git a/docs/visualize/most-frequent.asciidoc b/docs/visualize/most-frequent.asciidoc index 2cb8aa7cb3c1fb..ba291e3cc6859a 100644 --- a/docs/visualize/most-frequent.asciidoc +++ b/docs/visualize/most-frequent.asciidoc @@ -11,6 +11,8 @@ The most frequently used visualizations include: * Metric, goal, and gauge * Tag cloud +[[metric-chart]] + [float] [[frequently-used-viz-aggregation]] === Supported aggregations