Skip to main content


Because Netdata is a health monitoring and performance troubleshooting system, we put a lot of emphasis on real-time, meaningful, and context-aware charts.

We bundle Netdata with a dashboard and hundreds of charts, designed by both our team and the community, but you can also customize them yourself.

There are two primary ways to view Netdata's dashboards:

  1. The local Agent dashboard that comes pre-configured with every Netdata installation. You can see it at http://NODE:19999, replacing NODE with localhost, the hostname of your node, or its IP address. You can customize the contents and colors of the standard dashboard using JavaScript.

  2. The dashboard.js JavaScript library, which helps you customize the standard dashboards using JavaScript, or create entirely new custom dashboards or Atlassian Confluence dashboards.

You can also view all the data Netdata collects through the REST API v1.

No matter where you use Netdata's charts, you'll want to know how to use them. You'll also want to understand how Netdata defines charts, dimensions, families, and contexts.

Using charts#

Netdata's charts are far from static. They are interactive, real-time, and work with your mouse, touchpad, or touchscreen!

Hover over any chart to temporarily pause it and see the exact values presented as different dimensions. Click or tap stop the chart from automatically updating with new metrics, thereby locking it to a single timeframe.

Animated GIF of hovering over a chart to see

You can change how charts show their metrics by zooming in or out, moving forward or backward in time, or selecting a specific timeframe for more in-depth analysis.

Whenever you use a chart in this way, Netdata synchronizes all the other charts to match it.

You can change how charts show their metrics in a few different ways, each of which have a few methods:

ManipulationMethod #1Method #2Method #3
Reset charts to default auto-refreshing state  double click double tap (touchpad/touchscreen)   
Select a certain timeframe ALT + mouse selection   + mouse selection (macOS)   
Pan forward or back in time  click and drag touch and drag (touchpad/touchscreen)   
Zoom to a specific timeframe SHIFT + mouse selection    
Zoom in/out  SHIFT/ALT + mouse scrollwheel  SHIFT/ALT + two-finger pinch (touchpad/touchscreen)  SHIFT/ALT + two-finger scroll (touchpad/touchscreen) 

Here's how chart synchronization looks while zooming and panning:

Animated GIF of the standard Netdata dashboard being manipulated and synchronizing

You can also perform all these actions using the small rewind/play/fast-forward/zoom-in/zoom-out buttons that appear in the bottom-right corner of each chart.

Additionally, resize charts by clicking-and-dragging the icon on the bottom-right corner of any chart. To restore the chart to its original height, double-click the same icon.

Animated GIF of resizing a chart and resetting it to the default

Charts, contexts, families#

Before customizing the standard web dashboard, creating a custom dashboard, configuring an alarm, or writing a collector, it's crucial to understand how Netdata organizes metrics into charts, dimensions, families, and contexts.


A chart is an individual, interactive, always-updating graphic displaying one or more collected/calculated metrics. Charts are generated by collectors.

Here's the system CPU chart, the first chart displayed on the standard dashboard:

Screenshot of the system CPU chart in the Netdata

Netdata displays a chart's name in parentheses above the chart. For example, if you navigate to the system CPU chart, you'll see the label: Total CPU utilization (system.cpu). In this case, the chart's name is system.cpu. Netdata derives the name from the chart's context.


A dimension is a value that gets shown on a chart. The value can be raw data or calculated values, such as percentages, aggregates, and more.

Charts are capable of showing more than one dimension. Netdata shows these dimensions on the right side of the chart, beneath the date and time. Again, the system.cpu chart will serve as a good example.

Screenshot of the dimensions shown in the system CPU chart in the Netdata

Here, the system.cpu chart is showing many dimensions, such as user, system, softirq, irq, and more.

Note that other applications sometimes use the word series instead of dimension.


A family is one instance of a monitored hardware or software resource that needs to be monitored and displayed separately from similar instances.

For example, if your system has multiple disk drives at sda and sdb, Netdata will put each interface into their own family. Same goes for software resources, like multiple MySQL instances. We call these instances "families" because the charts associated with a single disk instance, for example, are often related to each other. Relatives, family... get it?

When relevant, Netdata prefers to organize charts by family. When you visit the Disks section, you will see your disk drives organized into families, and each family will have one or more charts: disk, disk_ops, disk_backlog, disk_util, disk_await, disk_avgsz, disk_svctm, disk_mops, and disk_iotime.

In the screenshot below, the disk family sdb shows a few gauges, followed by a few of the associated charts:

Screenshot of a disk drive family and associated charts in the Netdata

Netdata also creates separate submenu entries for each family in the right navigation page so you can easily navigate to the instance you're interested in. Here, Netdata has made several submenus under the Disk menu.

Screenshot of the disks menu and


A context is a way of grouping charts by the types of metrics collected and dimensions displayed. Different charts with the same context will show the same dimensions, but for different instances (families) of hardware/software resources.

For example, the Disks section will often use many contexts (, disk.ops, disk.backlog, disk.util, and so on). Netdata then creates an individual chart for each context, and groups them by family.

Netdata names charts according to their context according to the following structure: [context].[family]. A chart with the disk.util context, in the sdb family, gets the name disk_util.sdb. Netdata shows that name in the top-left corner of a chart.

Given the four example contexts, and two families of sdb and sdd, Netdata will create the following charts and their names:

Contextsdb familysdd family

And here's what two of those charts in the context look like under sdb and sdd families:

context_01 context_02

As you can see in the screenshot, you can view the context of a chart if you hover over the date above the list of dimensions. A tooltip will appear that shows you two pieces of information: the collector that produces the chart, and the chart's context.

Netdata also uses contexts for alarm templates. You can create an alarm for the net.packets context to receive alerts for any chart with that context, no matter which family it's attached to.

Positive and negative values on charts#

To improve clarity on charts, Netdata dashboards present positive values for metrics representing read, input, inbound, received and negative values for metrics representing write, output, outbound, sent.

Screenshot showing positive and negative

Netdata charts showing the bandwidth and packets of a network interface. received is positive and sent is negative.

Autoscaled y-axis#

Netdata charts automatically zoom vertically, to visualize the variation of each metric within the visible timeframe.

Animated GIF showing the auso-scaling Y

A zero-based stacked chart, automatically switches to an auto-scaled area chart when a single dimension is selected.


Netdata uses the dashboards.js file to define, configure, create, and update all the charts and other visualizations that appear on any Netdata dashboard. You need to put dashboard.js on any HTML page that's going to render Netdata charts.

The custom dashboards documentation contains examples of such custom HTML pages.

Generating dashboard.js#

We build the dashboards.js file by concatenating all the source files located in the web/gui/src/dashboard.js/ directory. That's done using the provided build script:

cd web/gui

If you make any changes to the src directory when developing Netdata, you should regenerate the dashboard.js file before you commit to the Netdata repository.

Reach out

If you need help after reading this doc, search our community forum for an answer. There's a good chance someone else has already found a solution to the same issue.



Last updated on