docs: task class: improve_docs — add a 'check status' section to the service [surgical_edit] (#22485)
* docs: update docs/netdata-verify-running-after-linux-installation * docs: Execution completed * docs: Execution completed * docs: Execution completed * docs: Execution completed --------- Co-authored-by: nedi-app[bot] <nedi-app[bot]@users.noreply.github.com>
nedi-app[bot] committed
May 15, 2026 at 15:22 UTC
c559464810287ac5cfe136711ad40b9e33a4b568
1 file changed
+32
-12
docs/netdata-agent/start-stop-restart.md
+32
-12
@@ -30,11 +30,30 @@ Restarting the Netdata Agent will cause temporary gaps in your collected metrics
30
31
### Using `systemctl`, `service`, or `init.d`
32
33
-| Action | Systemd | Non-systemd |
34
-|---------|----------------------------------|--------------------------------|
35
-| start | `sudo systemctl start netdata` | `sudo service netdata start` |
36
-| stop | `sudo systemctl stop netdata` | `sudo service netdata stop` |
37
-| restart | `sudo systemctl restart netdata` | `sudo service netdata restart` |
33
+| Action | Systemd | Non-systemd |
34
+|---------|----------------------------------|-------------------------------------------------------------------------------|
35
+| start | `sudo systemctl start netdata` | `sudo service netdata start` or `sudo /etc/init.d/netdata start` |
36
+| stop | `sudo systemctl stop netdata` | `sudo service netdata stop` or `sudo /etc/init.d/netdata stop` |
37
+| restart | `sudo systemctl restart netdata` | `sudo service netdata restart` or `sudo /etc/init.d/netdata restart` |
38
+| status | `sudo systemctl status netdata` | `sudo service netdata status` or `sudo /etc/init.d/netdata status` |
39
+
40
+### Check status
41
+
42
+Use the commands above to check whether the Netdata Agent service is running.
43
+
44
+You can also verify that the Agent is reachable by opening `http://NODE:19999` in a browser, or by running:
45
+
46
+```bash
47
+curl http://NODE:19999/api/v1/info
48
+```
49
+
50
+Replace `NODE` with the IP address or hostname of your Agent.
51
+
52
+:::tip
53
+
54
+Use `sudo netdatacli ping` to check whether the Agent is ready. It outputs `pong` with exit code `0` when the Agent is ready, exit code `1` while still initializing, and exit code `255` if the Agent is unreachable.
55
+
56
+:::
57
58
### Using `netdata`
59
@@ -92,13 +111,14 @@ If you prefer to manage the Agent through the GUI, you can start-stop and restar
111
112
### UNIX Commands Summary
113
95
-| Task | Systemd | Non-systemd | Direct Command |
96
-|-------------------|----------------------------------|----------------------------------|----------------------------------|
97
-| **Start** | `sudo systemctl start netdata` | `sudo service netdata start` | `sudo netdata` |
98
-| **Stop** | `sudo systemctl stop netdata` | `sudo service netdata stop` | `sudo killall netdata` |
99
-| **Restart** | `sudo systemctl restart netdata` | `sudo service netdata restart` | Stop + Start |
100
-| **Reload Health** | `sudo netdatacli reload-health` | `sudo netdatacli reload-health` | `sudo netdatacli reload-health` |
101
-| **Shutdown** | `sudo netdatacli shutdown-agent` | `sudo netdatacli shutdown-agent` | `sudo netdatacli shutdown-agent` |
114
+| Task | Systemd | Non-systemd | Direct Command |
115
+|-------------------|----------------------------------|-------------------------------------------------------------------------------|----------------------------------|
116
+| **Start** | `sudo systemctl start netdata` | `sudo service netdata start` or `sudo /etc/init.d/netdata start` | `sudo netdata` |
117
+| **Stop** | `sudo systemctl stop netdata` | `sudo service netdata stop` or `sudo /etc/init.d/netdata stop` | `sudo killall netdata` |
118
+| **Restart** | `sudo systemctl restart netdata` | `sudo service netdata restart` or `sudo /etc/init.d/netdata restart` | Stop + Start |
119
+| **Status** | `sudo systemctl status netdata` | `sudo service netdata status` or `sudo /etc/init.d/netdata status` | `curl http://NODE:19999/api/v1/info` |
120
+| **Reload Health** | `sudo netdatacli reload-health` | `sudo netdatacli reload-health` | `sudo netdatacli reload-health` |
121
+| **Shutdown** | `sudo netdatacli shutdown-agent` | `sudo netdatacli shutdown-agent` | `sudo netdatacli shutdown-agent` |
122
123
### Windows Commands Summary
124