Skip to content

Commit

Permalink
[DOCS] Adds the 8.6 Presentation docs (elastic#145474)
Browse files Browse the repository at this point in the history
  • Loading branch information
KOTungseth and gchaps authored Nov 28, 2022
1 parent ff98314 commit 9a26af6
Show file tree
Hide file tree
Showing 18 changed files with 39 additions and 29 deletions.
14 changes: 7 additions & 7 deletions docs/canvas/canvas-tutorial.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -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]
--
Expand All @@ -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`.

Expand Down Expand Up @@ -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]
Expand Down
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 6 additions & 6 deletions docs/getting-started/quick-start-guide.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -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]]
Expand Down Expand Up @@ -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]]
Expand Down Expand Up @@ -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]]
Expand All @@ -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*.

Expand All @@ -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]]
Expand Down
18 changes: 9 additions & 9 deletions docs/user/canvas.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -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*.

Expand All @@ -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.

Expand All @@ -79,17 +79,17 @@ 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]]
=== Use sample data workpads

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]]
Expand All @@ -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:

Expand Down
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 17 additions & 7 deletions docs/user/dashboard/make-dashboards-interactive.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
+
Expand Down Expand Up @@ -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*.

Expand All @@ -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.

. 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 selection, click image:images/dashboard_controlsClearSelections_8.3.0.png[The icon to clear all selected options in the Options list].
. 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].

Expand Down

0 comments on commit 9a26af6

Please sign in to comment.