Skip to main content

Management and configuration cheatsheet

Use our management & configuration cheatsheet to simplify your interactions with Netdata, including configuration, using charts, managing the daemon, and more.

Install Netdata

Install Netdata

wget -O /tmp/ && sh /tmp/

Or, if you have cURL but not wget (such as on macOS):

curl > /tmp/ && sh /tmp/

Claim a node to Netdata Cloud

To do so, sign in to Netdata Cloud, click the Claim Nodes button, choose the War Rooms to add nodes to, then click Copy to copy the full script to your clipboard. Paste that into your node’s terminal and run it.

Metrics collection & retention

You can tweak your settings in the netdata.conf file. 📄 Find your netdata.conf file

Open a new terminal and navigate to the netdata.conf file. Use the edit-config script to make changes: sudo ./edit-config netdata.conf

The most popular settings to change are:

Increase metrics retention (4GiB)

sudo ./edit-config netdata.conf
dbengine multihost disk space = 4096

Reduce the collection frequency (every 5 seconds)

sudo ./edit-config netdata.conf
update every = 5

Enable/disable plugins (groups of collectors)

sudo ./edit-config netdata.conf
go.d = yes # enabled
node.d = no # disabled

Enable/disable specific collectors

sudo ./edit-config go.d.conf

Or python.d.conf, node.d.conf, edbpf.conf, and so on.

activemq: no # disabled
bind: no # disabled
cockroachdb: yes # enabled

Edit a collector's config (example)

$ sudo ./edit-config go.d/mysql.conf
$ sudo ./edit-config ebpf.conf
$ sudo ./edit-config python.d/anomalies.conf


The Netdata config directory: /etc/netdata

If you don't have such a directory: 📄 Find your netdata.conf file The cheatsheet assumes you’re running all commands from within the Netdata config directory!

Edit Netdata's main config file: $ sudo ./edit-config netdata.conf

Edit Netdata's other config files (examples):

  • $ sudo ./edit-config apps_groups.conf
  • $ sudo ./edit-config ebpf.conf
  • $ sudo ./edit-config health.d/load.conf
  • $ sudo ./edit-config go.d/prometheus.conf

View the running Netdata configuration: http://NODE:19999/netdata.conf

Replace NODE with the IP address or hostname of your node. Often localhost.

Alarms & notifications

Add a new alarm

sudo touch health.d/example-alarm.conf
sudo ./edit-config health.d/example-alarm.conf

Configure a specific alarm

sudo ./edit-config health.d/example-alarm.conf

Silence a specific alarm

sudo ./edit-config health.d/example-alarm.conf
to: silent

Disable alarms and notifications

enabled = no

After any change, reload the Netdata health configuration

netdatacli reload-health

or if that command doesn't work on your installation, use:

killall -USR2 netdata

Manage the daemon

Start Netdata$ sudo systemctl start netdata
Stop Netdata$ sudo systemctl stop netdata
Restart Netdata$ sudo systemctl restart netdata
Reload health configuration$ sudo netdatacli reload-health
$ killall -USR2 netdata
View error logsless /var/log/netdata/error.log

See metrics and dashboards

Netdata Cloud:

Local dashboard: https://NODE:19999

Replace NODE with the IP address or hostname of your node. Often localhost.

Access the Netdata API: http://NODE:19999/api/v1/info

Interact with charts

Stop a chart from updatingclick
use the zoom in and zoom out buttons on any chart (upper right corner)

SHIFT or ALT + mouse scrollwheel
SHIFT or ALT + two-finger pinch (touchscreen)
SHIFT or ALT + two-finger scroll (touchscreen)
Zoom to a specific timeframeCloud
use the select and zoom button on any chart and then do a mouse selection

SHIFT + mouse selection
Pan forward or back in timeclick & drag
touch & drag (touchpad/touchscreen)
Select a certain timeframeALT + mouse selection
WIP need to evaluate this command? + mouse selection (macOS)
Reset to default auto refreshing statedouble click


Disable the local dashboard

Use the edit-config script to edit the netdata.conf file.

mode = none

Change the port Netdata listens to (port 39999)

default port = 39999

Opt out from anonymous statistics

sudo touch .opt-out-from-anonymous-statistics

Understanding the dashboard

Charts: A visualization displaying one or more collected/calculated metrics in a time series. Charts are generated by collectors.

Dimensions: Any value shown on a chart, which can be raw or calculated values, such as percentages, averages, minimums, maximums, and more.

Families: One instance of a monitored hardware or software resource that needs to be monitored and displayed separately from similar instances. Example, disks named sda, sdb, sdc, and so on.

Contexts: A grouping of charts based on the types of metrics collected and visualized., disk.ops, and disk.backlog are all contexts.

Was this page helpful?

Need more help?