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. With Lens, 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.
  • 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.

lens drag 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.

Filter the data panel fieldsedit

The fields in the data panel based on your selected index pattern, and the 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 in the time range.

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

lens data info

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.

lens 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

Lens allows some customizations of the data for each visualization.

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

Add layers and indicesedit

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.

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.

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. Open Lens.
  2. Select the kibana_sample_data_ecommerce index pattern.
  3. Click time filter calendar, then click Last 7 days.

    The fields in the data panel update.

  4. 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.

    1. Change the Label to Sales.
  2. Click Top values of category.keyword.

    1. Change Number of values to 10. 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.

  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.