[DOCS] Adds the 8.6 Presentation docs (#145474)
## Summary Adds the docs for the following: - #141824 Doc preview: https://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/get-started.html - #142780 Doc preview: https://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/add-controls.html - #143762 Doc preview: https://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/add-controls.html Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
|
@ -44,11 +44,11 @@ Customize your data by connecting it to the Sample eCommerce orders data.
|
|||
|
||||
. Click *Add element > Chart > Metric*.
|
||||
+
|
||||
By default, the element is connected to the demo data, which enables you to experiment with the element before you connect it to your own data source.
|
||||
By default, the element is connected to the demo data, which enables you to experiment with the element before you connect it to your own.
|
||||
|
||||
. To connect the element to your own data source, make sure that the element is selected, click *Data > Demo data > Elasticsearch SQL*.
|
||||
. To connect the element to your own data, make sure the element is selected, then click *Data > Demo data > Elasticsearch SQL*.
|
||||
|
||||
.. In the *Query* field, enter:
|
||||
.. To select the total price field and set it to the sum_total_price field, enter the following in the *Query* field:
|
||||
+
|
||||
[source,text]
|
||||
--
|
||||
|
@ -57,13 +57,13 @@ SELECT sum(taxless_total_price) AS sum_total_price FROM "kibana_sample_data_ecom
|
|||
|
||||
.. Click *Save*.
|
||||
+
|
||||
The query selects the total price field and sets it to the sum_total_price field. All fields are pulled from the kibana_sample_data_ecommerce index.
|
||||
All fields are pulled from the sample eCommerce orders {data-source}.
|
||||
|
||||
. At this point, the element appears as an error, so you need to change the element display options.
|
||||
|
||||
.. Click *Display*
|
||||
|
||||
.. From the *Value* dropdowns, make sure *Unique* is selected, then select *sum_total_price*.
|
||||
.. From the *Value* dropdowns, make sure *Unique* and *sum_total_price* are selected.
|
||||
|
||||
.. Change the *Label* to `Total sales`.
|
||||
|
||||
|
@ -102,9 +102,9 @@ SELECT order_date, taxless_total_price FROM "kibana_sample_data_ecommerce" ORDER
|
|||
|
||||
.. Click *Display*
|
||||
|
||||
.. From the *X-axis* drop-down lists, select *Value*, then select *order_date*.
|
||||
.. From the *X-axis* dropdown, make sure *Value* and *order_date* are selected.
|
||||
|
||||
.. From the *Y-axis* drop-down lists, select *Value*, then select *taxless_total_price*.
|
||||
.. From the *Y-axis* dropdown, select *Value*, then select *taxless_total_price*.
|
||||
|
||||
[role="screenshot"]
|
||||
image::images/canvas_tutorialCustomChart_7.17.0.png[Custom line chart added to the workpad using Elasticsearch SQL]
|
||||
|
|
Before Width: | Height: | Size: 974 KiB |
BIN
docs/getting-started/images/addData_sampleDataCards_8.6.0.png
Normal file
After Width: | Height: | Size: 120 KiB |
Before Width: | Height: | Size: 48 KiB |
BIN
docs/getting-started/images/addFilterOptions_dashboard_8.6.0.png
Normal file
After Width: | Height: | Size: 39 KiB |
Before Width: | Height: | Size: 42 KiB |
BIN
docs/getting-started/images/addFilter_dashboard_8.6.0.png
Normal file
After Width: | Height: | Size: 28 KiB |
Before Width: | Height: | Size: 412 KiB |
After Width: | Height: | Size: 248 KiB |
Before Width: | Height: | Size: 434 KiB |
After Width: | Height: | Size: 100 KiB |
Before Width: | Height: | Size: 460 KiB |
BIN
docs/getting-started/images/sampleDataFilter_dashboard_8.6.0.png
Normal file
After Width: | Height: | Size: 88 KiB |
|
@ -33,7 +33,7 @@ Sample data sets come with sample visualizations, dashboards, and more to help y
|
|||
. On the *Sample eCommerce orders* card, click *Add data*.
|
||||
+
|
||||
[role="screenshot"]
|
||||
image::images/addData_sampleDataCards_8.4.0.png[Add data UI for the sample data sets]
|
||||
image::images/addData_sampleDataCards_8.6.0.png[Add data UI for the sample data sets]
|
||||
|
||||
[float]
|
||||
[[explore-the-data]]
|
||||
|
@ -72,7 +72,7 @@ A dashboard is a collection of panels that you can use to visualize the data. Pa
|
|||
. Click *[eCommerce] Revenue Dashboard*.
|
||||
+
|
||||
[role="screenshot"]
|
||||
image::images/dashboard_ecommerceRevenueDashboard_7.15.0.png[The [eCommerce] Revenue Dashboard that comes with the Sample eCommerce order data set]
|
||||
image::images/dashboard_ecommerceRevenueDashboard_8.6.0.png[The [eCommerce] Revenue Dashboard that comes with the Sample eCommerce order data set]
|
||||
|
||||
[float]
|
||||
[[create-a-visualization]]
|
||||
|
@ -115,7 +115,7 @@ You can interact with the dashboard data using controls that allow you to apply
|
|||
. Click *Apply changes*.
|
||||
+
|
||||
[role="screenshot"]
|
||||
image::images/sampleDataFilter_dashboard_8.4.0.png[The [eCommerce] Revenue Dashboard that shows only the women's clothing data from the Gnomehouse manufacturer]
|
||||
image::images/sampleDataFilter_dashboard_8.6.0.png[The [eCommerce] Revenue Dashboard that shows only the women's clothing data from the Gnomehouse manufacturer]
|
||||
|
||||
[float]
|
||||
[[filter-and-query-the-data]]
|
||||
|
@ -126,7 +126,7 @@ To view a subset of the data, you can apply filters to the dashboard data. Apply
|
|||
. Click *Add filter*.
|
||||
+
|
||||
[role="screenshot"]
|
||||
image::images/addFilter_dashboard_8.4.0.png[The Add filter action that applies dashboard-level filters]
|
||||
image::images/addFilter_dashboard_8.6.0.png[The Add filter action that applies dashboard-level filters]
|
||||
|
||||
. From the *Field* dropdown, select *day_of_week*.
|
||||
|
||||
|
@ -135,12 +135,12 @@ image::images/addFilter_dashboard_8.4.0.png[The Add filter action that applies d
|
|||
. From the *Value* dropdown, select *Wednesday*.
|
||||
+
|
||||
[role="screenshot"]
|
||||
image::images/addFilterOptions_dashboard_8.4.0.png[The Add filter options configured to display only the women's clothing data generated on Wednesday from the Gnomehouse manufacturer]
|
||||
image::images/addFilterOptions_dashboard_8.6.0.png[The Add filter options configured to display only the women's clothing data generated on Wednesday from the Gnomehouse manufacturer]
|
||||
|
||||
. Click *Add filter*.
|
||||
+
|
||||
[role="screenshot"]
|
||||
image::images/dashboard_sampleDataAddFilter_8.4.0.png[The [eCommerce] Revenue Dashboard that shows only the women's clothing data generated on Wednesday from the Gnomehouse manufacturer]
|
||||
image::images/dashboard_sampleDataAddFilter_8.6.0.png[The [eCommerce] Revenue Dashboard that shows only the women's clothing data generated on Wednesday from the Gnomehouse manufacturer]
|
||||
|
||||
[float]
|
||||
[[quick-start-whats-next]]
|
||||
|
|
|
@ -51,7 +51,7 @@ To open *Canvas*, open the main menu, then click *Canvas*.
|
|||
|
||||
To use the background colors, images, and data of your choice, start with a blank workpad.
|
||||
|
||||
. On the *Canvas workpads* page, click *Create workpad*.
|
||||
. On the *Canvas* page, click *Create workpad*.
|
||||
|
||||
. Specify the *Workpad settings*.
|
||||
|
||||
|
@ -67,7 +67,7 @@ To use the background colors, images, and data of your choice, start with a blan
|
|||
|
||||
If you're unsure about where to start, you can use one of the preconfigured templates that come with *Canvas*.
|
||||
|
||||
. On the *Canvas workpads* page, select *Templates*.
|
||||
. On the *Canvas* page, select *Templates*.
|
||||
|
||||
. Click the preconfigured template that you want to use.
|
||||
|
||||
|
@ -79,7 +79,7 @@ If you're unsure about where to start, you can use one of the preconfigured temp
|
|||
|
||||
When you want to use a workpad that someone else has already started, import the JSON file.
|
||||
|
||||
To begin, drag the file to the *Import workpad JSON file* field on the *Canvas workpads* page.
|
||||
On the *Canvas* page, drag the file to the *Import workpad JSON file* field.
|
||||
|
||||
[float]
|
||||
[[use-sample-data-workpads]]
|
||||
|
@ -87,9 +87,9 @@ To begin, drag the file to the *Import workpad JSON file* field on the *Canvas w
|
|||
|
||||
Each of the {kib} sample data sets comes with a workpad that you can use for your own workpad inspiration.
|
||||
|
||||
. Add a {kibana-ref}/add-sample-data.html[sample data set].
|
||||
. Add a <<gs-get-data-into-kibana,sample data set>>.
|
||||
|
||||
. On the *Add Data* page, click *View data*, then select *Canvas*.
|
||||
. On a sample data card, click *View data*, then select *Canvas*.
|
||||
|
||||
[float]
|
||||
[[add-canvas-elements]]
|
||||
|
@ -106,16 +106,16 @@ By default, most of the elements you create use the demo data until you change t
|
|||
|
||||
. Click *Add element*, then select the element you want to use.
|
||||
|
||||
. To connect the element to your data, select *Data*, then select one of the following data sources:
|
||||
. To connect the element to your data, select *Data > Demo data*, then select one of the following data sources:
|
||||
|
||||
* *{es} SQL* — Access your data in {es} using {ref}/sql-spec.html[SQL syntax].
|
||||
|
||||
* *{es} documents* — Access your data in {es} without using aggregations. To use, select an index and fields, and optionally enter a query using the <<lucene-query,Lucene Query Syntax>>.
|
||||
Use the *{es} documents* data source when you have low volume datasets, to view raw documents, or to plot exact, non-aggregated values on a chart.
|
||||
* *{es} documents* — Access your data in {es} without using aggregations. To use, select a {data-source} and fields.
|
||||
Use *{es} documents* when you have low-volume datasets, and you want to view raw documents or to plot exact, non-aggregated values on a chart.
|
||||
|
||||
* *Timelion* — Access your time series data using <<timelion,*Timelion*>> queries. To use *Timelion* queries, you can enter a query using the <<lucene-query,Lucene Query Syntax>>.
|
||||
+
|
||||
Each element can display a different data source, and pages and workpads often contain multiple data sources.
|
||||
Each element can display a different {data-source}, and pages and workpads often contain multiple {data-sources}.
|
||||
|
||||
. To save, use the following options:
|
||||
|
||||
|
|
Before Width: | Height: | Size: 39 KiB |
After Width: | Height: | Size: 34 KiB |
|
@ -35,7 +35,7 @@ There are three types of controls:
|
|||
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.
|
||||
+
|
||||
[role="screenshot"]
|
||||
image::images/dashboard_controlsOptionsList_8.3.0.png[Options list control for the `machine.os.keyword` field with the `osx` and `ios` options selected]
|
||||
image::images/dashboard_controlsOptionsList_8.6.0.png[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.
|
||||
+
|
||||
|
@ -76,11 +76,15 @@ The *Control type* is automatically applied for the field you selected.
|
|||
|
||||
* To expand the width of the control to fit the available space on the dashboard, select *Expand width to fit available space*.
|
||||
|
||||
. If you are creating an *Options list*, specify the options.
|
||||
. If you are creating an *Options list*, specify the additional settings:
|
||||
|
||||
.. To allow users to select multiple options, select *Allow multiple selections in dropdown*.
|
||||
* To allow multiple options to be selected in the dropdown, select *Allow multiple selections in dropdown*.
|
||||
|
||||
.. To populate the entire list of options, even when the Options list takes longer to populate than expected, select *Run past timeout*.
|
||||
* 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*.
|
||||
|
||||
. Click *Save and close*.
|
||||
|
||||
|
@ -105,11 +109,17 @@ Filter the data with one or more options that you select.
|
|||
|
||||
. Open the Options list dropdown.
|
||||
|
||||
. Select the options for the data you want to display on the dashboard.
|
||||
. Select the available options.
|
||||
+
|
||||
The dashboard displays only the data for the options you selected.
|
||||
The *Exists* query returns all documents that contain an indexed value for the field.
|
||||
|
||||
. To clear the selection, click image:images/dashboard_controlsClearSelections_8.3.0.png[The icon to clear all selected options in the Options list].
|
||||
. 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*.
|
||||
|
||||
. To clear the selections, click image:images/dashboard_controlsClearSelections_8.3.0.png[The icon to clear all selected options in the Options list].
|
||||
|
||||
. To display only the options you selected in the dropdown, click image:images/dashboard_showOnlySelectedOptions_8.3.0.png[The icon to display only the options you have selected in the Options list].
|
||||
|
||||
|
|