Skip to content

Commit

Permalink
[DOCS] [Lens] 7.9 docs refresh (#72301) (#73691)
Browse files Browse the repository at this point in the history
* [DOCS] Lens refresh for 7.9

* Clean up

* Review comments from Wylie
  • Loading branch information
KOTungseth authored Jul 29, 2020
1 parent 5121cb7 commit e33f18e
Show file tree
Hide file tree
Showing 13 changed files with 35 additions and 25 deletions.
Binary file modified docs/images/lens_data_info.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/lens_drag_drop.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/lens_suggestions.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/lens_tutorial_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/lens_tutorial_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/lens_tutorial_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/lens_viz_types.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/visualize/images/lens_aggregation_labels.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/visualize/images/lens_index_pattern.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/visualize/images/lens_layers.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/visualize/images/lens_tutorial_3.1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/visualize/images/lens_tutorial_3.2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
60 changes: 35 additions & 25 deletions docs/visualize/lens.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,24 +4,22 @@

beta[]

*Lens* is a simple and fast way to create visualizations of your {es} data. With *Lens*,
*Lens* is a simple and fast way to create visualizations of your {es} data. To create visualizations,
you drag and drop your data fields onto the visualization builder pane, and *Lens* automatically generates
a visualization that best displays your data.

With Lens, you can:

* Explore your data in just a few clicks.
* Use the automatically generated visualization suggestions to change the visualization type.

* Create visualizations with multiple layers and indices.

* Use the automatically generated visualization suggestions to change the visualization type.

* Add your visualizations to dashboards and Canvas workpads.

To get started with *Lens*, click a field in the data panel, then drag and drop the field on a highlighted area.
To get started with *Lens*, select a field in the data panel, then drag and drop the field on a highlighted area.

[role="screenshot"]
image::images/lens_drag_drop.gif[]
image::images/lens_drag_drop.gif[Drag and drop]

You can incorporate many fields into your visualization, and Lens uses heuristics to decide how to apply each one to the visualization.

Expand All @@ -30,9 +28,9 @@ you can still configure the customization options for your visualization.

[float]
[[apply-lens-filters]]
==== Filter the data panel fields
==== Change the data panel fields

The fields in the data panel based on your selected <<index-patterns, index pattern>>, and the <<set-time-filter,time filter>>.
The fields in the data panel are based on the selected <<index-patterns, index pattern>> and <<set-time-filter,time filter>>.

To change the index pattern, click it, then select a new one. The fields in the data panel automatically update.

Expand All @@ -46,12 +44,12 @@ To filter the fields in the data panel:
[[view-data-summaries]]
==== Data summaries

To help you decide exactly the data you want to display, get a quick summary of each field. The summary shows the distribution of values in the time range.
To help you decide exactly the data you want to display, get a quick summary of each field. The summary shows the distribution of values within the selected time range.

To view the field summary information, navigate to the field, then click *i*.

[role="screenshot"]
image::images/lens_data_info.png[]
image::images/lens_data_info.png[Data summary window]

[float]
[[change-the-visualization-type]]
Expand All @@ -62,7 +60,7 @@ image::images/lens_data_info.png[]
*Suggestions* are shortcuts to alternate visualizations that *Lens* generates for you.

[role="screenshot"]
image::images/lens_suggestions.gif[]
image::images/lens_suggestions.gif[Visualization suggestions]

If you'd like to use a visualization type that is not suggested, click the visualization type,
then select a new one.
Expand All @@ -78,19 +76,30 @@ still allows you to make the change.
[[customize-operation]]
==== Change the aggregation and labels

Lens allows some customizations of the data for each visualization.
For each visualization, Lens allows some customizations of the data.

. Click *Drop a field here* or the field name in the column.

. Change the options that appear depending on the type of field.
. Change the options that appear. Options vary depending on the type of field.
+
[role="screenshot"]
image::images/lens_aggregation_labels.png[Quick function options]

[float]
[[layers]]
==== Add layers and indices

Bar, line, and area charts allow you to visualize multiple data layers and indices so that you can compare and analyze data from multiple sources.
Area, line, and bar charts allow you to visualize multiple data layers and indices so that you can compare and analyze data from multiple sources.

To add a layer, click *+*, then drag and drop the fields for the new layer.

[role="screenshot"]
image::images/lens_layers.png[Add layers]

To view a different index, click it, then select a new one.

To add a layer, click *+*, then drag and drop the fields for the new layer. To view a different index, click it, then select a new one.
[role="screenshot"]
image::images/lens_index_pattern.png[Add index pattern]

[float]
[[lens-tutorial]]
Expand All @@ -110,8 +119,6 @@ To start, you'll need to add the <<add-sample-data, sample ecommerce data>>.

Drag and drop your data onto the visualization builder pane.

. Open *Lens*.

. Select the *kibana_sample_data_ecommerce* index pattern.

. Click image:images/time-filter-calendar.png[], then click *Last 7 days*.
Expand All @@ -138,16 +145,19 @@ image::images/lens_tutorial_2.png[Lens tutorial]

Make your visualization look exactly how you want with the customization options.

. Click *Average of taxful_total_price*.

.. Change the *Label* to `Sales`.

. Click *Top values of category.keyword*.
. Click *Average of taxful_total_price*, then change the *Label* to `Sales`.
+
[role="screenshot"]
image::images/lens_tutorial_3.1.png[Lens tutorial]

.. Change *Number of values* to `10`. The visualization updates to show there are only
six available categories.
. Click *Top values of category.keyword*, then change *Number of values* to `10`.
+
[role="screenshot"]
image::images/lens_tutorial_3.2.png[Lens tutorial]
+
The visualization updates to show there are only six available categories.
+
Look at the *Suggestions*. An area chart is not an option, but for sales data, a stacked area chart might be the best option.
Look at the *Suggestions*. An area chart is not an option, but for the sales data, a stacked area chart might be the best option.

. To switch the chart type, click *Stacked bar chart* in the column, then click *Stacked area* from the *Select a visualizations* window.
+
Expand Down

0 comments on commit e33f18e

Please sign in to comment.