You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/common/de/monitoring_docker.asciidoc
+3Lines changed: 3 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -106,6 +106,7 @@ Eine Vorlage mit ausführlichen Erläuterungen hierzu finden Sie im {CMK} Verzei
106
106
In den kommerziellen Editionen können Sie alle Parameter bequem mit der xref:wato_monitoringagents#bakery[Agentenbäckerei] einstellen.
107
107
108
108
109
+
[#monitoring_containers]
109
110
=== Container überwachen
110
111
111
112
==== Container-Hosts anlegen
@@ -194,6 +195,7 @@ endif::[]
194
195
[#diagnose]
195
196
== Diagnosemöglichkeiten
196
197
198
+
[#diagnosis_docker_host]
197
199
=== Diagnose für einen Docker-Node
198
200
199
201
Sollte die Einrichtung nicht klappen, gibt es verschiedene Möglichkeiten der Analyse des Problems.
@@ -231,6 +233,7 @@ Prüfen Sie dann gegebenenfalls Ihre Docker-Installation:
231
233
----
232
234
233
235
236
+
[#diagnosis_container_host]
234
237
=== Diagnose für einen Container-Host
235
238
236
239
Falls der Container-Host keine Daten erhält bzw. keine Services erkannt werden, prüfen Sie zuerst, ob die Piggyback-Daten zu diesem Host vorhanden sind.
Copy file name to clipboardExpand all lines: src/common/en/monitoring_docker.asciidoc
+16-14Lines changed: 16 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ As necessary as end-to-end and transparent monitoring of containers is, it is al
26
26
But {CMK} monitors not only the general status of the daemon or the container, but also the container itself.
27
27
A full list of the elements that can currently be monitored can be found in the link:https://checkmk.com/integrations[Catalog of check plug-ins^].
28
28
29
-
Alongside the status and inventory information which {CMK} can determine over the node (docker-jargon for ’the host on which the containers are running’), {CMK} can also determine detailed status information for the containers.
29
+
Alongside the status and inventory information which {CMK} can determine over the node (docker-jargon for 'the host on which the containers are running'), {CMK} can also determine detailed status information for the containers.
30
30
For this every container has to be added as a separate host in {CMK} if the container is to be monitored.
31
31
Its data will be xref:glossar#piggyback[piggybacked] from the node to this host.
32
32
@@ -105,6 +105,7 @@ A template with detailed explanations can be found in the {CMK} directory `~/sha
105
105
In the commercial editions you can easily configure all parameters with the xref:wato_monitoringagents#bakery[Agent Bakery].
106
106
107
107
108
+
[#monitoring_containers]
108
109
=== Monitoring the containers
109
110
110
111
==== Creating the container hosts
@@ -113,7 +114,7 @@ Of course the interesting aspect is the monitoring of the Docker containers.
113
114
This will be implemented automatically by installing the plug-ins, however the services will not be assigned to the docker node, rather {CMK} assumes a single host per docker container.
114
115
115
116
The mechanism used here is called xref:glossar#piggyback[piggyback]:
116
-
The plug-in or special agent transports data of other hosts -- ‘piggybacked’ so to speak -- alongside its own data.
117
+
The plug-in or special agent transports data of other hosts—'piggybacked' so to speak--alongside its own data.
117
118
{CMK} places this data in the `~/tmp/check_mk/piggyback` directory.
118
119
All you have to do in the Setup is to create hosts with the correct names, and the services will then be automatically assigned to them.
119
120
@@ -135,7 +136,7 @@ However since many services monitored by the agent within the containers actuall
135
136
136
137
==== Alternative names for container hosts
137
138
138
-
By default -- as mentioned above -- the 12-character short ID for the container is used as the name for the container host.
139
+
By default--as mentioned above--the 12-character short ID for the container is used as the name for the container host.
139
140
This can optionally be configured differently.
140
141
To do this, in the configuration file `docker.cfg` (see xref:finetuning[Fine tuning the plug-in]) set the `container_id` option to `long` in order to use the complete container ID as the name, or to `name` in order to use the container name.
141
142
@@ -154,14 +155,14 @@ See the xref:piggyback#renamehosts[The piggyback mechanism] article for more opt
154
155
==== Monitoring the host state
155
156
156
157
ifdef::onprem[]
157
-
Since a container’s xref:monitoring_basics#hosts[host state] cannot really be verified using xref:cmc_differences#smartping[TCP packets or ICMP], this must be determined in another way.
158
-
The [.guihint]#Docker container status# service facilitates this -- in any case it checks whether the container is running, and can thus be used as a secure tool for detecting the host state.
158
+
Since a container's xref:monitoring_basics#hosts[host state] cannot really be verified using xref:cmc_differences#smartping[TCP packets or ICMP], this must be determined in another way.
159
+
The [.guihint]#Docker container status# service facilitates this--in any case it checks whether the container is running, and can thus be used as a secure tool for detecting the host state.
159
160
endif::[]
160
161
ifdef::saas[]
161
-
For monitoring the container’s xref:monitoring_basics#hosts[host state], using the [.guihint]#Docker container status# service seems obvious -- in any case it checks whether the container is running, and can thus be used as a secure tool for detecting the host state.
162
+
For monitoring the container's xref:monitoring_basics#hosts[host state], using the [.guihint]#Docker container status# service seems obvious--in any case it checks whether the container is running, and can thus be used as a secure tool for detecting the host state.
162
163
endif::[]
163
164
Define a rule in the [.guihint]#Host check command# rule set for this purpose, and set the [.guihint]#Use the status of the service...# option to the mentioned service.
164
-
Don’t forget to set the conditions so that only containers are affected.
165
+
Don't forget to set the conditions so that only containers are affected.
165
166
In our example all containers are located in a folder with the same name:
166
167
167
168
image::docker_container_hoststatus.png[alt="Rule for the command to check the host state of the containers."]
@@ -174,7 +175,7 @@ This is especially true for the roll out of agent plug-ins.
174
175
The three plug-ins `mem`, `cpu` and `diskstat` (Disk I/O) work without an agent in the container though, and are analyzed by the {CMK} agent on the node itself.
175
176
176
177
Especially for self-created Docker images you might want to roll out the agent itself into the container.
177
-
In this case the data is no longer analyzed -- as described above -- by the Docker node’s agent.
178
+
In this case the data is no longer analyzed--as described above--by the Docker node's agent.
178
179
Instead of this a separate agent runs in each container.
179
180
Calling this agent will still be bundled in a piggyback procedure via the Docker node however.
180
181
@@ -183,21 +184,22 @@ Especially with minimally-built containers based on Alpine Linux it could very w
183
184
In such a situation you should monitor the container from the Docker node.
184
185
185
186
ifdef::onprem[]
186
-
The use of the [.guihint]#Host check command# rule set will in this case only be required if the container is not pingable -- but it will otherwise function exactly as described above.
187
+
The use of the [.guihint]#Host check command# rule set will in this case only be required if the container is not pingable--but it will otherwise function exactly as described above.
187
188
endif::[]
188
189
189
190
190
191
[#diagnose]
191
192
== Diagnostic options
192
193
194
+
[#diagnosis_docker_host]
193
195
=== Diagnosis of a Docker node
194
196
195
197
Should the setup not be successful, there are a number of options for analyzing the problem.
196
198
ifdef::onprem[]
197
199
If applicable, verify that a {CMK} agent with at least version {v15} or a later version is installed on the host.
198
200
endif::[]
199
201
200
-
If the version of the agent on the host is suitable, next check if the data is present in the agent’s output.
202
+
If the version of the agent on the host is suitable, next check if the data is present in the agent's output.
201
203
You can download the output as a text file: in a host view in monitoring via the [.guihint]#Download agent output# action menu entry:
202
204
203
205
image::docker_node_dropdown.png[alt="Action menu of the host in monitoring with the entry for downloading the agent output.", width=65%]
@@ -226,11 +228,11 @@ If necessary, check your Docker installation:
226
228
{c-root} docker info 2>&1
227
229
----
228
230
229
-
231
+
[#diagnosis_container_host]
230
232
=== Diagnosis for a container host
231
233
232
234
If the container host receives no data, or respectively, no services are detected, first check if piggyback data is available for this host.
233
-
The host’s name must be identical to the ID of the container.
235
+
The host's name must be identical to the ID of the container.
234
236
Alternatively, you can also make a manual assignment using the [.guihint]#Host name translation for piggybacked hosts# rule set.
235
237
Here, however, only the [.guihint]#Explicit hostname mapping# option is suitable:
236
238
@@ -267,7 +269,7 @@ ifdef::onprem[]
267
269
|===
268
270
|File path |Function
269
271
270
-
|`~/tmp/check_mk/piggyback/` |{CMK} saves the piggyback data here. For each piggybacked host a subfolder is created with the host’s name -- this subfolder contains a text file with the host’s data. The filename is the name of the piggyback host providing the data.
271
-
|`~/tmp/check_mk/cache/` |Here the most recent agent output from all hosts is saved temporarily. The contents of a host’s file is identical to that from the `cmk -d myserver123` command.
272
+
|`~/tmp/check_mk/piggyback/` |{CMK} saves the piggyback data here. For each piggybacked host a subfolder is created with the host's name--this subfolder contains a text file with the host's data. The filename is the name of the piggyback host providing the data.
273
+
|`~/tmp/check_mk/cache/` |Here the most recent agent output from all hosts is saved temporarily. The contents of a host's file is identical to that from the `cmk -d myserver123` command.
0 commit comments