summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorIlya Mashchenko <ilya@netdata.cloud>2023-11-30 20:07:22 +0200
committerGitHub <noreply@github.com>2023-11-30 20:07:22 +0200
commit81ceddc5188aee7c102534cd2f39fb6b17a71dd9 (patch)
treed18115984eb3bce9293bb7119a11be2e35005eb9
parent3ab4c07118c4da7b3928100d5666505c0ea12e94 (diff)
docs: add with-systemd-units-monitoring example to docker (#16513)
-rw-r--r--packaging/docker/README.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/packaging/docker/README.md b/packaging/docker/README.md
index 73a2d03e9e..528ef59263 100644
--- a/packaging/docker/README.md
+++ b/packaging/docker/README.md
@@ -133,6 +133,34 @@ volumes:
> If you plan to Claim the node to Netdata Cloud, you can find the command with the right parameters by clicking the "
> Add Nodes" button in your Space's "Nodes" view.
+### With systemd units monitoring
+
+Monitoring systemd units requires mounting `/run/dbus`. This mount is not available on non-systemd systems, so we cannot
+use it in the Recommended Way.
+
+Mounting `/run/dbus` provides:
+
+- [go.d/systemdunits](https://github.com/netdata/go.d.plugin/tree/master/modules/systemdunits#readme).
+- Systemd-list-units function: information about all systemd units, including their active state, description, whether
+ they are enabled, and more.
+
+<Tabs>
+<TabItem value="docker_run" label="docker run">
+
+<h3> Using the <code>docker run</code> command </h3>
+
+Add `-v /run/dbus:/run/dbus:ro` to your `docker run`.
+
+</TabItem>
+<TabItem value="docker compose" label="docker-compose">
+
+<h3> Using the <code>docker-compose</code> command</h3>
+
+Add `- /run/dbus:/run/dbus:ro` to the netdata service `volumes`.
+
+</TabItem>
+</Tabs>
+
### With host-editable configuration
Use a [bind mount](https://docs.docker.com/storage/bind-mounts/) for `/etc/netdata` rather than a volume.