Merging upstream version 1.40.0.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 224 insertions, 180 deletions

diff --git a/docs/cloud/visualize/interact-new-charts.md b/docs/cloud/visualize/interact-new-charts.md
index 4c6c2ebf5..3707e945f 100644
--- a/docs/cloud/visualize/interact-new-charts.md
+++ b/docs/cloud/visualize/interact-new-charts.md
@@ -8,129 +8,136 @@ To make sense of all the metrics, Netdata offers an enhanced version of charts t
 These charts provide a lot of useful information, so that you can:
 
 - Enjoy the high-resolution, granular metrics collected by Netdata
-- Explore visualization with more options such as _line_, _stacked_ and _area_ types (other types like _bar_, _pie_ and
-  _gauges_ are to be added shortly)
 - Examine all the metrics by hovering over them with your cursor
-- Use intuitive tooling and shortcuts to pan, zoom or highlight your charts
-- On highlight, ease access
-  to [Metric Correlations](https://github.com/netdata/netdata/blob/master/docs/cloud/insights/metric-correlations.md) to
-  see other metrics with similar patterns
+- Filter the metrics in any way you want using the [Definition bar](#definition-bar)
+- View the combined anomaly rate of all underlying data with the [Anomaly Rate ribbon](#anomaly-rate-ribbon)
+- Explore even more details about a chart's metrics through [hovering over certain elements of it](#hover-over-the-chart)
+- Use intuitive tooling and shortcuts to pan, zoom or highlight areas of interest in your charts
+- On highlight, get easy access to [Metric Correlations](https://github.com/netdata/netdata/blob/master/docs/cloud/insights/metric-correlations.md) to see other metrics with similar patterns
 - Have the dimensions sorted based on name or value
 - View information about the chart, its plugin, context, and type
-- Get the chart status and possible errors. On top, reload functionality
+- View individual metric collection status about a chart
 
-These charts are available on Netdata Cloud's 
+These charts are available on Netdata Cloud's
 [Overview tab](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/overview.md), Single Node tab and
 on your [Custom Dashboards](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/dashboards.md).
 
-Some of the features listed below are also available on the simpler charts that are available on each agent's user interface.
-
 ## Overview
 
-Have a look at the can see the overall look and feel of the charts for both with a composite chart from
-the [Overview tab](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/overview.md) and a simple chart
-from the Single Node tab:
+A Netdata chart looks like this:  
 
-<img width="678" alt="image" src="https://user-images.githubusercontent.com/43294513/220913360-f3f2ac06-b715-4e99-a933-f3bcb776636f.png"/>
+<img src="https://user-images.githubusercontent.com/70198089/236133212-353c102f-a6ed-45b7-9251-34e004c7a10a.png"  width="900"/>
 
 With a quick glance you have immediate information available at your disposal:
 
-- Chart title and units
-- Definition bar
-- Action bars
-- Chart area
-- Legend with dimensions
+- [Chart title and units](#title-bar)
+- [Anomaly Rate ribbon](#anomaly-rate-ribbon)
+- [Definition bar](#definition-bar)
+- [Tool bar](#tool-bar)
+- [Chart area](#hover-over-the-chart)
+- [Legend with dimensions](#dimensions-bar)
 
-## Play, Pause and Reset
+## Title bar
 
-Your charts are controlled using the available 
-[Time controls](https://github.com/netdata/netdata/blob/master/docs/dashboard/visualization-date-and-time-controls.md#time-controls).
-Besides these, when interacting with the chart you can also activate these controls by:
+When you start interacting with a chart, you'll notice valuable information on the top bar:
 
-- Hovering over any chart to temporarily pause it - this momentarily switches time control to Pause, so that you can
-  hover over a specific timeframe. When moving out of the chart time control will go back to Play (if it was it's
-  previous state)
-- Clicking on the chart to lock it - this enables the Pause option on the time controls, to the current timeframe. This
-  is if you want to jump to a different chart to look for possible correlations.
-- Double clicking to release a previously locked chart - move the time control back to Play
+<img src="https://user-images.githubusercontent.com/70198089/236133832-fad45e65-5bd6-4fd1-8d68-33acf69fff5c.png" width="900"/>
 
-| Interaction       | Keyboard/mouse | Touchpad/touchscreen | Time control          |
-|:------------------|:---------------|:---------------------|:----------------------|
-| **Pause** a chart | `hover`        | `n/a`                | Temporarily **Pause** |
-| **Stop** a chart  | `click`        | `tap`                | **Pause**             |
-| **Reset** a chart | `double click` | `n/a`                | **Play**              |
+The elements that you can find on this top bar are:
 
-Note: These interactions are available when the default "Pan" action is used. Other actions are accessible via
-the [Exploration action bar](#exploration-action-bar).
+- **Netdata icon**: this indicates that data is continuously being updated, this happens if [Time controls](https://github.com/netdata/netdata/blob/master/docs/dashboard/visualization-date-and-time-controls.md#time-controls) are in Play or Force Play mode.
+- **Chart title**: on the chart title you can see the title together with the metric being displayed, as well as the unit of measurement.
+- **Chart status icon**: possible values are: Loading, Timeout, Error or No data, otherwise this icon is not shown.
 
-## Title and chart action bar
+Along with viewing chart type, context and units, on this bar you have access to immediate actions over the chart:
 
-When you start interacting with a chart, you'll notice valuable information on the top bar. You will see information
-from the chart title to a chart action bar.
+<img src="https://user-images.githubusercontent.com/70198089/236134195-ecb08f79-1355-4bce-8449-e829f4a6b1c0.png" width="200" />
 
-The elements that you can find on this top bar are:
+- **Chart info**: get more information relevant to the chart you are interacting with.
+- **Chart type**: change the chart type from **line**, **stacked**, **area**, **stacked bar** and **multi bar**.
+- **Enter fullscreen mode**: expand the current chart to the full size of your screen.
+- **Add chart to dashboard**: add the chart to an existing custom dashboard or directly create a new one that includes the chart.
 
-- Netdata icon: this indicates that data is continuously being updated, this happens
-  if [Time controls](https://github.com/netdata/netdata/blob/master/docs/dashboard/visualization-date-and-time-controls.md#time-controls)
-  are in Play or Force Play mode
-- Chart status icon: indicates the status of the chart. Possible values are: Loading, Timeout, Error or No data
-- Chart title: on the chart title you can see the title together with the metric being displayed, as well as the unit of
-  measurement
-- Chart action bar: here you'll have access to chart info, change chart types, enables fullscreen mode, and the ability
-  to add the chart to a custom dashboard
+## Definition bar
 
-![image](https://user-images.githubusercontent.com/70198089/222689197-f9506ca7-a869-40a9-871f-8c4e1fa4b927.png)
+Each composite chart has a definition bar to provide information and options about the following:
 
+<img src="https://user-images.githubusercontent.com/70198089/236134615-e53a1d68-8a0f-466b-b2ef-1974085f0e8d.png" width="900"/>
+
+- Group by option
+- Aggregate function to be applied in case multiple data sources exist
+- Nodes filter
+- Instances filter
+- Dimensions filter
+- Labels filter
+- The aggregate function over time to be applied if one point in the chart consists of multiple data points aggregated
+- Resetting the Definition bar
+
+### NIDL framework
+
+To help users instantly understand and validate the data they see on charts, we developed the NIDL (Nodes, Instances, Dimensions, Labels) framework. This information is visualized on all charts.
+
+
+> You can explore the in-depth infographic, by clicking on this image and opening it in a new tab,
+> allowing you to zoom in to the different parts of it.
+>
+> <a href="https://user-images.githubusercontent.com/2662304/235475061-44628011-3b1f-4c44-9528-34452018eb89.png" target="_blank">
+>  <img src="https://user-images.githubusercontent.com/2662304/235475061-44628011-3b1f-4c44-9528-34452018eb89.png" width="400" border="0" align="center"/>
+> </a>
 
-## Definition bar
 
-Each composite chart has a definition bar to provide information about the following:
+You can rapidly access condensed information for collected metrics, grouped by node, monitored instances, dimension, or any key/value label pair.
 
-* Grouping option
-* Aggregate function to be applied in case multiple data sources exist
-* Instances
-* Nodes
-* Dimensions, and
-* Aggregate function over time to be applied if one point in the chart consists of multiple data points aggregated
+At the Definition bar of each chart, there are a few dropdown menus:
 
-### Group by dimension, node, or chart
+<img src="https://user-images.githubusercontent.com/43294513/235470150-62a3b9ac-51ca-4c0d-81de-8804e3d733eb.png" width="900"/>
 
-Click on the **dimension** dropdown to change how a composite chart groups metrics.
+These dropdown menus have 2 functions:
 
-The default option is by _dimension_, so that each line/area in the visualization is the aggregation of a single
-dimension.
-This provides a per dimension view of the data from all the nodes in the War Room, taking into account filtering
-criteria if defined.
+1. Provide additional information about the visualized chart, to help with understanding the data that is presented.
+2. Provide filtering and grouping capabilities, altering the query on the fly, to help get different views of the dataset.
 
-A composite chart grouped by _node_ visualizes a single metric across contributing nodes. If the composite chart has
-five
-contributing nodes, there will be five lines/areas. This is typically an absolute value of the sum of the dimensions
-over each node but there
-are some opinionated-but-valuable exceptions where a specific dimension is selected.
-Grouping by nodes allows you to quickly understand which nodes in your infrastructure are experiencing anomalous
-behavior.
+The NIDL framework attaches metadata to every metric that is collected to provide for each of them the following consolidated data for the visible time frame:
 
-A composite chart grouped by _instance_ visualizes each instance of one software or hardware on a node and displays
-these as a separate dimension. By grouping the
-`disk.io` chart by _instance_, you can visualize the activity of each disk on each node that contributes to the
-composite
-chart.
+1. The volume contribution of each metric into the final query. So even if a query comes from 1000 nodes, the contribution of each node in the result can instantly be visualized. The same goes for instances, dimensions and labels. Especially for labels, Netdata also provides the volume contribution of each label `key:value` pair to the final query, so that you can immediately see how much every label value involved in the query affected the chart.
+2. The anomaly rate of each of them for the time-frame of the query. This is used to quickly spot which of the nodes, instances, dimensions or labels have anomalies in the requested time-frame.
+3. The minimum, average and maximum values of all the points used for the query. This is used to quickly spot which of the nodes, instances, dimensions or labels are responsible for a spike or a dive in the chart.
 
-Another very pertinent example is composite charts over contexts related to cgroups (VMs and containers). You have the
-means to change the default group by or apply filtering to
-get a better view into what data your are trying to analyze. For example, if you change the group by to _instance_ you
-get a view with the data of all the instances (cgroups) that
-contribute to that chart. Then you can use further filtering tools to focus the data that is important to you and even
-save the result to your own dashboards.
+All of these dropdown menus can be used for instantly filtering the information shown, by including or excluding specific nodes, instances, dimensions or labels. Directly from the dropdown menu, without the need to edit a query string and without any additional knowledge of the underlying data.
 
-![image](https://user-images.githubusercontent.com/82235632/201902017-04b76701-0ff9-4498-aa9b-6d507b567bea.png)
+### Group by dropdown
 
-### Aggregate functions over data sources
+The "Group by" dropdown menu allows selecting 1 or more groupings to be applied at once on the same dataset.
 
-Each chart uses an opinionated-but-valuable default aggregate function over the data sources. For example,
-the `system.cpu` chart shows the
-average for each dimension from every contributing chart, while the `net.net` chart shows the sum for each dimension
-from every contributing chart, which can also come from multiple networking interfaces.
+<img src="https://user-images.githubusercontent.com/43294513/235468819-3af5a1d3-8619-48fb-a8b7-8e8b4cf6a8ff.png" width="900"/>
+
+It supports:
+
+1. **Group by Node**, to summarize the data of each node, and provide one dimension on the chart for each of the nodes involved. Filtering nodes is supported at the same time, using the nodes dropdown menu.
+2. **Group by Instance**, to summarize the data of each instance and provide one dimension on the chart for each of the instances involved. Filtering instances is supported at the same time, using the instances dropdown menu.
+3. **Group by Dimension**, so that each metric in the visualization is the aggregation of a single dimension. This provides a per dimension view of the data from all the nodes in the War Room, taking into account filtering criteria if defined.
+4. **Group by Label**, to summarize the data for each label value. Multiple label keys can be selected at the same time.
+
+Using this menu, you can slice and dice the data in any possible way, to quickly get different views of it, without the need to edit a query string and without any need to better understand the format of the underlying data.
+
+> ### Tip
+>
+> A very pertinent example is composite charts over contexts related to cgroups (VMs and containers).
+> You have the means to change the default group by or apply filtering to get a better view into what data your are trying to analyze.
+> For example, if you change the group by to _instance_ you get a view with the data of all the instances (cgroups) that contribute to that chart.
+> Then you can use further filtering tools to focus the data that is important to you and even save the result to your own dashboards.
+
+> ### Tip
+>
+> Group by instance, dimension to see the time series of every individual collected metric participating in the chart.
+
+### Aggregate functions over data sources dropdown
+
+Each chart uses an opinionated-but-valuable default aggregate function over the data sources.
+
+<img src="https://user-images.githubusercontent.com/70198089/236136725-778670b4-7e81-44a8-8d3d-f38ded823c94.png" width="500"/>
+
+For example, the `system.cpu` chart shows the average for each dimension from every contributing chart, while the `net.net` chart shows the sum for each dimension from every contributing chart, which can also come from multiple networking interfaces.
 
 The following aggregate functions are available for each selected dimension:
 
@@ -144,105 +151,148 @@ The following aggregate functions are available for each selected dimension:
 - **Max**: Displays a maximum value. For dimensions with positive values, the max is the value with the largest
   magnitude. For charts with negative values, the max is the value closet to zero.
 
-### Dimensions
-
-Select which dimensions to display on the composite chart. You can choose **All dimensions**, a single dimension, or any
-number of dimensions available on that context.
+### Nodes dropdown
 
-### Instances
+In this dropdown, you can view or filter the nodes contributing time-series metrics to the chart.  
+This menu also provides the contribution of each node to the volume of the chart, and a break down of the anomaly rate of the queried data per node.
 
-Click on **X Instances** to display a dropdown of instances and nodes contributing to that composite chart. Each line in
-the dropdown displays an instance name and the associated node's hostname.
-
-### Nodes
-
-Click on **X Nodes** to display a dropdown of nodes contributing to that composite chart. Each line displays a hostname
-to help you identify which nodes contribute to a chart. You can also use this component to filter nodes directly on the
-chart.
+<img src="https://user-images.githubusercontent.com/70198089/236137765-b57d5443-3d4b-42f4-9e3d-db1eb606626f.png" width="900"/>
 
 If one or more nodes can't contribute to a given chart, the definition bar shows a warning symbol plus the number of
 affected nodes, then lists them in the dropdown along with the associated error. Nodes might return errors because of
 networking issues, a stopped `netdata` service, or because that node does not have any metrics for that context.
 
+### Instances dropdown
+
+In this dropdown, you can view or filter the instances contributing time-series metrics to the chart.  
+This menu also provides the contribution of each instance to the volume of the chart, and a break down of the anomaly rate of the queried data per instance.
+
+<img src="https://user-images.githubusercontent.com/70198089/236138302-4dd4072e-3a0d-43bb-a9d8-4dde79c65e92.png" width="900"/>
+
+### Dimensions dropdown
+
+In this dropdown, you can view or filter the original dimensions contributing time-series metrics to the chart.  
+This menu also presents the contribution of each original dimensions on the chart, and a break down of the anomaly rate of the data per dimension.
+
+<img src="https://user-images.githubusercontent.com/70198089/236138796-08dc6ac6-9a50-4913-a46d-d9bbcedd48f6.png" width="900"/>
+
+
+### Labels dropdown
+
+In this dropdown, you can view or filter the contributing time-series labels of the chart.  
+This menu also presents the contribution of each label on the chart,and a break down of the anomaly rate of the data per label.
+
+<img src="https://user-images.githubusercontent.com/70198089/236139027-8a51a958-2074-4675-a41b-efff30d8f51a.png" width="900"/>
+
 ### Aggregate functions over time
 
 When the granularity of the data collected is higher than the plotted points on the chart an aggregation function over
-time
-is applied. By default the aggregation applied is _average_ but the user can choose different options from the
-following:
-
-* Min
-* Max
-* Average
-* Sum
-* Incremental sum (Delta)
-* Standard deviation
-* Median
-* Single exponential smoothing
-* Double exponential smoothing
-* Coefficient variation
-* Trimmed Median `*`
-* Trimmed Mean `*`
-* Percentile `**`
-
-> ### Info
->
-> - `*` For **Trimmed Median and Mean** you can choose the percentage of data tha you want to focus on: 1%, 2%, 3%, 5%, 10%, 15%, 20% and 25%.
-> - `**` For **Percentile** you can specify the percentile you want to focus on: 25th, 50th, 75th, 80th, 90th, 95th, 97th, 98th and 99th.
+time is applied.
+
+<img src="https://user-images.githubusercontent.com/70198089/236411297-e123db06-0117-4e24-a5ac-955b980a8f55.png" width="400"/>
+
+By default the aggregation applied is _average_ but the user can choose different options from the following:
 
-For more details on each, you can refer to our Agent's HTTP API details
-on [Data Queries - Data Grouping](https://github.com/netdata/netdata/blob/master/web/api/queries/README.md#data-grouping).
+- Min, Max, Average or Sum
+- Percentile
+  - you can specify the percentile you want to focus on: 25th, 50th, 75th, 80th, 90th, 95th, 97th, 98th and 99th.  
+    <img src="https://user-images.githubusercontent.com/70198089/236410299-de5f3367-f3b0-4beb-a73f-a49007c543d4.png" width="250"/>
+- Trimmed Mean or Trimmed Median
+  - you can choose the percentage of data tha you want to focus on: 1%, 2%, 3%, 5%, 10%, 15%, 20% and 25%.  
+    <img src="https://user-images.githubusercontent.com/70198089/236410858-74b46af9-280a-4ab2-ad26-5a6aa9403aa8.png" width="250"/>
+- Median
+- Standard deviation
+- Coefficient of variation
+- Delta
+- Single or Double exponential smoothing
+
+For more details on each, you can refer to our Agent's HTTP API details on [Data Queries - Data Grouping](https://github.com/netdata/netdata/blob/master/web/api/queries/README.md#data-grouping).
 
 ### Reset to defaults
 
-Click on the 3-dot icon (**⋮**) on any chart, then **Reset to Defaults**, to reset the definition bar to its initial
-state.
+Finally, you can reset everything to its defaults by clicking the green "Reset" prompt at the end of the definition bar.
+
+## Anomaly Rate ribbon
+
+Netdata's unsupervised machine learning algorithm creates a unique model for each metric collected by your agents, using exclusively the metric's past data.
+It then uses these unique models during data collection to predict the value that should be collected and check if the collected value is within the range of acceptable values based on past patterns and behavior.
+
+If the value collected is an outlier, it is marked as anomalous.
+
+<img src="https://user-images.githubusercontent.com/70198089/236139886-79d63cf6-61ed-4aa7-842c-b5a1728c870d.png" width="900"/>
+
+This unmatched capability of real-time predictions as data is collected allows you to **detect anomalies for potentially millions of metrics across your entire infrastructure within a second of occurrence**.
+
+The Anomaly Rate ribbon on top of each chart visualizes the combined anomaly rate of all the underlying data, highlighting areas of interest that may not be easily visible to the naked eye.
+
+Hovering over the Anomaly Rate ribbon provides a histogram of the anomaly rates per presented dimension, for the specific point in time.  
+
+Anomaly Rate visualization does not make Netdata slower. Anomaly rate is saved in the the Netdata database, together with metric values, and due to the smart design of Netdata, it does not even incur a disk footprint penalty.
 
-## Jump to single-node dashboards
+## Hover over the chart
 
-Click on **X Charts**/**X Nodes** to display one of the two dropdowns that list the charts and nodes contributing to a
-given composite chart. For example, the nodes dropdown.
+Hovering over any point in the chart will reveal a more informative overlay.
+It includes a bar indicating the volume percentage of each time series compared to the total, the anomaly rate, and a notification on if there are data collection issues.
 
-![The nodes dropdown in a composite chart](https://user-images.githubusercontent.com/1153921/99305049-7c019b80-2810-11eb-942a-8ebfcf236b7f.png)
+This overlay sorts all dimensions by value, makes bold the closest dimension to the mouse and presents a histogram based on the values of the dimensions.
 
-To jump to a single-node dashboard, click on the link icon 
-<img class="img__inline img__inline--link" src="https://user-images.githubusercontent.com/1153921/95762109-1d219300-0c62-11eb-8daa-9ba509a8e71c.png" /> next to the
-node you're interested in.
+<img src="https://user-images.githubusercontent.com/70198089/236141460-bfa66b99-d63c-4a2c-84b1-2509ed94857f.png" width="500"/>
 
-The single-node dashboard opens in a new tab. From there, you can continue to troubleshoot or run 
-[Metric Correlations](https://github.com/netdata/netdata/blob/master/docs/cloud/insights/metric-correlations.md) for faster root
-cause analysis.
+When hovering the anomaly ribbon, the overlay sorts all dimensions by anomaly rate, and presents a histogram of these anomaly rates.
 
-## Add composite charts to a dashboard
+#### Info column
 
-Click on the 3-dot icon (**⋮**) on any chart, then click on **Add to Dashboard**. Click the **+** button for any
-dashboard you'd like to add this composite chart to, or create a new dashboard an initiate it with your chosen chart by
-entering the name and clicking **New Dashboard**.
+Additionally, when hovering over the chart, the overlay may display an indication in the "Info" column.
 
-## Chart action bar
+Currently, this column is used to inform users of any data collection issues that might affect the chart.
+Below each chart, there is an information ribbon. This ribbon currently shows 3 states related to the points presented in the chart:
 
-On this bar you have access to immediate actions over the chart, the available actions are:
+1. **[P]: Partial Data**
+   At least one of the dimensions in the chart has partial data, meaning that not all instances available contributed data to this point. This can happen when a container is stopped, or when a node is restarted. This indicator helps to gain confidence of the dataset, in situations when unusual spikes or dives appear due to infrastructure maintenance, or due to failures to part of the infrastructure.
 
-- Chart info: you will be able to get more information relevant to the chart you are interacting with
-- Chart type: change the chart type from _line_, _stacked_ or _area_
-- Enter fullscreen mode: allows you expand the current chart to the full size of your screen
-- Add chart to dashboard: This allows you to add the chart to an existing custom dashboard or directly create a new one
-  that includes the chart.
+2. **[O]: Overflown**
+   At least one of the data sources included in the chart has a counter that has overflowed at this point.
 
-<img src="https://user-images.githubusercontent.com/70198089/222689501-4116f5fe-e447-4359-83b5-62dadb33f4ef.png" width="40%" height="40%" />
+3. **[E]: Empty Data**
+   At least one of the dimensions included in the chart has no data at all for the given points.
 
+All these indicators are also visualized per dimension, in the pop-over that appears when hovering the chart.
 
-## Exploration action bar
+<img src="https://user-images.githubusercontent.com/70198089/236145768-8ffadd02-93a4-4e9e-b4ae-c1367f614a7e.png" width="700"/>
 
-When exploring the chart you will see a second action bar. This action bar is there to support you on this task. The
-available actions that you can see are:
+## Play, Pause and Reset
+
+Your charts are controlled using the available [Time controls](https://github.com/netdata/netdata/blob/master/docs/dashboard/visualization-date-and-time-controls.md#time-controls).
+Besides these, when interacting with the chart you can also activate these controls by:
+
+- Hovering over any chart to temporarily pause it - this momentarily switches time control to Pause, so that you can
+  hover over a specific timeframe. When moving out of the chart time control will go back to Play (if it was it's
+  previous state)
+- Clicking on the chart to lock it - this enables the Pause option on the time controls, to the current timeframe. This
+  is if you want to jump to a different chart to look for possible correlations.
+- Double clicking to release a previously locked chart - move the time control back to Play
+
+| Interaction       | Keyboard/mouse | Touchpad/touchscreen | Time control          |
+|:------------------|:---------------|:---------------------|:----------------------|
+| **Pause** a chart | `hover`        | `n/a`                | Temporarily **Pause** |
+| **Stop** a chart  | `click`        | `tap`                | **Pause**             |
+| **Reset** a chart | `double click` | `n/a`                | **Play**              |
+
+Note: These interactions are available when the default "Pan" action is used from the [Tool Bar](#tool-bar).
+
+## Tool bar
+
+While exploring the chart, a tool bar will appear. This tool bar is there to support you on this task.
+The available manipulation tools you can select are:
+
+<img src="https://user-images.githubusercontent.com/70198089/236143292-c1d75528-263d-4ddd-9db8-b8d6a31cb83e.png" width="400" />
 
 - Pan
 - Highlight
-- Horizontal and Vertical zooms
-- In-context zoom in and out
+- Select and zoom
+- Chart zoom
+- Reset zoom
 
-<img src="https://user-images.githubusercontent.com/70198089/222689556-58ad77bc-924f-4c3f-b38b-fc63de2f5773.png" width="40%" height="40%" />
 
 ### Pan
 
@@ -258,47 +308,45 @@ it like pushing the current timeframe off the screen to see what came before or
 Selecting timeframes is useful when you see an interesting spike or change in a chart and want to investigate further by:
 
 - Looking at the same period of time on other charts/sections
-- Running [metric correlations](https://github.com/netdata/netdata/blob/master/docs/cloud/insights/metric-correlations.md)
-  to filter metrics that also show something different in the selected period, vs the previous one 
-
-<img alt="image" src="https://user-images.githubusercontent.com/43294513/221365853-1142944a-ace5-484a-a108-a205d050c594.png" />
+- Running [metric correlations](https://github.com/netdata/netdata/blob/master/docs/cloud/insights/metric-correlations.md) to filter metrics that also show something different in the selected period, vs the previous one
 
 | Interaction                        | Keyboard/mouse                                           | Touchpad/touchscreen |
 |:-----------------------------------|:---------------------------------------------------------|:---------------------|
 | **Highlight** a specific timeframe | `Alt + mouse selection` or `⌘ + mouse selection` (macOS) | `n/a`                |
 
-### Zoom
+### Select and zoom
 
-Zooming in helps you see metrics with maximum granularity, which is useful when you're trying to diagnose the root cause
-of an anomaly or outage. Zooming out lets you see metrics within the larger context, such as the last hour, day, or
-week, which is useful in understanding what "normal" looks like, or to identify long-term trends, like a slow creep in
-memory usage.
+You can zoom to a specific timeframe, either horizontally of vertically, by selecting a timeframe.
 
-The actions above are _normal_ vertical zoom actions. We also provide an horizontal zoom action that helps you focus on
-a specific Y-axis area to further investigate a spike or dive on your charts.
+| Interaction                                | Keyboard/mouse                       | Touchpad/touchscreen                                 |
+|:-------------------------------------------|:-------------------------------------|:-----------------------------------------------------|
+| **Zoom** to a specific timeframe           | `Shift + mouse vertical selection`   | `n/a`                                                |
+| **Horizontal Zoom** a specific Y-axis area | `Shift + mouse horizontal selection` | `n/a`                                                |
 
-![f8722ee8-e69b-426c-8bcb-6cb79897c177](https://user-images.githubusercontent.com/70198089/222689676-ad16a2a0-3c3d-48fa-87af-c40ae142dd79.gif)
+### Chart zoom
 
+Zooming in helps you see metrics with maximum granularity, which is useful when you're trying to diagnose the root cause
+of an anomaly or outage.
 
+Zooming out lets you see metrics within the larger context, such as the last hour, day, or week, which is useful in understanding what "normal" looks like, or to identify long-term trends, like a slow creep in memory usage.
 
 | Interaction                                | Keyboard/mouse                       | Touchpad/touchscreen                                 |
 |:-------------------------------------------|:-------------------------------------|:-----------------------------------------------------|
 | **Zoom** in or out                         | `Shift + mouse scrollwheel`          | `two-finger pinch` <br />`Shift + two-finger scroll` |
-| **Zoom** to a specific timeframe           | `Shift + mouse vertical selection`   | `n/a`                                                |
-| **Horizontal Zoom** a specific Y-axis area | `Shift + mouse horizontal selection` | `n/a`                                                |
-
-You also have two direct action buttons on the exploration action bar for in-context `Zoom in` and `Zoom out`.
 
-## Other interactions
+## Dimensions bar
 
 ### Order dimensions legend
 
-The bottom legend of the chart where you can see the dimensions of the chart can now be ordered by:
+The bottom legend where you can see the dimensions of the chart can be ordered by:
+
+
+<img src="https://user-images.githubusercontent.com/70198089/236144658-6c3d0e31-9bcb-45f3-bb95-4eafdcbb0a58.png" width="300" />
+
 
 - Dimension name (Ascending or Descending)
 - Dimension value (Ascending or Descending)
-
-<img src="https://user-images.githubusercontent.com/70198089/222689791-48c77890-1093-4beb-84c2-7598353ca049.png" width="50%" height="50%" />
+- Dimension Anomaly Rate (Ascending or Descending)
 
 ### Show and hide dimensions
 
@@ -310,10 +358,6 @@ behaving strangely.
 | **Show one** dimension and hide others | `click`         | `tap`                |
 | **Toggle (show/hide)** one dimension   | `Shift + click` | `n/a`                |
 
-### Resize
-
-To resize the chart, click-and-drag the icon on the bottom-right corner of any chart. To restore the chart to its
-original height,
-double-click the same icon.
+## Resize a chart
 
-![1bcc6a0a-a58e-457b-8a0c-e5d361a3083c](https://user-images.githubusercontent.com/70198089/222689845-51a9c054-a57d-49dc-925d-39b924dae2f8.gif)
+To resize the chart, click-and-drag the icon on the bottom-right corner of any chart. To restore the chart to its original height, double-click the same icon.