Monitor Docker

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version. View this page in the v2.7 documentation.

Use the Docker Monitoring template to monitor your Docker containers. First, apply the template, and then view incoming data. This template uses the Docker input plugin to collect metrics stored in InfluxDB and display these metrics in a dashboard.

The Docker Monitoring template includes the following:

• one dashboard: Docker
• one bucket: docker, 7d retention
• labels: Docker input plugin labels
• one Telegraf configuration: Docker input plugin
• one variable: bucket
• four checks: Container cpu, mem, disk, non-zero exit
• one notification endpoint: Http Post
• one notification rule: Crit Alert

For more information about how checks, notification endpoints, and notifications rules work together, see monitor data and send alerts.

Apply the template

1. Use the influx CLI to run the following command:

   influx apply -f https://raw.githubusercontent.com/influxdata/community-templates/master/docker/docker.yml

   For more information, see influx apply.

   Ensure your influx CLI is configured with your account credentials and that configuration is active. For more information, see influx config.

2. Install Telegraf on a server with network access to both the Docker containers and InfluxDB v2 API.

3. In your Telegraf configuration file (telegraf.conf), do the following:

   • Depending on how you run Docker, you may need to customize the Docker input plugin configuration, for example, you may need to specify the endpoint value.
   • Set the following environment variables:
     • INFLUX_TOKEN: Token must have permissions to read Telegraf configurations and write data to the telegraf bucket. See how to view tokens.
     • INFLUX_ORG: Name of your organization. See how to view your organization.
     • INFLUX_HOST: Your InfluxDB host URL, for example, localhost, a remote instance, or InfluxDB Cloud.
4. Start Telegraf.

View incoming data

1. In the InfluxDB user interface (UI), select Dashboards in the left navigation.

   Dashboards

2. Open the Docker dashboard to start monitoring.