Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] [Lens] 7.9 docs refresh #72301

Merged
merged 3 commits into from
Jul 29, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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 modified docs/visualize/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/visualize/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 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 modified docs/visualize/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/visualize/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/visualize/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 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.
Binary file modified docs/visualize/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/visualize/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.
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