0
0
Fork 0
mirror of https://github.com/netdata/netdata.git synced 2025-04-29 23:20:01 +00:00
netdata_netdata/docs/dashboards-and-charts/top-tab.md
kanelatechnical 4c96a564ee
Dashboards and charts (#20162)
Co-authored-by: Ilya Mashchenko <ilya@netdata.cloud>
2025-04-23 12:23:23 +00:00

76 lines
No EOL
3.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Top Tab
The **Top tab** gives you access to [Netdata Functions](/docs/top-monitoring-netdata-functions.md) that can be executed on any node running the Netdata Agent. These specialized routines, provided by various collectors, offer enhanced insights and allow you to trigger specific actions directly on the monitored node.
You can **use these Functions to**:
- **Retrieve** extra diagnostic **information**
- Perform actions to support **troubleshooting directly on the node**
:::tip
You can also execute a Function from the [Nodes tab](/docs/dashboards-and-charts/nodes-tab.md) by pressing the `f(x)` button next to the node.
:::
:::note
If you receive an error saying that your node cant execute Functions, check the [prerequisites](/docs/top-monitoring-netdata-functions.md) to ensure your node is configured properly.
:::
---
## Top Tab Structure Overview
```mermaid
graph TD
A[Functions Bar]
A --> B[Function Execution]
B --> C[Visualization]
C --> D[Results Table]
```
:::tip
The diagram above shows how Function selection and execution work in the Top tab, helping you visualize the flow from choosing a Function to viewing the results.
:::
---
## Top Tab View
The main view of the Top tab provides two elements, depending on the selected Function:
| Element | Description |
|-------------------|------------------------------------------------------------------------------------------------------------------------------|
| **Visualization** | Located at the top of the page. The type of visualization depends on the selected Function and may allow user customization. |
| **Data Table** | Located below the visualization. Displays detailed results from the executed Function. |
### View Controls
You can control the data refresh and update settings in the top right-hand corner of the view:
| Control | Description |
|-------------------------|--------------------------------------------------------------------------|
| **Refresh results** | Manually refresh results (works when the dashboard is in `Paused` mode). |
| **Set update interval** | Configure how often the results should refresh. |
---
## Functions Bar
The **Functions bar**, located on the right-hand side of the Top tab, lets you select which Function to run, on which node, and apply filtering where available.
| Option | Description |
|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Select Function** | Choose the Function to run from the available routines. |
| **Select Node** | Select the node where the Function will execute. |
| **Apply Filtering** | Narrow down results using the available filters. <br/> Example for the `Block-devices` Function: <br/> - Device <br/> - Type <br/> - ID <br/> - Model <br/> - Serial number |
:::tip
The available filters depend on the Function you select. After choosing the Function, use the filters provided to narrow down the results and focus on the data you need.
:::