Already have an account? Sign In
Metricbeat is a lightweight shipper that helps you monitor Docker by collecting metrics from the containers running on the host system. Configure Metricbeat using the pre-defined examples below to collect and ship Docker container service metrics and statistics to Logstash or Elasticsearch.
curl -L -O https://artifacts.elastic.co/downloads/beats//-oss-7.8.1-amd64.deb sudo dpkg -i -oss-7.8.1-amd64.deb
curl -L -O https://artifacts.elastic.co/downloads/beats//-oss-7.8.1-x86_64.rpm sudo rpm -vi -oss-7.8.1-x86_64.rpm
curl -L -O https://artifacts.elastic.co/downloads/beats//-oss-7.8.1-darwin-x86_64.tar.gz tar xzvf -oss-7.8.1-darwin-x86_64.tar.gz
- Download the Windows zip file from the official downloads page.
- Extract the contents of the zip file into C:\Program Files.
- Rename the
-<version>-windowsdirectory to ``.
- Open a PowerShell prompt as an Administrator (right-click the PowerShell icon and select Run As Administrator). If you are running Windows XP, you may need to download and install PowerShell.
- Run the following commands to install as a Windows service:
cd 'C:\Program Files\' .\install-service-.ps1
PowerShell.exe -ExecutionPolicy UnRestricted -File .\install-service-.ps1.
We'll be shipping to Logstash so that we have the option to run filters before the data is indexed.
Comment out the elasticsearch output block.
## Comment out elasticsearch output #output.elasticsearch: # hosts: ["localhost:9200"]
Let's check the configuration file is syntactically correct by running directly inside the terminal.
If the file is invalid, will print an
error loading config file error message with details on how to correct the problem.
sudo -e -c /etc//.yml
cd <EXTRACTED_ARCHIVE> ./ -e -c .yml
cd <EXTRACTED_ARCHIVE> .\.exe -e -c .yml
There are several built in metricbeat modules you can use. To enable the docker module, run the following:
metricbeat modules list metricbeat modules enable docker
./metricbeat modules list ./metricbeat modules enable docker
PS > .\metricbeat.exe modules enable docker
Each module has its own configuration file where different metricsets can be enabled / disabled. Locate the configuration file for the docker module.
By default the following metrics are enabled. To enable or disable a metric simply comment or uncomment the line out.
metricbeat.modules: - module: docker metricsets: - "container" - "cpu" - "diskio" - "event" - "healthcheck" - "info" #- "image" - "memory" - "network" hosts: ["unix:///var/run/docker.sock"] period: 10s enabled: true
Ok, time to start gathering metrics!
sudo systemctl enable metricbeat sudo systemctl start metricbeat
PS C:\Program Files\Metricbeat> Start-Service metricbeat
The Docker module is currently tested on Linux and Mac with the community edition engine, versions 1.11 and 17.09.0-ce. It is not tested on Windows, but it should also work there.
It is strongly recommended that you run Docker metricsets with a period that is 3 seconds or longer. The request to the Docker API already takes up to 2 seconds. Specifying less than 3 seconds will result in requests that timeout, and no data will be reported for those requests.