Docker Engine monitoring with Netdata
Docker Engine is the industry’s de facto container runtime that runs on various
Linux (CentOS, Debian, Fedora, Oracle Linux, RHEL, SUSE, and Ubuntu) and Windows Server operating systems.
This module will monitor one or more Docker Engines applications, depending on your configuration.
Requirements
Charts
It produces the following charts:
- Container Actions in
actions/s
- Container States in
containers
- Builder Builds Fails By Reason in
fails/s
- Health Checks in
events/s
If Docker is running in Swarm mode and the instance is a Swarm manager:
- Swarm Manager Leader in
bool
- Swarm Manager Object Store in
count
- Swarm Manager Nodes Per State in
count
- Swarm Manager Tasks Per State in
count
Configuration
Edit the go.d/docker_engine.conf configuration file using edit-config from the
Netdata config directory, which is typically at /etc/netdata.
cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/docker_engine.conf
Needs only url to docker metric-address. Here is an example for 2 docker instances:
jobs:
- name: local
url: http://127.0.0.1:9323/metrics
- name: remote
url: http://203.0.113.10:9323/metrics
For all available options, please see the
module's configuration file.
Troubleshooting
To troubleshoot issues with the docker_engine collector, run the go.d.plugin with the debug option enabled. The
output should give you clues as to why the collector isn't working.
-
Navigate to the plugins.d directory, usually at /usr/libexec/netdata/plugins.d/. If that's not the case on
your system, open netdata.conf and look for the plugins setting under [directories].
cd /usr/libexec/netdata/plugins.d/
-
Switch to the netdata user.
sudo -u netdata -s
-
Run the go.d.plugin to debug the collector:
./go.d.plugin -d -m docker_engine