3.3 KiB
title | description | menu | weight | ||||||
---|---|---|---|---|---|---|---|---|---|
Monitor Docker | Use the [Docker Monitoring template](https://github.com/influxdata/community-templates/tree/master/docker) to monitor your Docker containers. |
|
202 |
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](/{{< latest "telegraf" >}}/plugins//#docker) 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
-
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.
Note: Ensure your
influx
CLI is configured with your account credentials and that configuration is active. For more information, see influx config. -
[Install Telegraf](/{{< latest "telegraf" >}}/introduction/installation/) on a server with network access to both the Docker containers and InfluxDB v2 API.
-
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](/{{< latest "telegraf" >}}/plugins//#docker) 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.
- INFLUX_TOKEN: Token must have permissions to read Telegraf configurations and write data to the
- Depending on how you run Docker, you may need to customize the [Docker input plugin](/{{< latest "telegraf" >}}/plugins//#docker) configuration, for example, you may need to specify the
View incoming data
-
In the InfluxDB user interface (UI), select Boards (Dashboards).
{{< nav-icon "dashboards" "v2" >}}
-
Open the Docker dashboard to start monitoring.