advanced options for main data configs

Author: florent-leborgne

explore-analyze/_snippets/lens-breakdown-advanced-settings.md

@@ -0,0 +1,9 @@
+:::{dropdown} Advanced settings
+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.
+:::

explore-analyze/_snippets/lens-value-advanced-settings.md

@@ -0,0 +1,9 @@
+:::{dropdown} Advanced settings
+Depending on the data you defined, several options allow you to apply additional filtering to the data taken into account to compute the metric's value:
+    
+- **Normalize by unit**: Normalize the metric values to show per unit of time.
+- **Filter by**: Specify a query.
+- **Reduced time range**: Reduce the time range specified on the dashboard's time filter by the specified duration.
+- **Time shift**: Shift the time range by the specified duration.
+- **Hide zero values**: Don't show values equal to zero. This option is on by default.
+:::

explore-analyze/visualize/metric-charts.md

@@ -190,7 +190,8 @@ Customize your metric chart to display exactly the information you need, formatt
 **Value**
 :   The main numeric value that appears prominently in your chart. When you drag a field onto the chart, {{kib}} suggests a function based on the field type. You can change it and use aggregation functions like `Sum`, `Average`, `Count`, `Median`, and more, or create custom calculations with formulas. Refer to [](/explore-analyze/visualize/lens.md#lens-formulas) for examples, or to the {icon}`documentation` **Formula reference** available from Lens.
 
-% todo: advanced options
+    :::{include} ../_snippets/lens-value-advanced-settings.md
+    :::
 
 **Appearance**
 :   Define the formatting of the primary metric, including:
@@ -212,7 +213,8 @@ Customize your metric chart to display exactly the information you need, formatt
     * Different aggregations on the same data (for example, showing both average and median response times)
     * Related metrics for context (for example, showing total count alongside an average)
 
-% todo: advanced options
+    :::{include} ../_snippets/lens-value-advanced-settings.md
+    :::
 
 **Appearance**
 :   Define the formatting of the secondary metric, including:
@@ -227,7 +229,8 @@ Customize your metric chart to display exactly the information you need, formatt
 **Value**
 :   An optional reference value that defines the upper bound for your metric. When you specify a maximum, you can show a progress bar by setting the primary metric's **Supporting visualization** option to **Bar**. This is useful for showing progress toward goals or capacity limits.
 
-% todo: advanced options
+    :::{include} ../_snippets/lens-value-advanced-settings.md
+    :::
 
 **Appearance**
 :   Define the formatting of the secondary metric, including:
@@ -236,9 +239,15 @@ 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 assign [consistent colors](lens.md#assign-colors-to-terms) to each breakdown value for better recognition across your dashboards.
+:   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:
 
-% todo: basic and advanced options
+    - **Number of values**: The number of tiles to show. 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.
+    - **Rank by**: The dimension top values are ranked by.
+    - **Rank direction**: The direction to use for the ranking.
+    - **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
+    :::
 
 **Appearance**
 :   Define the formatting of the secondary metric, including: