| 1 | # Live Tab |
| 2 | |
| 3 | The **Live tab** gives you real-time 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, deliver live information from your monitored nodes—including database monitoring functions, network topology maps, process explorers, and more. |
| 4 | |
| 5 | You can **use these Functions to**: |
| 6 | |
| 7 | - **Retrieve** extra diagnostic **information** |
| 8 | - Perform actions to support **troubleshooting directly on the node** |
| 9 | |
| 10 | :::tip |
| 11 | |
| 12 | 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. |
| 13 | |
| 14 | ::: |
| 15 | |
| 16 | :::note |
| 17 | |
| 18 | If you receive an error saying that your node can't execute Functions, check the [prerequisites](/docs/top-monitoring-netdata-functions.md) to ensure your node is configured properly. |
| 19 | |
| 20 | ::: |
| 21 | |
| 22 | ## Live Tab Structure Overview |
| 23 | |
| 24 | ```mermaid |
| 25 | flowchart TD |
| 26 | A("Functions Bar") |
| 27 | A --> B("Function Execution") |
| 28 | B --> C("Visualization") |
| 29 | C --> D("Results Table") |
| 30 | |
| 31 | %% Style definitions |
| 32 | classDef alert fill:#ffeb3b,stroke:#000000,stroke-width:3px,color:#000000,font-size:14px |
| 33 | classDef neutral fill:#f9f9f9,stroke:#000000,stroke-width:3px,color:#000000,font-size:14px |
| 34 | classDef complete fill:#4caf50,stroke:#000000,stroke-width:3px,color:#000000,font-size:14px |
| 35 | classDef database fill:#2196F3,stroke:#000000,stroke-width:3px,color:#000000,font-size:14px |
| 36 | |
| 37 | %% Apply styles |
| 38 | class A alert |
| 39 | class B neutral |
| 40 | class C,D complete |
| 41 | ``` |
| 42 | |
| 43 | :::tip |
| 44 | |
| 45 | The diagram above shows how Function selection and execution work in the Live tab, helping you visualize the flow from choosing a Function to viewing the results. |
| 46 | |
| 47 | ::: |
| 48 | |
| 49 | ## Live Tab View |
| 50 | |
| 51 | The main view of the Live tab provides two elements, depending on the selected Function: |
| 52 | |
| 53 | | Element | Description | |
| 54 | |-------------------|------------------------------------------------------------------------------------------------------------------------------| |
| 55 | | **Visualization** | Located at the top of the page. The type of visualization depends on the selected Function and may allow user customization. | |
| 56 | | **Data Table** | Located below the visualization. Displays detailed results from the executed Function. | |
| 57 | |
| 58 | ### View Controls |
| 59 | |
| 60 | You can control the data refresh and update settings in the top right-hand corner of the view: |
| 61 | |
| 62 | | Control | Description | |
| 63 | |-------------------------|--------------------------------------------------------------------------| |
| 64 | | **Refresh results** | Manually refresh results (works when the dashboard is in `Paused` mode). | |
| 65 | | **Set update interval** | Configure how often the results should refresh. | |
| 66 | |
| 67 | ## Functions Bar |
| 68 | |
| 69 | The **Functions bar**, located on the right-hand side of the Live tab, lets you select which Function to run, on which node, and apply filtering where available. |
| 70 | |
| 71 | | Option | Description | |
| 72 | |---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |
| 73 | | **Select Function** | Choose the Function to run from the available routines. | |
| 74 | | **Select Node** | Select the node where the Function will execute. | |
| 75 | | **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 | |
| 76 | |
| 77 | :::tip |
| 78 | |
| 79 | 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. |
| 80 | |
| 81 | ::: |