This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.

Lens is a simple and fast way to create visualizations of your Elasticsearch 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:

  • Use the automatically generated visualization suggestions to change the visualization type.
  • Create visualizations with multiple layers and indices.
  • Add your visualizations to dashboards and Canvas workpads.

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

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.

Drag-and-drop capabilities are available only when Lens knows how to use the data. If Lens is unable to automatically generate a visualization, you can still configure the customization options for your visualization.

Change the data panel fieldsedit

The fields in the data panel are based on the selected index pattern and time filter.

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

To filter the fields in the data panel:

  • Enter the name in Search field names.
  • Click Filter by type, then select the filter. To show all of the fields in the index pattern, deselect Only show fields with data.

Data summariesedit

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.

Data summary window

Change the visualization typeedit

Lens enables you to switch between any supported visualization type at any time.

Suggestions are shortcuts to alternate visualizations that Lens generates for you.

Visualization suggestions

If you’d like to use a visualization type that is not suggested, click the visualization type, then select a new one.

lens viz types

When there is an exclamation point (!) next to a visualization type, Lens is unable to transfer your data, but still allows you to make the change.

Change the aggregation and labelsedit

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

  1. Click Drop a field here or the field name in the column.
  2. Change the options that appear. Options vary depending on the type of field.

    Quick function options

Add layers and indicesedit

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.

Add layers

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

Add index pattern

Lens tutorialedit

Ready to create your own visualization with Lens? Use the following tutorial to create a visualization that lets you compare sales over time.

Before you beginedit

To start, you’ll need to add the sample ecommerce data.

Build the visualizationedit

Drag and drop your data onto the visualization builder pane.

  1. Select the kibana_sample_data_ecommerce index pattern.
  2. Click time filter calendar, then click Last 7 days.

    The fields in the data panel update.

  3. Drag and drop the taxful_total_price data field to the visualization builder pane.

    Lens tutorial

To display the average order prices over time, Lens automatically added in order_date field.

To break down your data, drag the category.keyword field to the visualization builder pane. Lens knows that you want to show the top categories and compare them across the dates, and creates a chart that compares the sales for each of the top three categories:

Lens tutorial

Customize your visualizationedit

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

  1. Click Average of taxful_total_price, then change the Label to Sales.

    Lens tutorial
  2. Click Top values of category.keyword, then change Number of values to 10.

    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 the sales data, a stacked area chart might be the best option.

  3. To switch the chart type, click Stacked bar chart in the column, then click Stacked area from the Select a visualizations window.

    Lens tutorial

Next stepsedit

Now that you’ve created your visualization, you can add it to a dashboard or Canvas workpad.

For more information, refer to Dashboard or Canvas.