Merging upstream version 1.46.3.

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

1 files changed, 27 insertions, 0 deletions

diff --git a/docs/dashboards-and-charts/top-tab.md b/docs/dashboards-and-charts/top-tab.md
new file mode 100644
index 000000000..4edaf32f9
--- /dev/null
+++ b/docs/dashboards-and-charts/top-tab.md
@@ -0,0 +1,27 @@
+# Top tab
+
+The Top tab allows you to run [Netdata Functions](/docs/top-monitoring-netdata-functions.md) on a node where a Netdata Agent is running. These routines are exposed by a given collector.
+They can be used to retrieve additional information to help you troubleshoot or to trigger some action to happen on the node itself.
+
+> **Tip**
+>
+> You can also execute a Function from the [Nodes tab](/docs/dashboards-and-charts/nodes-tab.md), by pressing the `f(x)` button.
+
+> **Note**
+>
+> If you get an error saying that your node can't execute Functions please check the [prerequisites](/docs/top-monitoring-netdata-functions.md#prerequisites).
+
+The main view of this tab provides you with (depending on the Function) two elements: a visualization on the top and a table on the bottom.
+
+Visualizations vary depending on the Function and most allow for user customization.
+
+On the top right-hand corner you can:
+
+- Refresh the results (Given that the dashboard is on `Paused` mode)
+- Set the update interval of the results.
+
+## Functions bar
+
+The bar on the right-hand side allows you to select which Function to run, on which node, and then depending on the Function, there might be more fine-grained filtering available.
+
+For example the `Block-devices` Function allows you to filter per Device, Type, ID, Model and Serial number or the Block devices on your node.