ingensi/dockbeat

Dockbeat

（快速上手可查看文末TL;DR部分）

构建状态：![Build Status]([]
测试覆盖率：![codecov.io]([]

镜像概述

Dockbeat是Dockerbeat项目的新名称（因Docker商标政策更名），属于Elastic Beat系列轻量级代理工具。它安装在服务器上，定期读取Docker容器的统计信息，并将数据索引到Elasticsearch，用于容器资源监控与分析。

核心功能

Dockbeat导出五种类型的文档：

• type: container：容器属性信息
• type: cpu：容器CPU使用统计（每个容器生成一份文档）
• type: net：容器网络统计（每个容器网络生成一份文档）
• type: memory：容器内存统计（每个容器生成一份文档）
• type: blkio：容器IO访问统计（每个容器生成一份文档）
• type: log：Dockbeat状态信息（发生错误时每个周期生成一份文档）

详细字段列表可参考字段文档。

使用场景

适用于Docker容器运维监控场景，实时跟踪容器CPU、内存、网络IO等资源使用情况，帮助运维人员分析性能瓶颈、排查故障。

配置说明

Dockbeat配置文件位于etc/dockbeat.yml，支持通过环境变量调整参数：

• 统计周期：PERIOD（对应input.period，默认5秒）
• Docker socket路径：DOCKER_SOCKET（对应input.socket，默认unix:///var/run/docker.sock）
• 启用TLS加密：DOCKER_ENABLE_TLS（对应input.tls.enable，默认false）
• CA文件路径：DOCKER_CA_PATH（TLS启用时必填）
• 证书文件路径：DOCKER_CERT_PATH（TLS启用时必填）
• 密钥文件路径：DOCKER_KEY_PATH（TLS启用时必填）

Docker部署示例

基础运行

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock \
  --link elastic:elasticsearch ingensi/dockbeat:1.0.0-rc3

覆盖默认配置

bash
docker run -d --link elastic:elasticsearch \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /your/config/path:/etc/dockbeat \
  ingensi/dockbeat:1.0.0-rc3

挂载日志目录

bash
docker run -d --link elastic:elasticsearch \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /your/config/path:/etc/dockbeat \
  -v /your/log/path:/var/logs/dockbeat \
  ingensi/dockbeat:1.0.0-rc3

调整环境变量

bash
docker run -d \
  -v /var/run/docker.sock:/another/path.sock \
  --link elastic1:es1 --link elastic2:es2 \
  -e PERIOD=30 -e DOCKER_SOCKET=unix:///another/path.sock \
  ingensi/dockbeat:1.0.0-rc3

TL;DR（快速部署监控环境）

bash
# 创建网络
docker network create dockernet

# 启动Elasticsearch
docker run -d --net=dockernet --name=elastic \
  -v /mnt/volumes/elastic/config:/usr/share/elasticsearch/config \
  -v /mnt/volumes/elastic/data:/usr/share/elasticsearch/data \
  elasticsearch:2.2.0

# 启动Kibana
docker run -d --net=dockernet --name=kibana -p 5601:5601 \
  -e ELASTICSEARCH_URL=http://elastic:9200 \
  kibana:4.4.1

# 启动Dockbeat
docker run -d --net=dockernet --name=dockbeat \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /mnt/dv/dockbeat:/etc/dockbeat ingensi/dockbeat:latest

（若Kibana无法连接Elasticsearch，请检查网络配置）