diff --git a/explore-analyze/_snippets/area-vertical-axis-advanced-settings.md b/explore-analyze/_snippets/area-vertical-axis-advanced-settings.md deleted file mode 100644 index d0ebcc812d..0000000000 --- a/explore-analyze/_snippets/area-vertical-axis-advanced-settings.md +++ /dev/null @@ -1,6 +0,0 @@ -:::{dropdown} Advanced settings -Depending on the data you defined, you can use the following options to apply additional filtering: - -- **Filter by**: Specify a query. -- **Time shift**: Compare current data with historical data by shifting the time frame of your metrics. -::: \ No newline at end of file diff --git a/explore-analyze/_snippets/lens-breakdown-advanced-settings.md b/explore-analyze/_snippets/lens-breakdown-advanced-settings.md index 2614ac05d4..cf917f8ac4 100644 --- a/explore-analyze/_snippets/lens-breakdown-advanced-settings.md +++ b/explore-analyze/_snippets/lens-breakdown-advanced-settings.md @@ -4,6 +4,6 @@ Several advanced options allow you to refine the behavior of the breakdown: - **Include documents without the selected field**: Off by default. - **Group remaining values as "Other"**: On by default. - **Enable accuracy mode**: This option improves results for high-cardinality data, but increases the load on the {{es}} cluster. -- **Include values**: Values from the breakdown dimension to always show a tile for. -- **Exclude values**: Values from the breakdown dimension to always exclude from the displayed tiles. +- **Include values**: Values from the dimension to always include, even if they aren't among the top values. You can enter exact values or a regular expression. +- **Exclude values**: Values from the dimension to always exclude. You can enter exact values or a regular expression. ::: \ No newline at end of file diff --git a/explore-analyze/_snippets/lens-bucket-date-histogram.md b/explore-analyze/_snippets/lens-bucket-date-histogram.md new file mode 100644 index 0000000000..42bbf85066 --- /dev/null +++ b/explore-analyze/_snippets/lens-bucket-date-histogram.md @@ -0,0 +1,2 @@ +- **Date histogram**: Group data into time-based buckets. + - **Field**: Select the date field to use for the time-based grouping. diff --git a/explore-analyze/_snippets/lens-bucket-filters.md b/explore-analyze/_snippets/lens-bucket-filters.md new file mode 100644 index 0000000000..589821585f --- /dev/null +++ b/explore-analyze/_snippets/lens-bucket-filters.md @@ -0,0 +1 @@ +- **Filters**: Define custom KQL filters. Each filter creates one group from the documents that match its query. diff --git a/explore-analyze/_snippets/lens-bucket-intervals.md b/explore-analyze/_snippets/lens-bucket-intervals.md new file mode 100644 index 0000000000..1c5d9095fd --- /dev/null +++ b/explore-analyze/_snippets/lens-bucket-intervals.md @@ -0,0 +1,5 @@ +- **Intervals**: Create numeric ranges for continuous data by grouping a numeric field into buckets. + - **Field**: Select the numeric field to create intervals from. + - **Intervals granularity**: Use the slider to control how many intervals to create. {{kib}} divides the field into evenly spaced intervals (incremented by 10, 5, or 2) between the field's minimum and maximum values. The minimum granularity is 1, and the maximum is set by the `histogram:maxBars` advanced setting. + - **Create custom ranges**: Define your own ranges with specific lower and upper bounds and optional labels, instead of using the automatic granularity. + - **Include empty rows**: Include intervals that contain no matching documents. On by default. diff --git a/explore-analyze/_snippets/lens-bucket-top-values.md b/explore-analyze/_snippets/lens-bucket-top-values.md new file mode 100644 index 0000000000..ba9ca3a2da --- /dev/null +++ b/explore-analyze/_snippets/lens-bucket-top-values.md @@ -0,0 +1,5 @@ +- **Top values**: Show the most common values of a field. + - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term groups. When multiple fields are selected, each group represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. + - **Number of values**: How many top values to display. The default number of values depends on your environment: + - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. + - {applies_to}`stack: ga 9.0-9.3` Defaults to 5 for the first Top values dimension added to the chart and 3 for each additional one. diff --git a/explore-analyze/_snippets/lens-collapse-by.md b/explore-analyze/_snippets/lens-collapse-by.md new file mode 100644 index 0000000000..dc5a0926cb --- /dev/null +++ b/explore-analyze/_snippets/lens-collapse-by.md @@ -0,0 +1 @@ +- **Collapse by**: Aggregate all metric values that share the same value for this dimension into a single number, removing it as an independent grouping. Available aggregation methods: `Sum`, `Min`, `Max`, or `Average`. diff --git a/explore-analyze/_snippets/lens-rank-by-options.md b/explore-analyze/_snippets/lens-rank-by-options.md index 3def7b31d0..d96a4a21b2 100644 --- a/explore-analyze/_snippets/lens-rank-by-options.md +++ b/explore-analyze/_snippets/lens-rank-by-options.md @@ -1,7 +1,7 @@ - **Rank by**: Specifies the dimension the top values are ranked by. Available options: - **Count of records**: Rank by the number of documents containing each value. This is the default when a metric is defined. - **Alphabetical**: Rank by the term key alphabetically. This is the default when no metric is defined. - - **Rarity**: Find terms that appear in very few documents, using a [rare terms aggregation](elasticsearch://reference/aggregations/search-aggregations-bucket-rare-terms-aggregation.md). You can configure the **Max doc count** to set the maximum number of documents a term can appear in to be considered rare (default: 1, max: 100). Only available for non-numeric fields and single-field terms. + - **Rarity**: Find terms that appear in very few documents, using a [rare terms aggregation](elasticsearch://reference/aggregations/search-aggregations-bucket-rare-terms-aggregation.md). You can configure the **Max doc count per term** to set the maximum number of documents a term can appear in to be considered rare (default: 1, max: 100). Available for single-field terms only, and not for floating-point numeric fields (`float`, `double`, `half_float`, and `scaled_float`). - **Significance**: Find statistically unusual terms compared to the overall data set, using a [significant terms aggregation](elasticsearch://reference/aggregations/search-aggregations-bucket-significantterms-aggregation.md). Only available for `keyword` fields and single-field terms. - **Custom**: Define a custom metric aggregation to rank by (for example, rank by the sum of a numeric field rather than by count). - **Rank direction**: Ascending or descending order. Disabled when **Rank by** is set to **Rarity** or **Significance**. diff --git a/explore-analyze/visualize/charts/area-charts.md b/explore-analyze/visualize/charts/area-charts.md index 1d2f09c402..b27346fe97 100644 --- a/explore-analyze/visualize/charts/area-charts.md +++ b/explore-analyze/visualize/charts/area-charts.md @@ -126,22 +126,20 @@ Customize your area chart to match the information you need and how you want it **Data** : - **Functions**: - - **Top values**: Create separate areas for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields. When multiple fields are selected, each area represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data points into time-based buckets (for example, hourly, daily, weekly). - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Create numeric ranges for continuous data. You can define the interval granularity or specify custom ranges. - - **Field**: Select the numeric field to create intervals from. - - **Filters**: Allow you to segment your data based on specific conditions, creating separate areas for each filter. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: **Appearance** : **Name**: By default, the chart uses the function or formula as title. It's a best practice to customize this with a meaningful title. @@ -151,7 +149,7 @@ Customize your area chart to match the information you need and how you want it **Data** : To represent the metrics or values you want to visualize, you can use quick functions like Average, Count, Percentile, Counter rate, or create custom calculations with formulas. Refer to [](/explore-analyze/visualize/lens.md#lens-formulas) for examples. - :::{include} ../../_snippets/area-vertical-axis-advanced-settings.md + :::{include} ../../_snippets/lens-value-advanced-settings.md ::: **Appearance** @@ -168,22 +166,23 @@ You can split your data by a categorical field to create multiple stacked or ove **Data** : - **Functions**: - - **Top values**: Create separate areas for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields. When multiple fields are selected, each area represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 3. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data points into time-based buckets (for example, hourly, daily, weekly). - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Create numeric ranges for continuous data. You can define the interval granularity or specify custom ranges. - - **Field**: Select the numeric field to create intervals from. - - **Filters**: Create separate colored areas based on filter conditions. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: + + :::{include} ../../_snippets/lens-collapse-by.md + ::: **Appearance** : Allow you to customize how your breakdown data is displayed in line charts, including: diff --git a/explore-analyze/visualize/charts/bar-charts.md b/explore-analyze/visualize/charts/bar-charts.md index 00856cb607..52b747e195 100644 --- a/explore-analyze/visualize/charts/bar-charts.md +++ b/explore-analyze/visualize/charts/bar-charts.md @@ -358,23 +358,22 @@ Customize your bar chart to display exactly the information you need, formatted ### Horizontal axis settings [horizontal-axis-options] **Data** -: The dimension that creates your individual bars. Common functions include: - - **Top values**: Create bars for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term bars. When multiple fields are selected, each bar represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. +: The dimension that creates your individual bars. It supports the following functions: + + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Create time-based bars with configurable intervals. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Group data into numerical ranges. - - **Field**: Select the numeric field to create intervals from. - - **Filters**: Define custom categories using KQL queries. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: **Appearance** : Define the formatting of the horizontal axis, including: @@ -399,23 +398,25 @@ Customize your bar chart to display exactly the information you need, formatted ### Breakdown settings [breakdown-options] **Data** -: Split your bars into segments or groups based on another dimension. Each unique value creates its own segment or bar, allowing you to show composition or compare metrics across multiple dimensions. Common functions include: - - **Top values**: Create bar segments for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields. When multiple fields are selected, each segment represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 3. +: Split your bars into segments or groups based on another dimension. Each unique value creates its own segment or bar, allowing you to show composition or compare metrics across multiple dimensions. It supports the following functions: + + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Create time-based bars with configurable intervals. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Group data into numerical ranges. - - **Field**: Select the numeric field to create intervals from. - - **Filters**: Define custom categories using KQL queries. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: + + :::{include} ../../_snippets/lens-collapse-by.md + ::: **Appearance** : Define the formatting of the breakdown, including: diff --git a/explore-analyze/visualize/charts/heat-map-charts.md b/explore-analyze/visualize/charts/heat-map-charts.md index 70b56615d7..a6bcba6aa9 100644 --- a/explore-analyze/visualize/charts/heat-map-charts.md +++ b/explore-analyze/visualize/charts/heat-map-charts.md @@ -232,22 +232,20 @@ The **Horizontal axis** dimension defines the columns of the heat map. **Data** : The **Horizontal axis** dimension supports the following functions: - - **Top values**: Create columns for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term columns. When multiple fields are selected, each column represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data into time-based buckets. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Create numeric ranges for continuous data. - - **Field**: Select the numeric field to create intervals from. - - **Include empty rows**: Include intervals with no matching documents. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: **Appearance** : - **Name**: Customize the axis label. @@ -259,22 +257,20 @@ The **Vertical axis** dimension defines the rows of the heat map. **Data** : The **Vertical axis** dimension supports the same functions as the horizontal axis: - - **Top values**: Create rows for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term rows. When multiple fields are selected, each row represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 3. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data into time-based buckets. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Create numeric ranges for continuous data. - - **Field**: Select the numeric field to create intervals from. - - **Include empty rows**: Include intervals with no matching documents. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: **Appearance** : - **Name**: Customize the axis label. diff --git a/explore-analyze/visualize/charts/line-charts.md b/explore-analyze/visualize/charts/line-charts.md index 3fe729d927..1dd08201c3 100644 --- a/explore-analyze/visualize/charts/line-charts.md +++ b/explore-analyze/visualize/charts/line-charts.md @@ -114,22 +114,20 @@ Customize your line chart to display exactly the information you need, formatted **Data** : - **Functions**: - - **Top values**: Create separate lines for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields. When multiple fields are selected, each line represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data points into time-based buckets (for example, hourly, daily, weekly). - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Create numeric ranges for continuous data. You can define the interval granularity or specify custom ranges. - - **Field**: Select the numeric field to create intervals from. - - **Filters**: Allow you to segment your data based on specific conditions, creating separate lines for each filter. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: **Appearance** : **Name**: By default, the chart uses the function or formula as title. It's a best practice to customize this with a meaningful title. @@ -155,22 +153,23 @@ Breakdown functions segment your data into multiple lines on the same chart, wit **Data** : - **Functions**: - - **Top values**: Create separate lines for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields. When multiple fields are selected, each line represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 3. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data points into time-based buckets (for example, hourly, daily, weekly). - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Create numeric ranges for continuous data. You can define the interval granularity or specify custom ranges. - - **Field**: Select the numeric field to create intervals from. - - **Filters**: Allow you to segment your data based on specific conditions, creating separate lines for each filter. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: + + :::{include} ../../_snippets/lens-collapse-by.md + ::: **Appearance** : Allow you to customize how your breakdown data is displayed in line charts, including: diff --git a/explore-analyze/visualize/charts/metric-charts.md b/explore-analyze/visualize/charts/metric-charts.md index 73359a4e1c..6ddaa7d259 100644 --- a/explore-analyze/visualize/charts/metric-charts.md +++ b/explore-analyze/visualize/charts/metric-charts.md @@ -486,18 +486,24 @@ Customize your metric chart to display exactly the information you need, formatt ### Breakdown settings [breakdown-options] **Data** -: Split your metric into multiple tiles based on a categorical field. Each unique value creates its own tile, allowing you to compare metrics across regions, products, time periods, or any other dimensions. You can optionally specify the following options: +: Split your metric into multiple tiles based on a categorical field. Each unique value creates its own tile, allowing you to compare metrics across regions, products, time periods, or any other dimensions. It supports the following functions: - - **Number of values**: The number of tiles to show. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. - - If more values are available for the selected breakdown field, an additional tile named **Other** shows if the **Group remaining values as "Other"** advanced option is on. - :::{include} ../../_snippets/lens-rank-by-options.md + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: + :::{include} ../../_snippets/lens-rank-by-options.md + ::: + :::{include} ../../_snippets/lens-breakdown-advanced-settings.md + ::: + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: + :::{include} ../../_snippets/lens-histogram-settings.md + ::: + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md ::: - - **Collapse by**: Aggregate values of the various tiles into a single number. Possible aggregation options are `None` (default), `Sum`, `Average`, `Min`, and `Max`. - :::{include} ../../_snippets/lens-breakdown-advanced-settings.md + :::{include} ../../_snippets/lens-collapse-by.md ::: **Appearance** @@ -516,10 +522,10 @@ When creating or editing a visualization, you can customize several appearance o **Style template** {applies_to}`stack: ga 9.5` {applies_to}`serverless: ga` : Apply a preset that sets the position and alignment of the primary metric, title, and secondary value in one step. Choose between: - - **Top**: Primary value and title at the top, secondary value below. All elements are left-aligned. + - **Top**: Primary value and title at the top, secondary value below. All elements are left-aligned. - **Middle**: Title at the top, primary value centered, secondary value below. All elements are center-aligned. - - **Bottom**: Title at the top, secondary and primary values at the bottom. The primary and secondary values are right-aligned. New metric visualizations use this template by default. - - **Custom**: Keep your individual appearance settings. Select **Custom**, then adjust each control independently in the **Details** section. Lens switches to **Custom** automatically when your settings no longer match any preset. + - **Bottom**: Title at the top, secondary and primary values at the bottom. The primary and secondary values are right-aligned. New metric visualizations use this template by default. + - **Custom**: Keep your individual appearance settings. Select **Custom**, then adjust each control independently in the **Details** section. Lens switches to **Custom** automatically when your settings no longer match any preset. The detailed appearance controls described in the next section are grouped under a **Details** accordion. Select **Details** to expand the section and adjust individual settings, or select a different template to apply its preset values to all styling settings at once. diff --git a/explore-analyze/visualize/charts/mosaic-charts.md b/explore-analyze/visualize/charts/mosaic-charts.md index d5336b31e4..6597bf9f0e 100644 --- a/explore-analyze/visualize/charts/mosaic-charts.md +++ b/explore-analyze/visualize/charts/mosaic-charts.md @@ -88,27 +88,23 @@ The **Horizontal axis** dimension defines the columns of the mosaic. Column widt **Data** : The **Horizontal axis** dimension supports the following functions: - - **Top values**: Create columns for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term columns. When multiple fields are selected, each column represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many categories to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data into time-based buckets. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - - **Intervals**: Create numeric ranges for continuous data. - - **Field**: Select the numeric field to create intervals from. - - **Include empty rows**: Include intervals with no matching documents. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - - **Filters**: Define custom KQL filters to create specific columns. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: + + :::{include} ../../_snippets/lens-collapse-by.md + ::: **Appearance** : - **Name**: Customize the axis label. @@ -121,27 +117,23 @@ The **Vertical axis** dimension defines the rows within each column. Rectangle h **Data** : The **Vertical axis** dimension supports the following functions: - - **Top values**: Create rows for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term rows. When multiple fields are selected, each row represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many categories to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 3. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data into time-based buckets. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - - **Intervals**: Create numeric ranges for continuous data. - - **Field**: Select the numeric field to create intervals from. - - **Include empty rows**: Include intervals with no matching documents. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - - **Filters**: Define custom KQL filters to create specific rows. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: + + :::{include} ../../_snippets/lens-collapse-by.md + ::: **Appearance** : - **Name**: Customize the axis label. diff --git a/explore-analyze/visualize/charts/pie-charts.md b/explore-analyze/visualize/charts/pie-charts.md index 7287cc14fe..6483337e7c 100644 --- a/explore-analyze/visualize/charts/pie-charts.md +++ b/explore-analyze/visualize/charts/pie-charts.md @@ -488,34 +488,23 @@ The **Slice by** dimension defines how your pie is divided into segments. You ca **Data** : The **Slice by** dimension supports the following functions: - - **Top values**: Create slices for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term slices. When multiple fields are selected, each slice represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data into time-based buckets (useful for showing time-based composition). Configure the time interval and how to handle date formatting. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - - **Intervals**: Create numeric ranges for continuous data. Useful for grouping numeric fields into buckets. You can define the interval granularity or specify custom ranges. - - **Field**: Select the numeric field to create intervals from. - - **Include empty rows**: Include intervals with no matching documents. On by default. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - :::{dropdown} How does interval granularity work? - Interval granularity divides the field into evenly spaced intervals based on the minimum and maximum values for the field. - - The size of the interval is a "nice" value. When the granularity of the slider changes, the interval stays the same when the "nice" interval is the same. The minimum granularity is 1, and the maximum value is histogram:maxBars. To change the maximum granularity, go to Advanced settings. - - Intervals are incremented by 10, 5 or 2. For example, an interval can be `100` or `0.2`. - ::: - - **Filters**: Define custom KQL filters to create specific slices. Each filter creates one slice in the chart. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: + + :::{include} ../../_snippets/lens-collapse-by.md + ::: **Appearance** : Configure slice-level options: diff --git a/explore-analyze/visualize/charts/tables.md b/explore-analyze/visualize/charts/tables.md index 8dfb01e557..f6bac2db66 100644 --- a/explore-analyze/visualize/charts/tables.md +++ b/explore-analyze/visualize/charts/tables.md @@ -162,33 +162,23 @@ Customize your table to display exactly the information you need, formatted the : Define which fields create the rows of your table. Drag a field to the **Rows** dimension, and {{kib}} suggests an appropriate function based on the field type. - **Functions**: - - **Top values**: Show the most common values of a categorical field. Configure the number of values to display, ranking criteria, and sort direction. - - **Field**: Select the field to group by. You can add up to 4 fields. When multiple fields are selected, each row represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data by time intervals. Configure the time interval and how to handle date formatting. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Create numeric ranges for continuous data. Useful for grouping numeric fields into buckets. You can define the interval granularity or specify custom ranges. - - **Field**: Select the numeric field to create intervals from. - :::{dropdown} How does interval granularity work? - Interval granularity divides the field into evenly spaced intervals based on the minimum and maximum values for the field. - - The size of the interval is a "nice" value. When the granularity of the slider changes, the interval stays the same when the “nice” interval is the same. The minimum granularity is 1, and the maximum value is histogram:maxBars. To change the maximum granularity, go to Advanced settings. - - Intervals are incremented by 10, 5 or 2. For example, an interval can be `100` or `0.2`. - ::: - - **Filters**: Define custom KQL filters to create specific row groups. Each filter creates one row in the table. - - - **Collapse by**: Aggregate rows that share the same value for this field into a single row, combining their metrics (for example, sum or average for each group). This is useful when you want to display a consolidated result for grouped values instead of individual rows. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: - + :::{include} ../../_snippets/lens-collapse-by.md + ::: **Appearance** : - **Name**: Customize the column header label for the row dimension. @@ -202,29 +192,20 @@ Customize your table to display exactly the information you need, formatted the : Optionally split your metrics into separate columns based on a categorical field. This creates a pivot table view where each unique value of the split field becomes its own column. This is useful for comparing the same metric across different categories side by side. - **Functions**: - - **Top values**: Show the most common values of a categorical field. Configure the number of values to display, ranking criteria, and sort direction. - - **Field**: Select the field to group by. You can add up to 4 fields. When multiple fields are selected, each column group represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 3. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data by time intervals. Configure the time interval and how to handle date formatting. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Create numeric ranges for continuous data. Useful for grouping numeric fields into buckets. You can define the interval granularity or specify custom ranges. - - **Field**: Select the numeric field to create intervals from. - :::{dropdown} How does interval granularity work? - Interval granularity divides the field into evenly spaced intervals based on the minimum and maximum values for the field. - - The size of the interval is a "nice" value. When the granularity of the slider changes, the interval stays the same when the “nice” interval is the same. The minimum granularity is 1, and the maximum value is histogram:maxBars. To change the maximum granularity, go to Advanced settings. - - Intervals are incremented by 10, 5 or 2. For example, an interval can be `100` or `0.2`. - ::: - - **Filters**: Define custom KQL filters to create specific column groups. Each filter creates one column in the table. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: **Appearance** : - **Name**: Customize the split dimension. This name is not used on the table. diff --git a/explore-analyze/visualize/charts/tag-cloud-charts.md b/explore-analyze/visualize/charts/tag-cloud-charts.md index f3aecd1de3..80def79ec3 100644 --- a/explore-analyze/visualize/charts/tag-cloud-charts.md +++ b/explore-analyze/visualize/charts/tag-cloud-charts.md @@ -82,28 +82,25 @@ Customize your tag cloud chart to display exactly the information you need, form ### Tags settings [tags-settings] -The **Tags** dimension defines the text labels that appear in the cloud. +The **Tags** dimension defines the text labels that appear in the cloud. For best legibility, display 20 to 50 tags. **Data** : The **Tags** dimension supports the following functions: - - **Top values**: Display the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term tags. When multiple fields are selected, each tag represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many tags to display (recommended: 20-50). The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data into time-based buckets. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Intervals**: Create numeric ranges for continuous data. - - **Field**: Select the numeric field to create intervals from. - - **Include empty rows**: Include intervals with no matching documents. - - **Filters**: Define custom KQL filters to create specific tags. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: **Appearance** : - **Name**: Customize the label shown in the visualization title. diff --git a/explore-analyze/visualize/charts/treemap-charts.md b/explore-analyze/visualize/charts/treemap-charts.md index 091237b980..fdb0ba71bc 100644 --- a/explore-analyze/visualize/charts/treemap-charts.md +++ b/explore-analyze/visualize/charts/treemap-charts.md @@ -87,27 +87,23 @@ The **Group by** dimension defines how rectangles are grouped. You can add up to **Data** : The **Group by** dimension supports the following functions: - - **Top values**: Create rectangles for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term groups. When multiple fields are selected, each group represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data into time-based buckets. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - - **Intervals**: Create numeric ranges for continuous data. - - **Field**: Select the numeric field to create intervals from. - - **Include empty rows**: Include intervals with no matching documents. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - - **Filters**: Define custom KQL filters to create specific groups. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: + + :::{include} ../../_snippets/lens-collapse-by.md + ::: **Appearance** : - **Name**: Customize the legend label. diff --git a/explore-analyze/visualize/charts/waffle-charts.md b/explore-analyze/visualize/charts/waffle-charts.md index 6093a32827..9b7eae4795 100644 --- a/explore-analyze/visualize/charts/waffle-charts.md +++ b/explore-analyze/visualize/charts/waffle-charts.md @@ -217,27 +217,23 @@ The **Group by** dimension defines how the waffle is divided into colored sectio **Data** : The **Group by** dimension supports the following functions: - - **Top values**: Create sections for the most common values in a field. - - **Field**: Select the field to group by. You can add up to 4 fields to create multi-term sections. When multiple fields are selected, each section represents a unique combination of values across those fields. You can reorder the fields by dragging them to change their priority. - - **Number of values**: How many top values to display. The default number of values depends on your environment: - - {applies_to}`serverless: ga` {applies_to}`stack: ga 9.4` Defaults to 9. - - {applies_to}`stack: ga 9.0-9.3` Defaults to 5. + :::{include} ../../_snippets/lens-bucket-top-values.md + ::: :::{include} ../../_snippets/lens-rank-by-options.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. :::{include} ../../_snippets/lens-breakdown-advanced-settings.md ::: - - **Date histogram**: Group data into time-based buckets. - - **Field**: Select the date field to use for the time-based grouping. + :::{include} ../../_snippets/lens-bucket-date-histogram.md + ::: :::{include} ../../_snippets/lens-histogram-settings.md ::: - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - - **Intervals**: Create numeric ranges for continuous data. - - **Field**: Select the numeric field to create intervals from. - - **Include empty rows**: Include intervals with no matching documents. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. - - **Filters**: Define custom KQL filters to create specific sections. - - **Collapse by**: Aggregate values into a single number using `Sum`, `Average`, `Min`, or `Max`. + :::{include} ../../_snippets/lens-bucket-intervals.md + ::: + :::{include} ../../_snippets/lens-bucket-filters.md + ::: + + :::{include} ../../_snippets/lens-collapse-by.md + ::: **Appearance** : - **Name**: Customize the legend label.