@cryptotaxi247 / netdata-1 / commits / e06e09078

Charts (#21219)

Kanela committed Oct 28, 2025 at 12:41 UTC e06e090782125303b88ff7f2b9ef4fb563f32e6e
1 file changed +1 -55
docs/dashboards-and-charts/netdata-charts.md
+1 -55
@@ -19,8 +19,6 @@ Netdata excels at collecting, storing, and presenting metrics in ready-to-use da
19
20 You can view these charts in Netdata Cloud’s **Metrics tab**, **individual node views**, and **Custom Dashboards**.
21
22 ----
23 -
22 ## Metric Correlations
23
24 Netdata charts allow you to quickly identify related metrics using the Metric Correlations feature. When you highlight an area of interest on a chart (such as a spike or anomaly), Netdata suggests other metrics that display similar behavior during the same timeframe.
@@ -48,8 +46,6 @@ Each Netdata chart is designed to provide quick insights and interactive explora
46 | Chart area | Displays the metrics data |
47 | Legend with dimensions | Lists all metric dimensions with color coding |
48
51 ----
52 -
49 ## Core Concepts
50
51 Understanding how Netdata organizes and presents metrics helps you make the most of its charts.
@@ -64,8 +60,6 @@ A **dimension** is a value shown on a chart. Dimensions can represent:
60
61 Each chart’s legend lists its dimensions. You can hide or show specific dimensions to focus on what matters most.
62
67 ----
68 -
63 ### Contexts
64
65 A **context** groups charts by metric type and displayed dimensions. Contexts define how charts are organized and where they appear in the Netdata menu.
@@ -79,8 +73,6 @@ The part before the dot (`.`) is the **type**, while the part after is defined b
73
74 Contexts are also used for alert configurations.
75
82 ----
83 -
76 ### Families
77
78 A **family** represents a specific instance of a hardware or software resource that needs its own chart.
@@ -98,8 +90,6 @@ The combination of **context** and **family** forms the `[context].[family]` nam
90 | `disk.backlog` | `disk_backlog.sda` | `disk_backlog.sdb` |
91 | `disk.util` | `disk_util.sda` | `disk_util.sdb` |
92
101 ----
102 -
93 ## Title Bar
94
95 The Title bar provides essential information and quick actions for each chart:
@@ -137,8 +127,6 @@ Space settings: Global defaults across the Space if no Room or personal settings
127
128 This hierarchy ensures that your personal preferences always take precedence, while still allowing collaborative defaults at the Room or Space level.
129
140 ----
141 -
130 ## Definition Bar
131
132 The Definition bar provides powerful filtering and grouping options, helping you explore your metrics more effectively:
@@ -156,8 +144,6 @@ The Definition bar provides powerful filtering and grouping options, helping you
144 | Time aggregation | Control how data points are aggregated over time |
145 | Reset button | Return to default filtering and grouping settings |
146
159 ----
160 -
147 ## NIDL Framework
148
149 The **NIDL (Nodes, Instances, Dimensions, Labels)** framework helps you filter, group, and understand chart data at a glance.
@@ -185,8 +171,6 @@ These dropdown menus serve two main functions:
171 | Anomaly rate | Displays anomaly rate for the selected timeframe |
172 | Value statistics | Shows minimum, average, and maximum values |
173
188 ----
189 -
174 ## Group By Dropdown
175
176 The **Group by** dropdown allows you to apply different grouping strategies on the same dataset:
@@ -212,8 +196,6 @@ Use **Group by Instance, Dimension** to visualize the time series for each indiv
196
197 :::
198
215 ----
216 -
199 ## Aggregate Functions Dropdown
200
201 Each chart has a default aggregation function, which you can adjust as needed:
@@ -241,8 +223,6 @@ When selecting aggregation functions over time, charts may offer dropdown menus
223
224 These options let you control how outliers and edge cases are handled during time-based aggregation.
225
244 ----
245 -
226 ## Nodes Dropdown
227
228 Filter and explore the contribution of each node to your chart:
@@ -255,8 +235,6 @@ Filter and explore the contribution of each node to your chart:
235 | Anomaly rate | Displays anomaly rate per node |
236 | Error messages | Lists any errors preventing nodes from contributing data |
237
258 ----
259 -
238 ## Instances Dropdown
239
240 Use the **Instances** dropdown to filter or view the contribution of specific instances within your data:
@@ -268,8 +246,6 @@ Use the **Instances** dropdown to filter or view the contribution of specific in
246 | Contribution percentage | Shows how much each instance contributes to the chart volume |
247 | Anomaly rate | Displays the anomaly rate for each instance |
248
271 ----
272 -
249 ## Dimensions Dropdown
250
251 The **Dimensions** dropdown allows you to filter by or focus on particular dimensions within your chart:
@@ -281,8 +257,6 @@ The **Dimensions** dropdown allows you to filter by or focus on particular dimen
257 | Contribution percentage | Shows how much each dimension contributes to the chart volume |
258 | Anomaly rate | Displays the anomaly rate for each dimension |
259
284 ----
285 -
260 ## Labels Dropdown
261
262 Filter or view your data by **labels**, giving you flexibility to isolate metrics by their tags:
@@ -294,8 +268,6 @@ Filter or view your data by **labels**, giving you flexibility to isolate metric
268 | Contribution percentage | Shows each label’s contribution to chart volume |
269 | Anomaly rate | Displays the anomaly rate breakdown by label |
270
297 ----
298 -
271 ## Aggregate Functions Over Time
272
273 When data resolution exceeds the chart’s granularity, **time-based aggregation** is applied. The aggregation function over time ensures that large amounts of data are still readable and insightful.
@@ -319,14 +291,10 @@ For more details, see [Data Queries - Data Grouping](/src/web/api/queries/README
291
292 :::
293
322 ----
323 -
294 ## Reset to Defaults
295
296 Click the green **Reset** button at the end of the Definition bar to restore the chart’s filtering and grouping options to their defaults.
297
328 ----
329 -
298 ## Anomaly Rate Ribbon
299
300 Netdata uses machine learning models trained on past data to predict expected metric values. These models identify anomalies in real time as soon as outliers occur.
@@ -341,8 +309,6 @@ Netdata uses machine learning models trained on past data to predict expected me
309
310 This feature enables you to catch issues quickly across large volumes of metrics.
311
344 ----
345 -
312 ## Hover Over the Chart
313
314 Hovering over any point on a chart reveals a detailed information overlay, making it easy to explore your metrics interactively:
@@ -358,8 +324,6 @@ Hovering over any point on a chart reveals a detailed information overlay, makin
324
325 When you hover over the **Anomaly Rate ribbon**, the dimensions are sorted by anomaly rate, and a histogram displays these rates to help you quickly identify problematic metrics.
326
361 ----
362 -
327 ### Info Column
328
329 The **Info Column** appears during hover and provides detailed data collection insights:
@@ -372,8 +336,6 @@ The **Info Column** appears during hover and provides detailed data collection i
336 | Overflown | At least one data source has a counter that overflowed |
337 | Empty Data | At least one dimension has no data for the selected points |
338
375 ----
376 -
339 ## Play, Pause, and Reset Controls
340
341 Control chart playback and interact with time using the **Time Controls**. These controls help you pause or reset the charts while exploring metrics.
@@ -386,8 +348,6 @@ Control chart playback and interact with time using the **Time Controls**. These
348
349 These controls work when the **default “Pan” action** is selected in the toolbar.
350
389 ----
390 -
351 ## Toolbar
352
353 The chart **Toolbar** provides interactive tools for manipulating the chart view:
@@ -402,8 +362,6 @@ The chart **Toolbar** provides interactive tools for manipulating the chart view
362 | Chart Zoom | Zoom in or out on the chart |
363 | Reset Zoom | Return to the original view |
364
405 ----
406 -
365 ### Pan
366
367 Use the **Pan Tool** to navigate through time on the chart:
@@ -414,8 +372,6 @@ Use the **Pan Tool** to navigate through time on the chart:
372
373 Drag right to move backward in time and left to move forward.
374
417 ----
418 -
375 ### Highlight
376
377 The **Highlight Tool** allows you to select timeframes for deeper analysis:
@@ -426,8 +382,6 @@ The **Highlight Tool** allows you to select timeframes for deeper analysis:
382
383 Use highlighting to investigate spikes, anomalies, or unusual behavior. Click on the chart area to clear the highlight selection.
384
429 ----
430 -
385 ### Select and Zoom
386
387 Zoom into specific timeframes for maximum data granularity:
@@ -437,8 +391,6 @@ Zoom into specific timeframes for maximum data granularity:
391 | Zoom to timeframe | Shift + mouse vertical selection | n/a |
392 | Horizontal Y-axis zoom | Shift + mouse horizontal selection | n/a |
393
440 ----
441 -
394 ### Zoom In and Out
395
396 The **Chart Zoom** tool allows you to zoom in and out to view different time ranges:
@@ -449,8 +401,6 @@ The **Chart Zoom** tool allows you to zoom in and out to view different time ran
401
402 Zooming in helps you analyze recent events in detail, while zooming out provides an overview of longer-term trends.
403
452 ----
453 -
404 ## Dimensions Bar
405
406 The **Dimensions Bar** allows you to manage how dimensions are displayed within the chart. Sorting and hiding dimensions helps you focus on the most relevant data.
@@ -467,8 +417,6 @@ You can sort the dimensions legend using various criteria:
417 | Dimension value | Sort by current metric values (ascending or descending) |
418 | Dimension anomaly rate | Sort by anomaly rate (ascending or descending) |
419
470 ----
471 -
420 ### Show and Hide Dimensions
421
422 Simplify your charts by showing only the dimensions you want to focus on:
@@ -480,8 +428,6 @@ Simplify your charts by showing only the dimensions you want to focus on:
428
429 This feature is especially useful for identifying unusual behavior by isolating specific metrics.
430
483 ----
484 -
431 ## Resize a Chart
432
433 Adjust the height of a chart to fit your analysis needs:
@@ -491,4 +437,4 @@ Adjust the height of a chart to fit your analysis needs:
437
438 This allows you to expand charts for more detailed analysis or condense them for a broader dashboard view.
439
494 -*Netdata charts combine clarity, flexibility, and interactivity, designed to help you focus on what matters most in your infrastructure.*
\ No newline at end of file
440 +*Netdata charts combine clarity, flexibility, and interactivity, designed to help you focus on what matters most in your infrastructure.*