8d11dad2a8
* Finish new common config doc, delete old one * Small tweak to blockquote * Add new files * Fix broken links * Fix one more broken link * Copyedits and improvements * Fix broken link * Re-add common config doc * service -> systemctl * Reverse systemctl order * Add mention of .conf files in health.d * Add mention of minimum global update every
3.8 KiB
Start, stop, or restart the Netdata Agent
When you install the Netdata Agent, the daemon is configured to start at boot and stop and restart/shutdown.
You will most often need to restart the Agent to load new or editing configuration files. Health configuration files are the only exception, as they can be reloaded without restarting the entire Agent.
Stopping or restarting the Netdata Agent will cause gaps in stored metrics until the netdata process initiates
collectors and the database engine.
Using systemctl, service, or init.d
This is the recommended way to start, stop, or restart the Netdata daemon.
- To start Netdata, run
sudo systemctl start netdata. - To stop Netdata, run
sudo systemctl stop netdata. - To restart Netdata, run
sudo systemctl restart netdata.
If the above commands fail, or you know that you're using a non-systemd system, try using the service command:
- service:
sudo service netdata start,sudo service netdata stop,sudo service netdata restart
Using netdata
Use the netdata command, typically located at /usr/sbin/netdata, to start the Netdata daemon.
sudo netdata
If you start the daemon this way, close it with sudo killall netdata.
Using netdatacli
The Netdata Agent also comes with a CLI tool capable of performing shutdowns. Start the Agent back up using your preferred method listed above.
sudo netdatacli shutdown-agent
Reload health configuration
You do not need to restart the Netdata Agent between changes to health configuration files, such as specific health
entities. Instead, use netdatacli and the reload-health option to prevent gaps in metrics
collection.
sudo netdatacli reload-health
If netdatacli doesn't work on your system, send a SIGUSR2 signal to the daemon, which reloads health configuration
without restarting the entire process.
killall -USR2 netdata
Force stop stalled or unresponsive netdata processes
In rare cases, the Netdata Agent may stall or not properly close sockets, preventing a new process from starting. In these cases, try the following three commands:
sudo systemctl stop netdata
sudo killall netdata
ps aux| grep netdata
The output of ps aux should show no netdata or associated processes running. You can now start the Netdata Agent
again with service netdata start, or the appropriate method for your system.
What's next?
Learn more about securing the Netdata Agent.
You can also use the restart/reload methods described above to enable new features:
- Enable new collectors or tweak their behavior.
- Configure existing health alarms or create new ones.
- Enable notifications to receive updates about the health of your infrastructure.
- Change the long-term metrics retention period using the database engine.