Docker 生产环境之配置守护进程 - 通过 Prometheus 收集 Docker 指标

原文地址

Prometheus 是一个开源系统监控和告警工具包。可以将 Docker 配置为 Prometheus 的目标。本主题向你展示如何配置 Docker，设置 Prometheus 作为 Docker 容器运行，并使用 Prometheus 监控 Docker 实例。

警告：可用指标和这些指标的名称正在积极开发中，并可能随时更改。

目前，只能监控 Docker 本身，无法监控应用程序。

1.配置 Docker

要将 Docker 守护进程配置为 Prometheus 的目标，需要制定指标地址。最好的方式是通过默认在以下位置的 daemon.json 文件来指定。如果文件不存在，创建它。

• Linux：/etc/docker/daemon.json
• Windows Server：C:\ProgramData\docker\config\daemon.json
• Docker for Mac / Docker for Windows：单击工具栏中的 Docker 图标，选择 Preferences，然后选择 Daemon。点击高级。

如果文件是空的，把下面内容放入即可：

{
  "metrics-addr" : "127.0.0.1:9323",
  "experimental" : true
}

如果文件非空，添加这两个字段，并确保文件仍然是有效的 JSON 格式。注意除了最后一行，每一行都需要用逗号结尾。

保存文件或配置，重启 Docker。

现在，Docker 在 9323 端口暴露出兼容 Prometheus 的指标。

2. 配置并运行 Prometheus

这个例子中，Prometheus 作为 Docker swarm 上的一个 Docker 服务运行。

先决条件

1. 在 Docker swarm 中加入了一个或多个 Docker engine，在 manager 上执行 docker swarm init ，在其他 manager 和 worker 节点上执行 docker swarm join。

2. 需要互联网连接来获取普罗米修斯镜像。

复制下面的配置文件并保存到 /tmp/prometheus.yml（Linux 或 Mac）或 C:\tmp\prometheus.yml（Windows）。这是一个普通的 Prometheus 配置文件，除了在文件底部添加 Docker 作业定义之外。Docker for Mac 和 Docker for Windows 需要稍微修改配置。

• Docker for Linux（Mac 和 Windows 版本请参考原文）

# my global config
global:
  scrape_interval:     15s # Set the scrape interval to every 15 seconds. Default is every 1 minute.
  evaluation_interval: 15s # Evaluate rules every 15 seconds. The default is every 1 minute.
  # scrape_timeout is set to the global default (10s).

  # Attach these labels to any time series or alerts when communicating with
  # external systems (federation, remote storage, Alertmanager).
  external_labels:
      monitor: 'codelab-monitor'

# Load rules once and periodically evaluate them according to the global 'evaluation_interval'.
rule_files:
  # - "first.rules"
  # - "second.rules"

# A scrape configuration containing exactly one endpoint to scrape:
# Here it's Prometheus itself.
scrape_configs:
  # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
  - job_name: 'prometheus'

    # metrics_path defaults to '/metrics'
    # scheme defaults to 'http'.

    static_configs:
      - targets: ['localhost:9090']

  - job_name: 'docker'
         # metrics_path defaults to '/metrics'
         # scheme defaults to 'http'.

    static_configs:
      - targets: ['localhost:9323']

然后，使用这个配置开启一个单副本的 Prometheus 服务。

• Docker for Linux（Mac 和 Windows 版本请参考原文）

$ docker service create --replicas 1 --name my-prometheus \
    --mount type=bind,source=/tmp/prometheus.yml,destination=/etc/prometheus/prometheus.yml \
    --publish published=9090,target=9090,protocol=tcp \
    prom/prometheus

验证 Docker target 在 http://localhost:9090/targets/ 的列表中。

如果你用的是 Docker for Mac 或 Docker for Windows 则无法直接访问终端的 URL。

3. 使用 Prometheus

创建一个图。点击 Prometheus UI 中的 Graphs 链接。从 Execute 按钮右侧的组合框中选择一个指标，然后单击 Execute 按钮。以下屏幕截图显示了 engine_daemon_network_actions_seconds_count 的图形。

上图显示了一个闲置的 Docker 实例。如果你正在运行活动工作负载，则你的图形可能看起来不同。

为了使图表更有趣，可以通过启动一项包括 10 个不停地 ping 到 Docker 的任务的服务来创建一些网络操作，可以将 ping 目标更改为任何你喜欢的任务：

$ docker service create \
  --replicas 10 \
  --name ping_service \
  alpine ping docker.com

等待几分钟（默认采集间隔为15秒）并重新加载图形。

准备就绪后，停止并删除 ping_service 服务，以免无缘无故地 ping 主机。

$ docker service remove ping_service

等待几分钟，你会发现图表又回落到闲置状态。

4. Next steps

• Read the Prometheus documentation
• Set up some alerts