NETDATA(1)

💖 NETDATA — real-time performance monitoring 💖

okay bestie, pull up a chair, because this is the netdata(1) manual page and it's literally the group chat of system monitoring. it's the daemon, the dashboard, the whole vibe. let's get into it 🫶

---

✨ SYNOPSIS ✨

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

netdata -h netdata -v|-V

---

🌸 DESCRIPTION 🌸

so netdata is distributed, real-time, performance and health monitoring for systems and applications. it's giving main character energy for your whole machine — it shows you insights into everything happening on the systems it runs using interactive web dashboards. interactive!! web!! dashboards!! 🔥

the way that it can run autonomously without any third party components — no entourage needed, she's self-sufficient 💅 — or it can be integrated into existing monitoring tool chains. and yes bestie, that means Prometheus, Graphite, OpenTSDB, Kafka, Grafana, etc. she plays well with others, no cap.

---

✨ OPTIONS ✨

the netdata daemon is usually started by the systemd service, but here's the full menu of options that are available. not me listing every single one because we don't skip 💀

• -c FILENAME — the 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. a lil help, as a treat 🎀
• -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. bye bestie, version acquired 👋
• -W OPTIONS — see Advanced options below. the secret menu iykyk 🤫

🌈 ADVANCED OPTIONS 🌈

these are the -W ones, the deep cuts:

• -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 🦋

talk to her, she listens:

• 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>. go read, bestie, it's iconic 📚✨

---

👑 AUTHOR 👑

netdata was written by Costa Tsaousis <costa@tsaousis.gr>. absolute legend, periodt.

this manual page was written by Federico Ceratto <federico@debian.org> for the Debian project and may be used by others. slay 💅

---

and that's the whole thing bestie!! this was version 1.29.0, dated 2021-02-07, and it's the netdata manual page, section 1. take care of your daemon and she'll take care of you 🫶💖✨