diff --git a/docs/user/dashboard/aggregation-based.asciidoc b/docs/user/dashboard/aggregation-based.asciidoc index d901ab8deccb..351e1f5d0825 100644 --- a/docs/user/dashboard/aggregation-based.asciidoc +++ b/docs/user/dashboard/aggregation-based.asciidoc @@ -187,8 +187,33 @@ TIP: Aggregation-based panels support a maximum of three *Split series*. [role="screenshot"] image:images/bar-chart-tutorial-2.png[Bar chart with sample logs data] +[float] +[[save-the-aggregation-based-panel]] +===== Save and add the panel + +Save the panel to the *Visualize Library* and add it to the dashboard, or add it to the dashboard without saving. + +To save the panel to the *Visualize Library*: + +. Click *Save to library*. + +. Enter the *Title* and add any applicable <>. + +. Make sure that *Add to Dashboard after saving* is selected. + . Click *Save and return*. +To save the panel to the dashboard: + +. Click *Save and return*. + +. Add an optional title to the panel. + +.. In the panel header, click *No Title*. + +.. On the *Customize panel* window, select *Show panel title*. + +.. Enter the *Panel title*, then click *Save*. diff --git a/docs/user/dashboard/aggregation-reference.asciidoc b/docs/user/dashboard/aggregation-reference.asciidoc deleted file mode 100644 index 17bfc19c2e0c..000000000000 --- a/docs/user/dashboard/aggregation-reference.asciidoc +++ /dev/null @@ -1,467 +0,0 @@ -[[aggregation-reference]] -== Supported features by panel type - -Each panel type in {kib} supports different features and {ref}/search-aggregations.html[{es} aggregations]. -This reference can help simplify the comparison if you need a specific feature. - - -[float] -[[chart-types]] -=== Supported panel types by editor - -[options="header"] -|=== - -| Type | Lens | TSVB | Agg-based | Vega | Timelion - -| Table -| ✓ -| ✓ -| ✓ -| -| - -| Bar, line, and area -| ✓ -| ✓ -| ✓ -| ✓ -| ✓ - -| Split chart/small multiples -| -| ✓ -| ✓ -| ✓ -| - -| Pie and donut -| ✓ -| -| ✓ -| ✓ -| - -| Sunburst -| ✓ -| -| ✓ -| ✓ -| - -| Treemap -| ✓ -| -| -| ✓ -| - -| Heat map -| ✓ -| ✓ -| ✓ -| ✓ -| - -| Gauge and Goal -| -| ✓ -| ✓ -| ✓ -| - -| Markdown -| -| ✓ -| -| -| - -| Metric -| ✓ -| ✓ -| ✓ -| ✓ -| - -| Tag cloud -| -| -| ✓ -| ✓ -| - -|=== - -[float] -[[table-features]] -=== Table features - -[options="header"] -|=== - -| Type | Lens | TSVB | Agg-based - -| Summary row -| ✓ -| -| ✓ - -| Pivot table -| ✓ -| -| - -| Calculated column -| Formula -| ✓ -| Percent only - -| Color by value -| ✓ -| ✓ -| - -|=== - -[float] -[[xy-features]] -=== Bar, line, area features - -[options="header"] -|=== - -| Type | Lens | TSVB | Agg-based | Vega | Timelion - -| Dense time series -| Customizable -| ✓ -| Customizable -| ✓ -| ✓ - -| Percentage mode -| ✓ -| ✓ -| ✓ -| ✓ -| - -| Break downs -| 1 -| 1 -| 3 -| ∞ -| 1 - -| Custom color with break downs -| -| Only for Filters -| ✓ -| ✓ -| - -| Fit missing values -| ✓ -| -| ✓ -| ✓ -| ✓ - -| Synchronized tooltips -| -| ✓ -| -| -| - -|=== - -[float] -[[bucket-aggregations]] -=== Bucket aggregations - -Vega supports all bucket aggregations because it allows custom queries. - -For information about {es} bucket aggregations, refer to {ref}/search-aggregations-bucket.html[Bucket aggregations]. - -[options="header"] -|=== - -| Type | Lens | TSVB | Agg-based - -| Histogram -| ✓ -| -| ✓ - -| Date histogram -| ✓ -| ✓ -| ✓ - -| Date range -| Use filters -| -| ✓ - -| Filter -| -| ✓ -| - -| Filters -| ✓ -| ✓ -| ✓ - -| GeoHash grid -| -| -| ✓ - -| IP range -| Use filters -| Use filters -| ✓ - -| Range -| ✓ -| Use filters -| ✓ - -| Terms -| ✓ -| ✓ -| ✓ - -| Significant terms -| -| -| ✓ - -|=== - -[float] -[[metrics-aggregations]] -=== Metrics aggregations - -Vega supports all metric aggregations because it allows custom queries. - -For information about {es} metrics aggregations, refer to {ref}/search-aggregations-metrics.html[Metrics aggregations]. - -[options="header"] -|=== - -| Type | Lens | TSVB | Agg-based - -| Metrics with filters -| ✓ -| -| - -| Average, Sum, Max, Min -| ✓ -| ✓ -| ✓ - -| Unique count (Cardinality) -| ✓ -| ✓ -| ✓ - -| Percentiles and Median -| ✓ -| ✓ -| ✓ - -| Percentiles Rank -| -| ✓ -| ✓ - -| Standard deviation -| -| ✓ -| ✓ - -| Sum of squares -| -| ✓ -| - -| Top hit (Last value) -| ✓ -| ✓ -| ✓ - -| Value count -| -| -| ✓ - -| Variance -| -| ✓ -| - -|=== - -[float] -[[pipeline-aggregations]] -=== Pipeline aggregations - -Vega supports all pipeline aggregations because it allows custom queries. - -For information about {es} pipeline aggregations, refer to {ref}/search-aggregations-pipeline.html[Pipeline aggregations]. - -[options="header"] -|=== - -| Type | Lens | TSVB | Agg-based - -| Avg bucket -| <> -| ✓ -| ✓ - -| Derivative -| ✓ -| ✓ -| ✓ - -| Max bucket -| <> -| ✓ -| ✓ - -| Min bucket -| <> -| ✓ -| ✓ - -| Sum bucket -| <> -| ✓ -| ✓ - -| Moving average -| ✓ -| ✓ -| ✓ - -| Cumulative sum -| ✓ -| ✓ -| ✓ - -| Bucket script -| -| -| ✓ - -| Bucket selector -| -| -| - -| Serial differencing -| -| ✓ -| ✓ - -|=== - -[float] -[[custom-functions]] -=== Additional functions - -[options="header"] -|=== - -| Type | Lens | TSVB | Agg-based - -| Counter rate -| ✓ -| ✓ -| - -| <> -| Use <> -| ✓ -| - -| <> -| -| ✓ -| - -| <> -| -| ✓ -| - -| Static value -| -| ✓ -| - - -|=== - -[float] -[[other-features]] -=== Other features - -This comparison is meant for users who are not sure about which {kib} panel type to -build their advanced visualization. - -[options="header"] -|=== - -| Type | Lens | TSVB | Agg-based | Vega | Timelion - -| Math -| ✓ -| ✓ -| -| ✓ -| ✓ - -| Visualize two indices -| ✓ -| ✓ -| -| ✓ -| ✓ - -| Math across indices -| -| -| -| ✓ -| ✓ - -| Time shifts -| ✓ -| ✓ -| -| ✓ -| ✓ - -| Fully custom {es} queries -| -| -| -| ✓ -| - -| Normalize by time -| ✓ -| ✓ -| -| -| - - -|=== diff --git a/docs/user/dashboard/dashboard.asciidoc b/docs/user/dashboard/dashboard.asciidoc index b8b38bad0180..1a9a0087becd 100644 --- a/docs/user/dashboard/dashboard.asciidoc +++ b/docs/user/dashboard/dashboard.asciidoc @@ -1,5 +1,5 @@ [[dashboard]] -= Dashboard += Dashboard and visualizations [partintro] -- @@ -11,14 +11,13 @@ that bring clarity to your data, tell a story about your data, and allow you to [role="screenshot"] image:images/Dashboard_example.png[Example dashboard] -Panels display your data in charts, tables, maps, and more, which allow you to compare your data side-by-side to identify patterns and connections. Dashboards support several editors you can use to create panels, and support many types of panels to display your data. +Panels display your data in charts, tables, maps, and more, which allow you to compare your data side-by-side to identify patterns and connections. Dashboards support several types of panels to display your data, and several options to create panels. [cols="2"] |=== | <> -| Use the *Lens*, *TSVB*, *Vega*, and *Timelion* editors to create visualizations of your data, or create *Aggregation based* visualizations using {es} aggregations. -*Lens* is the recommended editor. +| Use one of the editors to create visualizations of your data. Each editor varies in capabilities for all levels of analysts. | <> | Create beautiful displays of your geographical data. @@ -33,7 +32,10 @@ Panels display your data in charts, tables, maps, and more, which allow you to c | Display a table of live streaming logs. | <> -| Add context to your panels with <>, or add dynamic filters with <>. +| Add interactive filters with *Controls* panels. + +| <> +| Add context to your panels with *Text*. |=== @@ -61,71 +63,115 @@ refer to <>. [[open-the-dashboard]] === Open the dashboard -Begin with an empty dashboard, or open an existing dashboard. +Begin with an empty dashboard, or open an existing dashboard. . Open the main menu, then click *Dashboard*. . On the *Dashboards* page, choose one of the following options: * To start with an empty dashboard, click *Create dashboard*. ++ +When you create a dashboard, you are automatically in edit mode and can make changes to the dashboard. * To open an existing dashboard, click the dashboard *Title* you want to open. ++ +When you open an existing dashboard, you are in view mode. To make changes to the dashboard, click *Edit* in the toolbar. [float] [[create-panels-with-lens]] -=== Add panels +=== Create and add panels -Create and add panels of your data to the dashboard, or add existing panels from the library. +You create panels using the editors, which you can access from the dashboard toolbar or the *Visualize Library*, or add panels that are saved in the *Visualize Library*, or search results from <>. -* *Create visualization* — Opens *Lens*, the recommended editor to create visualizations of your data. +To create panels from the dashboard toolbar, use one of the following options: -* *All types* — Select the editor to create the panel, or select the panel type you want to add to the dashboard. +* *Create visualization* — Opens the drag-and-drop editor, which is the recommended way to create visualization panels. -* *Add from library* — Add panels from the *Visualize Library*, including search results from <>. The search results from *Discover* are not aggregated. +* *All types* — Opens the menu for all of the editors and panel types. + +To create panels from the *Visualize Library*: + +. Open the main menu, then click *Visualize Library*. + +. Click *Create visualization*, then select an editor. + +To add existing panels from the *Visualize Library*: + +. In the dashboard toolbar, click *Add from library*. + +. Click the panel you want to add to the dashboard, then click *X*. + When a panel contains a saved query, both queries are applied. ++ +When you add search results from *Discover* to dashboards, the results are not aggregated. [[tsvb]] [float] [[save-panels]] -=== Save panels +=== Save and add panels -Consider where you want to save the panel in {kib}. You can save the panel just on the dashboard you are working on, or save the panel in the *Visualize Library*. +Consider where you want to save and add the panel in {kib}. [float] [[save-to-visualize-library]] ==== Save to the Visualize Library -To use the panel on *Canvas* workpads and other dashboards, save the panel to the *Visualize Library*. +To use the panel on other dashboards and *Canvas* workpads, save the panel to the *Visualize Library*. When panels are saved in the *Visualize Library*, image:dashboard/images/visualize-library-icon.png[Visualize Library icon] appears in the panel header. -. Click *Save to library*. +If you created the panel from the dashboard: -. Enter the *Title* and add any applicable *Tags*. +. In the editor, click *Save to library*. + +. Enter the *Title* and add any applicable <>. . Make sure that *Add to Dashboard after saving* is selected. . Click *Save and return*. -+ -When panels are saved in the *Visualize Library*, image:dashboard/images/visualize-library-icon.png[Visualize Library icon] appears in the panel header. + +If you created the panel from the *Visualize Library*: + +. In the editor, click *Save*. + +. On the *Save* window, enter the *Title*. + +. Choose one of the following options: + +* To save the panel to a dashboard and the *Visualize Library*, select *Add to library*, add any applicable <>, then click *Save and go to Dashboard*. + +* To save the panel only to the *Visualize Library*, select *None*, add any applicable <>, then click *Save and add to library*. [float] [[save-to-the-dashboard]] ==== Save to the dashboard -Quickly add the panel and return to the dashboard without specifying the save options or adding the panel to the *Visualize Library*. +Return to the dashboard and add the panel without specifying the save options or adding the panel to the *Visualize Library*. -. Click *Save and return*. +If you created the panel from the dashboard: -. Add more panels to the dashboard, or specify the panel title. +. In the editor, click *Save and return*. + +. Add an optional title to the panel. .. In the panel header, click *No Title*. -.. Select *Show panel title*. +.. On the *Customize panel* window, select *Show panel title*. -.. Enter the *Panel title*. +.. Enter the *Panel title*, then click *Save*. -If you change your mind and want to add the panel to the *Visualize Library*: +If you created the panel from the *Visualize Library*: + +. Click *Save*. + +. On the *Save* window, enter the *Title*. + +. Choose one of the following options: + +* If you want to add the panel to an existing dashboard, select *Existing*, select the dashboard from the dropdown, then click *Save and go to Dashboard*. + +* If you want to add the panel to a new dashboard, select *New*, then click *Save and go to Dashboard*. + +To add unsaved dashboard panels to the *Visualize Library*: . Open the panel menu, then select *More > Save to library*. @@ -135,33 +181,77 @@ If you change your mind and want to add the panel to the *Visualize Library*: [[add-text]] == Add context to panels -To provide context to your dashboard panels, add *Text* panels that display important information, instructions, images, and more. +To provide context to your dashboard panels, add *Text* panels that display important information, instructions, images, and more. You create *Text* panels using GitHub-flavored Markdown text. -You create *Text* panels using GitHub-flavored Markdown text. For information about GitHub-flavored Markdown text, click *Help*. - -. From the dashboard, click *All types*, then select *Text*. +. On the dashboard, click image:images/dashboard_createNewTextButton_7.15.0.png[Create New Text button in dashboard toolbar]. . In the *Markdown* field, enter the text, then click *Update*. For example, when you enter: [role="screenshot"] -image::images/markdown_example_1.png[] +image::images/markdown_example_1.png[Markdown text with links] The following instructions are displayed: [role="screenshot"] -image::images/markdown_example_2.png[] +image::images/markdown_example_2.png[Panel with markdown link text] Or when you enter: [role="screenshot"] -image::images/markdown_example_3.png[] +image::images/markdown_example_3.png[Markdown text with image file] The following image is displayed: [role="screenshot"] -image::images/markdown_example_4.png[] +image::images/markdown_example_4.png[Panel with markdown image] + +For detailed information about writing on GitHub, click *Help*. + +[float] +[[save-the-markdown-panel]] +=== Save and add the panel + +Save the panel to the *Visualize Library* and add it to the dashboard, or add it to the dashboard without saving. + +To save the panel to the *Visualize Library*: + +. Click *Save to library*. + +. Enter the *Title* and add any applicable <>. + +. Make sure that *Add to Dashboard after saving* is selected. + +. Click *Save and return*. + +To save the panel to the dashboard: + +. Click *Save and return*. + +. Add an optional title to the panel. + +.. In the panel header, click *No Title*. + +.. On the *Customize panel* window, select *Show panel title*. + +.. Enter the *Panel title*, then click *Save*. + +[float] +[[arrange-panels]] +[[moving-containers]] +[[resizing-containers]] +== Arrange panels + +Compare the data in your panels side-by-side, organize panels by priority, resize the panels so they all appear immediately on the dashboard, and more. + +In the toolbar, click *Edit*, then use the following options: + +* To move, click and hold the panel header, then drag to the new location. + +* To resize, click the resize control, then drag to the new dimensions. + +* To maximize to fullscreen, open the panel menu, then click *More > Maximize panel*. [float] [[edit-panels]] @@ -187,51 +277,6 @@ To make changes without changing the original version, open the panel menu, then + If you want to use the panel later, make sure that you save the panel to the *Visualize Library*. -[float] -[[search-or-filter-your-data]] -== Search and filter your data - -{kib} supports several ways to search your data and apply {es} filters. You can combine the filters with any panel -filter to display the data want to you see. - -For more information about {kib} and {es} filters, refer to <>. - -To apply a panel-level time filter: - -. Open the panel menu, then select *More > Customize time range*. - -. Enter the time range you want to view, then click *Add to panel*. - -[float] -[[arrange-panels]] -[[moving-containers]] -[[resizing-containers]] -== Arrange panels - -To compare the data side-by-side, move and arrange the panels. - -In the toolbar, click *Edit*, then use the following options: - -* To move, click and hold the panel header, then drag to the new location. - -* To resize, click the resize control, then drag to the new dimensions. - -* To maximize to fullscreen, open the panel menu, then click *More > Maximize panel*. - -[float] -[[apply-design-options]] -== Apply design options - -Apply a set of design options to the entire dashboard. - -In the toolbar, click *Edit > Options*, then use the following options: - -* *Use margins between panels* — Specifies a margin of space between each panel. - -* *Show panel titles* — Specifies the appearance of titles in the header of each panel. - -* *Sync color pallettes across panels* — Specifies whether the color pallette is applied to all panels. - [float] [[duplicate-panels]] == Duplicate panels @@ -262,22 +307,57 @@ Copy panels from one dashboard to another dashboard. . On the *Copy to dashboard* window, select the dashboard, then click *Copy and go to dashboard*. [float] -[[explore-the-underlying-documents]] -== Explore the underlying documents +[[search-or-filter-your-data]] +== Search and filter your data -You can add additional interactions that allow you to open *Discover* from dashboard panels. To use the interactions, the panel must use only one index pattern. +{kib} supports several ways to search your data and apply {es} filters. You can combine the filters with any panel +filter to display the data want to you see. -Panel interaction:: Opens the data in *Discover* with the current dashboard filters, but does not take the filters -saved with the panel. -+ -To enable panel interactions, refer to <>. -+ -NOTE: In {kib} 7.13 and earlier, the panel interaction is enabled by default. +For more information about {kib} and {es} filters, refer to <>. -Series interaction:: -Opens the series data in *Discover* from inside the panel. -+ -To enable series interactions, refer to <>. +To apply a panel-level time filter: + +. Open the panel menu, then select *More > Customize time range*. + +. Enter the time range you want to view, then click *Add to panel*. + +[float] +[[apply-design-options]] +== Apply design options + +Apply a set of design options to the entire dashboard. + +. If you're in view mode, click *Edit* in the toolbar. + +. In the toolbar, *Options*, then use the following options: + +* *Use margins between panels* — Adds a margin of space between each panel. + +* *Show panel titles* — Displays the titles in the panels headers. + +* *Sync color pallettes across panels* — Applies the same color palette to all panels on the dashboard. + +[float] +[[save-dashboards]] +== Save dashboards + +When you've finished making changes to the dashboard, save it. + +If you are saving a new dashboard: + +. In the toolbar, click *Save*. + +. On the *Save dashboard* window, enter the *Title* and an optional *Description*. + +. Add any applicable <>. + +. To save the time filter to the dashboard, select *Store time with dashboard*. + +. Click *Save*. + +If you are saving an existing dashboard, click *Save*. + +To exit *Edit* mode, click *Switch to view mode*. [float] [[download-csv]] diff --git a/docs/user/dashboard/enhance-dashboards.asciidoc b/docs/user/dashboard/enhance-dashboards.asciidoc deleted file mode 100644 index de8af34e6d32..000000000000 --- a/docs/user/dashboard/enhance-dashboards.asciidoc +++ /dev/null @@ -1,69 +0,0 @@ -[[enhance-dashboards]] -== Enhance dashboards - -You can add filter panels to interact with the data in your visualization panels, and Markdown panels to add context to the data. -To make your dashboard look the way you want, use the editing options. - -[float] -[[add-controls]] -=== Add controls - -To filter the data on your dashboard in real-time, add a *Controls* panel or use a map panel to <>. - -{kib} supports two types of *Controls*: - -* *Options list* — Filters content based on one or more specified options. The dropdown menu is dynamically populated with the results of a terms aggregation. -For example, use the options list on the sample flight dashboard when you want to filter the data by origin city and destination city. - -* *Range slider* — Filters data within a specified range of numbers. The minimum and maximum values are dynamically populated with the results of a -min and max aggregation. For example, use the range slider when you want to filter the sample flight dashboard by a specific average ticket price. -+ -[role="screenshot"] -image::images/dashboard-controls.png[] - -. On the dashboard, click *All types*, then select *Controls*. - -. Click *Options*, then configure the following options: - -* *Update {kib} filters on each change* — When selected, all interactive inputs create filters that refresh the dashboard. When unselected, - {kib} filters are created only when you click *Apply changes*. - -* *Use time filter* — When selected, the aggregations that generate the options list and time range are connected to the <>. - -* *Pin filters for all applications* — When selected, all filters created by interacting with the inputs are automatically pinned. - -. Click *Update* - -[float] -[[add-text]] -=== Add text - -Add text panels with *Markdown* when you want to provide context to the other panels on your dashboard, such as important information, instructions, and images. - -*Markdown* is a text entry field that accepts GitHub-flavored Markdown text. For information about GitHub-flavored Markdown text, click *Help*. - -. From the dashboard, click *All types*, then select *Text*. - -. In the *Markdown* field, enter the text, then click *Update*. - -For example, when you enter: - -[role="screenshot"] -image::images/markdown_example_1.png[] - -The following instructions are displayed: - -[role="screenshot"] -image::images/markdown_example_2.png[] - -Or when you enter: - -[role="screenshot"] -image::images/markdown_example_3.png[] - -The following image is displayed: - -[role="screenshot"] -image::images/markdown_example_4.png[] - - diff --git a/docs/user/dashboard/images/dashboard_createNewTextButton_7.15.0.png b/docs/user/dashboard/images/dashboard_createNewTextButton_7.15.0.png new file mode 100644 index 000000000000..f89f2ef5cf24 Binary files /dev/null and b/docs/user/dashboard/images/dashboard_createNewTextButton_7.15.0.png differ diff --git a/docs/user/dashboard/images/markdown_example_1.png b/docs/user/dashboard/images/markdown_example_1.png index 71dd9b76b8ca..8ade6b83cf74 100644 Binary files a/docs/user/dashboard/images/markdown_example_1.png and b/docs/user/dashboard/images/markdown_example_1.png differ diff --git a/docs/user/dashboard/images/markdown_example_2.png b/docs/user/dashboard/images/markdown_example_2.png index f2094c3cbb3f..e114d33846fd 100644 Binary files a/docs/user/dashboard/images/markdown_example_2.png and b/docs/user/dashboard/images/markdown_example_2.png differ diff --git a/docs/user/dashboard/images/markdown_example_3.png b/docs/user/dashboard/images/markdown_example_3.png index eca9735b495d..09a1858a2a93 100644 Binary files a/docs/user/dashboard/images/markdown_example_3.png and b/docs/user/dashboard/images/markdown_example_3.png differ diff --git a/docs/user/dashboard/images/markdown_example_4.png b/docs/user/dashboard/images/markdown_example_4.png index d4a0829fef64..f0d133fc3641 100644 Binary files a/docs/user/dashboard/images/markdown_example_4.png and b/docs/user/dashboard/images/markdown_example_4.png differ diff --git a/docs/user/dashboard/lens.asciidoc b/docs/user/dashboard/lens.asciidoc index 6b61c9fe6a9a..0f130f15c8a7 100644 --- a/docs/user/dashboard/lens.asciidoc +++ b/docs/user/dashboard/lens.asciidoc @@ -178,7 +178,39 @@ For a time shift example, refer to <>. [float] [[filter-the-data]] -==== Apply filters with the legend +==== 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. + +[float] +[[filter-with-the-function]] +===== Apply multiple KQL filters + +With the *Filters* function, you can apply more than one KQL filter, and apply a KQL filter to a single layer so you can visualize filtered and unfiltered data at the same time. + +. In the layer pane, click a field. + +. Click the *Filters* function. + +. Click *Add a filter*, then enter the KQL filter you want to apply. ++ +To try the *Filters* function on your own, refer to <>. + +[float] +[[filter-with-the-advanced-option]] +===== Apply a single KQL filter + +With the *Filter by* advanced option, you can assign a color to each filter group in *Bar* and *Line and area* visualizations, and build complex tables. For example, to display failure rate and the overall data. + +. In the layer pane, click a field. + +. Click *Add advanced options*, then select *Filter by*. + +. Enter the KQL filter you want to apply. + +[float] +[[filter-with-legend-filters]] +===== Apply legend filters Apply filters to visualizations directly from the values in the legend. *Bar*, *Line and area*, and *Proportion* visualizations support legend filters. @@ -204,32 +236,40 @@ The following component menus are available: * *Left axis*, *Bottom axis*, and *Right axis* — Specify how you want to display the chart axes. For example, add axis labels and change the orientation and bounds. +[float] +[[save-the-lens-panel]] +===== Save and add the panel + +Save the panel to the *Visualize Library* and add it to the dashboard, or add it to the dashboard without saving. + +To save the panel to the *Visualize Library*: + +. Click *Save to library*. + +. Enter the *Title* and add any applicable <>. + +. Make sure that *Add to Dashboard after saving* is selected. + +. Click *Save and return*. + +To save the panel to the dashboard: + +. Click *Save and return*. + +. Add an optional title to the panel. + +.. In the panel header, click *No Title*. + +.. On the *Customize panel* window, select *Show panel title*. + +.. Enter the *Panel title*, then click *Save*. + [float] [[lens-faq]] -==== Frequently asked questions +=== Frequently asked questions For answers to common *Lens* questions, review the following. -[discrete] -[[kql]] -.*When should I use KQL filters, the Filters function, or the Filter by option?* -[%collapsible] -==== -Use the <> field to focus on a known set of data for the entire visualization. You can combine KQL filters with other filters using AND logic. - -Use the *Filters* function to apply: - -* More than one KQL filter. - -* The KQL filter to a single layer, which allows you to visualize filtered and unfiltered data. - -Use the *Filter by* advanced option to: - -* Assign a custom color to each filter group in a bar, line, or area chart. - -* Build a complex table. For example, to display the failure rate and overall data. -==== - [discrete] [[when-should-i-normalize-the-data-by-unit-or-use-a-custom-interval]] .*When should I normalize the data by unit or use a custom interval?* @@ -401,4 +441,4 @@ Pagination in a data table is unsupported. To use pagination in data tables, cre [%collapsible] ==== Specifying the color for a single data point, such as a single bar or line, is unsupported. -==== +==== \ No newline at end of file diff --git a/docs/user/dashboard/make-dashboards-interactive.asciidoc b/docs/user/dashboard/make-dashboards-interactive.asciidoc index c3a94f17fc6d..6e09fd34f508 100644 --- a/docs/user/dashboard/make-dashboards-interactive.asciidoc +++ b/docs/user/dashboard/make-dashboards-interactive.asciidoc @@ -1,4 +1,4 @@ -[[role="xpack"]] +[role="xpack"] [[drilldowns]] == Make dashboards interactive @@ -7,28 +7,7 @@ you to apply dashboard-level filters, and drilldowns that allow you to navigate to other \ dashboards and external websites. -Add interactive capabilities to your dashboard, such as controls that allow you to apply dashboard-level filters, and drilldowns that allow you to navigate to other dashboards and external websites. - -*Controls* panels allow you to apply dashboard-level filters based on values from a list, or a range of values. - -{kib} supports two types of *Controls*: - -* *Options list* — Filters content based on one or more specified options. The dropdown menu is dynamically populated with the results of a terms aggregation. -For example, use the options list on the sample flight dashboard when you want to filter the data by origin city and destination city. - -* *Range slider* — Filters data within a specified range of numbers. The minimum and maximum values are dynamically populated with the results of a -min and max aggregation. For example, use the range slider when you want to filter the sample flight dashboard by a specific average ticket price. -+ -[role="screenshot"] -image::images/dashboard-controls.png[] - -Panels have built-in interactive capabilities that apply filters to the dashboard data. For example, when you drag a time range or click a pie slice, a filter for the time range or pie slice is applied. Drilldowns let you customize the interactive behavior while keeping the context of the interaction. - -{kib} supports two types of drilldowns: - -* *Dashboard* — Navigates you from one dashboard to another dashboard. For example, when can create a drilldown for a *Lens* panel that navigates you from a summary dashboard to a dashboard with a filter for a specific host name. - -* *URL* — Navigates you from a dashboard to an external website. For example, a website with the specific host name as a parameter. +Add interactive capabilities to your dashboard, such as controls that allow you to apply dashboard-level filters, and drilldowns that allow you to navigate to *Discover*, other dashboards, and external websites. ++++