[8.6] [DOCS] Adds the 8.6 Presentation docs (#145474) (#146430)

# Backport

This will backport the following commits from `main` to `8.6`:
- [[DOCS] Adds the 8.6 Presentation docs
(#145474)](https://github.com/elastic/kibana/pull/145474)

<!--- Backport version: 8.9.7 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Kaarina
Tungseth","email":"kaarina.tungseth@elastic.co"},"sourceCommit":{"committedDate":"2022-11-28T16:20:38Z","message":"[DOCS]
Adds the 8.6 Presentation docs (#145474)\n\n## Summary\r\n\r\nAdds the
docs for the following:\r\n\r\n- #141824\r\nDoc
preview:\r\nhttps://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/get-started.html\r\n\r\n-
#142780\r\nDoc
preview:\r\nhttps://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/add-controls.html\r\n\r\n-
#143762\r\nDoc
preview:\r\nhttps://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/add-controls.html\r\n\r\nCo-authored-by:
gchaps
<33642766+gchaps@users.noreply.github.com>","sha":"9a26af6facafa9519ac624901805a1a65c8abb09","branchLabelMapping":{"^v8.7.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","Team:Presentation","release_note:skip","v8.6.0","v8.7.0"],"number":145474,"url":"https://github.com/elastic/kibana/pull/145474","mergeCommit":{"message":"[DOCS]
Adds the 8.6 Presentation docs (#145474)\n\n## Summary\r\n\r\nAdds the
docs for the following:\r\n\r\n- #141824\r\nDoc
preview:\r\nhttps://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/get-started.html\r\n\r\n-
#142780\r\nDoc
preview:\r\nhttps://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/add-controls.html\r\n\r\n-
#143762\r\nDoc
preview:\r\nhttps://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/add-controls.html\r\n\r\nCo-authored-by:
gchaps
<33642766+gchaps@users.noreply.github.com>","sha":"9a26af6facafa9519ac624901805a1a65c8abb09"}},"sourceBranch":"main","suggestedTargetBranches":["8.6"],"targetPullRequestStates":[{"branch":"8.6","label":"v8.6.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v8.7.0","labelRegex":"^v8.7.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/145474","number":145474,"mergeCommit":{"message":"[DOCS]
Adds the 8.6 Presentation docs (#145474)\n\n## Summary\r\n\r\nAdds the
docs for the following:\r\n\r\n- #141824\r\nDoc
preview:\r\nhttps://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/get-started.html\r\n\r\n-
#142780\r\nDoc
preview:\r\nhttps://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/add-controls.html\r\n\r\n-
#143762\r\nDoc
preview:\r\nhttps://kibana_145474.docs-preview.app.elstc.co/guide/en/kibana/master/add-controls.html\r\n\r\nCo-authored-by:
gchaps
<33642766+gchaps@users.noreply.github.com>","sha":"9a26af6facafa9519ac624901805a1a65c8abb09"}}]}]
BACKPORT-->

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>
This commit is contained in:
Kibana Machine 2022-11-28 11:39:23 -05:00 committed by GitHub
parent e6c75cd1cd
commit dad6bffc67
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
18 changed files with 39 additions and 29 deletions

View file

@ -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]

Binary file not shown.

Before

Width:  |  Height:  |  Size: 974 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 120 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 412 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 248 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 434 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 100 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 460 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

View file

@ -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]]

View file

@ -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* &mdash; Access your data in {es} using {ref}/sql-spec.html[SQL syntax].
* *{es} documents* &mdash; 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* &mdash; 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* &mdash; 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:

Binary file not shown.

Before

Width:  |  Height:  |  Size: 39 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

View file

@ -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* &mdash; 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].