docs: add with-systemd-units-monitoring example to docker (#16513)
Ilya Mashchenko committed
Nov 30, 2023 at 20:07 UTC
81ceddc5188aee7c102534cd2f39fb6b17a71dd9
1 file changed
+28
packaging/docker/README.md
+28
@@ -133,6 +133,34 @@ volumes:
133
> If you plan to Claim the node to Netdata Cloud, you can find the command with the right parameters by clicking the "
134
> Add Nodes" button in your Space's "Nodes" view.
135
136
+### With systemd units monitoring
137
+
138
+Monitoring systemd units requires mounting `/run/dbus`. This mount is not available on non-systemd systems, so we cannot
139
+use it in the Recommended Way.
140
+
141
+Mounting `/run/dbus` provides:
142
+
143
+- [go.d/systemdunits](https://github.com/netdata/go.d.plugin/tree/master/modules/systemdunits#readme).
144
+- Systemd-list-units function: information about all systemd units, including their active state, description, whether
145
+ they are enabled, and more.
146
+
147
+<Tabs>
148
+<TabItem value="docker_run" label="docker run">
149
+
150
+<h3> Using the <code>docker run</code> command </h3>
151
+
152
+Add `-v /run/dbus:/run/dbus:ro` to your `docker run`.
153
+
154
+</TabItem>
155
+<TabItem value="docker compose" label="docker-compose">
156
+
157
+<h3> Using the <code>docker-compose</code> command</h3>
158
+
159
+Add `- /run/dbus:/run/dbus:ro` to the netdata service `volumes`.
160
+
161
+</TabItem>
162
+</Tabs>
163
+
164
### With host-editable configuration
165
166
Use a [bind mount](https://docs.docker.com/storage/bind-mounts/) for `/etc/netdata` rather than a volume.