diff --git a/docs/user/dashboard/aggregation-based.asciidoc b/docs/user/dashboard/aggregation-based.asciidoc index 4ca251b3a1936..7d5e4f93bba88 100644 --- a/docs/user/dashboard/aggregation-based.asciidoc +++ b/docs/user/dashboard/aggregation-based.asciidoc @@ -191,6 +191,29 @@ TIP: Aggregation-based panels support a maximum of three *Split series*. [role="screenshot"] image:images/aggBased_barChartTutorial2_8.4.png[Bar chart with sample logs data] +[float] +[[edit-agg-based-visualizations-in-lens]] +==== Open and edit aggregation-based visualizations in Lens + +When you open aggregation-based visualizations in *Lens*, all configuration options appear in the *Lens* visualization editor. + +You can open the following aggregation-based visualizations in *Lens*: + +* Area +* Data table +* Gauge +* Goal +* Heat map +* Horizontal bar +* Line +* Metric +* Pie +* Vertical bar + +To get started, click *Edit visualization in Lens* in the toolbar. + +For more information, check out <>. + [float] [[save-the-aggregation-based-panel]] ===== Save and add the panel diff --git a/docs/user/dashboard/images/lens_annotationDateIcon_8.6.0.png b/docs/user/dashboard/images/lens_annotationDateIcon_8.6.0.png new file mode 100644 index 0000000000000..c268d14b68d0e Binary files /dev/null and b/docs/user/dashboard/images/lens_annotationDateIcon_8.6.0.png differ diff --git a/docs/user/dashboard/lens.asciidoc b/docs/user/dashboard/lens.asciidoc index de23c3a9962e0..3467276ce236d 100644 --- a/docs/user/dashboard/lens.asciidoc +++ b/docs/user/dashboard/lens.asciidoc @@ -43,7 +43,7 @@ Edit and delete. . To delete a field, close the configuration options, then click *X* next to the field. -. To clone a layer, click image:dashboard/images/lens_layerActions_8.5.0.png[Actions menu to duplicate Lens visualization layers] in the layer pane, then select *Duplicate layer*. +. To duplicate a layer, click image:dashboard/images/lens_layerActions_8.5.0.png[Actions menu to duplicate Lens visualization layers] in the layer pane, then select *Duplicate layer*. . To clear the layer configuration, click image:dashboard/images/lens_layerActions_8.5.0.png[Actions menu to clear Lens visualization layers] in the layer pane, then select *Clear layer*. @@ -56,6 +56,8 @@ TIP: You can manually apply the changes you make, which is helpful when creating Change the fields list to display a different {data-source}, different time range, or add your own fields. * To create a visualization with fields in a different {data-source}, open the {data-source} dropdown, then select the {data-source}. ++ +For more information about {data-sources}, refer to <>. * If the fields list is empty, change the <>. @@ -192,24 +194,52 @@ Note: this option is not available for mosaic charts. preview::[] -Annotations allow you to call out specific points in your visualizations that are important, such as a major change in the data. You can add annotations for any {data-source}, add text and icons, specify the line format and color, and more. +Annotations allow you to call out specific points in your visualizations that are important, such as significant changes in the data. You can add annotations for any {data-source}, add text and icons, specify the line format and color, and more. [role="screenshot"] image::images/lens_annotations_8.2.0.png[Lens annotations] +Annotations support two placement types: + +* *Static date* — Displays annotations for specific times or time ranges. + +* *Custom query* — Displays annotations based on custom {es} queries. For detailed information about queries, check <>. + +Create the annotation layer. + . In the layer pane, click *Add layer > Annotations*. -. Select the {data-source}. +. Select the {data-source} for the annotation. + +. From the fields list, drag a field to the *Add an annotation* field. + +. To use global filters in the annotation, click image:dashboard/images/lens_layerActions_8.5.0.png[Actions menu for the annotations layer], then select *Keep global filters* from the dropdown. + +Create static annotations. -. To open the annotation options, click *Event*. +. Select *Static date*. -. Specify the *Annotation date*. +. In the *Annotation date* field, click image:images/lens_annotationDateIcon_8.6.0.png[Annodation date icon in Lens], then select the date. -. To display the annotation as a time range, select *Apply as range*, then specify the *From* and *To* time range. +. To display the annotation as a time range, select *Apply as range*, then specify the *From* and *To* dates. + +Create custom query annotations. + +. Select *Custom query*. + +. Enter the *Annotation query* for the data you want to display. ++ +For detailed information about queries and examples, check <>. + +. Select the *Target date field*. + +Specify the annotation appearance. . Enter the annotation *Name*. -. Change the *Appearance* options for how you want the annotation to display. +. Change the *Appearance* options for how you want the annotation to display on the visualization. + +. If you created a custom query annotation, click *Add field* to add a field to the annotation tooltip. . To close, click *X*. @@ -240,7 +270,7 @@ image::images/lens_referenceLine_7.16.png[Lens drag and drop focus state] [[filter-the-data]] ==== Apply filters -You can use the <> to focus on a known set of data for the entire visualization, or use the filter options from the layer pane or legend. +You can use the <> to create queries that filter all the data in a visualization, or use the layer pane and legend filters to apply filters based on field values. [float] [[filter-with-the-function]] diff --git a/docs/user/dashboard/tsvb.asciidoc b/docs/user/dashboard/tsvb.asciidoc index d9cd137978e9c..d725a82d74b65 100644 --- a/docs/user/dashboard/tsvb.asciidoc +++ b/docs/user/dashboard/tsvb.asciidoc @@ -136,7 +136,15 @@ The *Markdown* visualization supports Markdown with Handlebar (mustache) syntax [[edit-visualizations-in-lens]] ==== Open and edit TSVB visualizations in Lens -Open and edit Time Series and Top N *TSVB* visualizations in *Lens*. When you open *TSVB* visualizations in *Lens*, all configuration options and annotations appear in the *Lens* visualization editor. +When you open *TSVB* visualizations in *Lens*, all configuration options and annotations appear in the *Lens* visualization editor. + +You can open the following *TSVB* visualizations in *Lens*: + +* Time Series +* Metric +* Top N +* Gauge +* Table To get started, click *Edit visualization in Lens* in the toolbar.