netdata/docs/netdata-agent/configuration

Netdata Agent Configuration

Info

Netdata Cloud lets you configure Agents on the fly. Check the Dynamic Configuration Manager documentation for details.

The main Netdata Agent configuration is netdata.conf.

The Netdata config directory

On most Linux systems, the Netdata config directory will be /etc/netdata/. The config directory contains several configuration files with the .conf extension, a few directories, and a shell script named edit-config.

Some operating systems will use /opt/netdata/etc/netdata/ as the config directory. If you're not sure where yours is, navigate to http://NODE:19999/netdata.conf in your browser, replacing NODE with the IP address or hostname of your node, and find the # config directory = setting. The value listed is the config directory for your system.

All of Netdata's documentation assumes that your config directory is at /etc/netdata, and that you're running any scripts from inside that directory.

Edit a configuration file using edit-config

We recommend the use of the edit-config script for configuration changes.

It exists inside your config directory (read above) and helps manage and safely edit configuration files.

To edit netdata.conf, run this on your terminal:

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config netdata.conf

Your editor will open.

downloading netdata.conf

The running version of netdata.conf can be downloaded from a running Netdata Agent, at this URL:

http://agent-ip:19999/netdata.conf

You can save and use this version, using these commands:

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
curl -ksSLo /tmp/netdata.conf.new http://localhost:19999/netdata.conf && sudo mv -i /tmp/netdata.conf.new netdata.conf