Collectors
Netdata automatically collects per-second metrics from thousands of data sources without any configuration:
- Zero-touch setup: All collectors are pre-installed, allowing you to start collecting detailed metrics right after Netdata starts.
- Universal Monitoring: Monitor virtually anything with Netdata's extensive collector library.
If you don't see charts for your application, check our collectors' configuration reference to ensure both the collector and your application are properly configured.
Collector Types
Netdata's collectors are specialized data collection plugins that gather metrics from various sources. They are divided into two main categories:
Type | Description | Key Features |
---|---|---|
Internal | Native collectors that gather system-level metrics | • Written in C for optimal performance• Run as threads within Netdata daemon • Zero external dependencies • Minimal system overhead |
External | Modular collectors that gather metrics from applications and services | • Support multiple programming languages • Run as independent processes • Communicate via pipes with Netdata • Managed by plugins.d • Examples: MySQL, Nginx, Redis collectors |
Collector Privileges
Netdata uses various plugins and helper binaries that require elevated privileges to collect system metrics. This section outlines the required privileges and how they are configured in different environments.
Privileges
Plugin/Binary | Privileges (Linux) | Privileges (Non-Linux or Containerized Environment) |
---|---|---|
apps.plugin | CAP_DAC_READ_SEARCH, CAP_SYS_PTRACE | setuid root |
debugfs.plugin | CAP_DAC_READ_SEARCH | setuid root |
systemd-journal.plugin | CAP_DAC_READ_SEARCH | setuid root |
perf.plugin | CAP_PERFMON | setuid root |
slabinfo.plugin | CAP_DAC_READ_SEARCH | setuid root |
go.d.plugin | CAP_DAC_READ_SEARCH, CAP_NET_ADMIN, CAP_NET_RAW | setuid root |
freeipmi.plugin | setuid root | setuid root |
nfacct.plugin | setuid root | setuid root |
xenstat.plugin | setuid root | setuid root |
ioping | setuid root | setuid root |
ebpf.plugin | setuid root | setuid root |
cgroup-network | setuid root | setuid root |
local-listeners | setuid root | setuid root |
network-viewer.plugin | setuid root | setuid root |
ndsudo | setuid root | setuid root |
About ndsudo:
ndsudo
is a purpose-built privilege escalation utility for Netdata that executes a predefined set of commands with root privileges. Unlike traditional sudo
, it operates with a hard-coded list of allowed commands, providing better security through reduced scope and eliminating the need for sudo
configuration.
It’s used by the go.d.plugin
to collect data by executing certain binaries that require root access.
File Permissions and Ownership
To ensure security, all plugin and helper binary files have the following permissions and ownership:
- Ownership:
root:netdata
. - Permissions:
0750
(for non-setuid binaries) or4750
(for setuid binaries).
This configuration limits access to the files to the netdata
user and the root
user, while allowing execution by the netdata
user.
Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.