netdata(1)

Usage

netdata [-c OPTIONS] [{-D | -d}] [-P FILENAME] [-i IP] [-p PORT] [-s PATH] [-t SECONDS] [-u USERNAME]

netdata {-h netdata -v | -V}

Overview

netdata is distributed, real-time, performance and health monitoring for systems and applications. It provides insights of everything happening on the systems it runs using interactive web dashboards.

It can run autonomously without any third party components or it can be integrated to existing monitoring tool chains (Prometheus, Graphite, OpenTSDB, Kafka, Grafana, etc).

Options

The netdata daemon is usually started by an initscript or a systemd service, the following options are available:

-c FILENAME: Configuration file to load.
Default: /etc/netdata/netdata.conf.

-D: Do not fork. Run in the foreground.
Default: run in the background

-d: Fork. Run in the background.
Default: run in the background

-h: Display this help message.

-P FILENAME: File to save a pid while running.
Default: do not save pid to a file

-i IP: The IP address to listen to.
Default: all IP addresses IPv4 and IPv6

-p PORT: API/Web port to use.
Default: 19999

-s PATH: Prefix for /proc and /sys (for containers).
Default: no prefix

-t SECONDS: The internal clock of netdata.
Default: 1

-u USERNAME: Run as user.
Default: netdata

-v, -V: Print netdata version and exit.

-W OPTIONS: See Advanced options below.

Advanced options

-W stacksize=N: Set the stacksize (in bytes).

-W debug_flags=N: Set runtime tracing to debug.log.

-W unittest: Run internal unittests and exit.

-W createdataset=N: Create a DB engine dataset of N seconds and exit.

-W stresstest=A,B,C,D,E,F: Run a DB engine stress test for A seconds, with B writers and C readers, with a ramp up time of D seconds for writers, a page cache size of E MiB, an optional disk space limit of F MiB and exit.

`-W set SECTION OPTION VALUE`	Set netdata.conf option from the command line.
`-W simple-pattern PATTERN STRING`	Check if string matches pattern and exit.
`-W 'claim -token=TOKEN -rooms=ROOM1,ROOM2'`	Claim the agent to the workspace rooms pointed to by TOKEN and ROOM*.

Signals

`HUP`	Close and reopen log files.
`USR1`	Save internal DB to disk.
`USR2`	Reload health configuration.

Files

/etc/netdata: Configuration file.

/usr/share/doc/netdata: Upstream documentation.

Homepage

More information about netdata can be found on the homepage at <https://my-netdata.io> and in the manual at <https://docs.netdata.cloud>.

Releases

3 releases since Debian 10 (Buster); the text changed 1 time.

10
11–12