When Netdata starts, it auto-detects dozens of data sources, such as database servers, web servers, and more.
To auto-detect and collect metrics from a source you just installed, you need to restart Netdata using
restart netdata, or the appropriate method for your system.
However, auto-detection only works if you installed the source using its standard installation procedure. If Netdata isn't collecting metrics after a restart, your source probably isn't configured correctly.
Check out the collectors that come pre-installed with Netdata to find the module for the source you want to monitor.
We'll begin with an overview on Netdata's collector architecture, and then dive into the following:
Many Netdata users never have to configure collector or worry about which plugin orchestrator they want to use.
But, if you want to configure collector or write a collector for your custom source, it's important to understand the underlying architecture.
By default, Netdata collects a lot of metrics every second using any number of discrete collector. Collectors, in turn, are organized and manged by plugins. Internal plugins collect system metrics, external plugins collect non-system metrics, and orchestrator plugins group individual collectors together based on the programming language they were built in.
You don't need to explicitly enable plugins to auto-detect properly configured sources, but it's useful to know how to enable or disable them.
One reason you might want to disable plugins is to improve Netdata's performance on low-resource systems, like
ephemeral nodes or edge devices. Disabling orchestrator plugins like
python.d can save significant resources if you're
not using any of its data collector modules.
You can enable or disable plugins in the
[plugin] section of
netdata.conf. This section features a list of all the
plugins with a boolean setting (
no) to enable or disable them. Be sure to uncomment the line by removing the
When you explicitly disable a plugin this way, it won't auto-collect metrics using its collectors.
To help explain how the auto-detection process works, let's use an Nginx web server as an example.
Even if you don't have Nginx installed on your system, we recommend you read through the following section so you can apply the process to other data sources, such as Apache, Redis, Memcached, and more.
The Nginx collector, which helps Netdata collect metrics from a running Nginx web server, is part of the
python.d.plugin external plugin orchestrator.
In order for Netdata to auto-detect an Nginx web server, you need to enable
ngx_http_stub_status_module and pass the
stub_status directive in the
location block of your Nginx configuration file.
You can confirm if the
stub_status Nginx module is already enabled or not by using following command:
If this command returns nothing, you'll need to enable this module.
Next, edit your
/etc/nginx/sites-enabled/default file to include a
location block with the following:
Restart Netdata using
sudo systemctl restart netdata, or the appropriate
method for your system, and Netdata will auto-detect metrics from your Nginx web
While not necessary for most auto-detection and collection purposes, you can also configure the Nginx collector itself by editing its configuration file:
After configuring any source, or changing the configuration files for their respective modules, always restart Netdata.
Now that you've learned the fundamentals behind configuring data sources for auto-detection, it's time to move back to the dashboard to learn more about some of its more advanced features.