ksunny/ethos-dd-agent

Datadog Agent Docker镜像说明

本仓库用于构建Datadog Agent容器的基础镜像，您需要使用生成的镜像来配置和运行Agent。

快速启动

默认镜像可直接使用，只需设置主机名和API_KEY环境变量：

docker run -d --name dd-agent -h `hostname` -v /var/run/docker.sock:/var/run/docker.sock -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e API_KEY={您的API_KEY} datadog/docker-dd-agent

若运行在Amazon Linux上，使用以下命令：

docker run -d --name dd-agent -h `hostname` -v /var/run/docker.sock:/var/run/docker.sock -v /proc/:/host/proc/:ro -v /cgroup/:/host/sys/fs/cgroup:ro -e API_KEY={您的API_KEY} datadog/docker-dd-agent

版本控制

从Agent 5.5.0开始，Docker镜像采用新的版本模式，允许在Agent版本不变的情况下发布镜像变更。版本格式为X.Y.Z：

• X：镜像主版本
• Y：镜像次版本
• Z：Agent版本（如Agent 5.5.0对应Z=550）

示例：捆绑Datadog Agent 5.5.0的首个镜像版本为10.0.550。

配置说明

环境变量

可通过环境变量调整参数：

• TAGS：设置主机标签，格式如simple-tag-0,tag-key-1:tag-value-1
• LOG_LEVEL：设置日志级别（CRITICAL/ERROR/WARNING/INFO/DEBUG）
• PROXY_HOST/PROXY_PORT/PROXY_USER/PROXY_PASSWORD：代理配置
• DD_URL：设置Datadog数据接收服务器（用于Agent作为代理场景）
• DOGSTATSD_ONLY：仅启动独立的DogStatsD实例

启用集成

通过挂载配置文件夹启用集成：

1. 在主机创建配置文件夹并编写YAML文件：

   mkdir /opt/dd-agent-conf.d
   touch /opt/dd-agent-conf.d/nginx.yaml
   

2. 运行容器时挂载该文件夹到/conf.d：

   docker run -d --name dd-agent -h `hostname` -v /var/run/docker.sock:/var/run/docker.sock -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -v /opt/dd-agent-conf.d:/conf.d:ro -e API_KEY={您的API_KEY} datadog/docker-dd-agent
   

构建自定义镜像

若需在镜像中预设配置，可基于此镜像构建：

1. 创建Dockerfile：

   FROM datadog/docker-dd-agent
   # 示例：添加MySQL配置
   ADD conf.d/mysql.yaml /etc/dd-agent/conf.d/mysql.yaml
   

2. 构建镜像：
   docker build -t dd-agent-image .
3. 运行自定义镜像：

   docker run -d --name dd-agent -h `hostname` -v /var/run/docker.sock:/var/run/docker.sock -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e API_KEY={您的API_KEY} dd-agent-image
   

状态与日志

查看Agent状态

docker exec dd-agent service datadog-agent info（需Docker 1.3及以上版本）

日志操作

• 复制容器日志到主机：docker cp dd-agent:/var/log/datadog /tmp/log-datadog-agent
• 查看Supervisor日志：docker logs dd-agent

DogStatsD相关

独立运行DogStatsD

添加DOGSTATSD_ONLY=true环境变量：

docker run -d --name dogstatsd -h `hostname` -v /var/run/docker.sock:/var/run/docker.sock -v /proc/mounts:/host/proc/mounts:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e API_KEY={您的API_KEY} -e DOGSTATSD_ONLY=true datadog/docker-dd-agent

暴露DogStatsD端口

• 允许外部访问：-p 8125:8125/udp
• 仅主机访问：-p 127.0.0.1:8125:8125/udp

从其他容器访问

• Docker链接：运行容器时添加--link dogstatsd:dogstatsd，通过环境变量DOGSTATSD_PORT_8125_UDP_ADDR/DOGSTATSD_PORT_8125_UDP_PORT获取地址
• 主机IP：使用Docker主机默认IP 172.17.42.1:8125

限制说明

• 未挂载到Agent容器的卷无法收集磁盘指标，需手动添加挂载（如-v /data:/data:ro）
• 因Docker隔离，部分主机指标（如网络、进程列表）可能缺失或不准确
• 部分集成功能可能不完整，可通过GitHub提交issue反馈

贡献

若发现镜像的限制或bug，可在https://github.com/DataDog/docker-dd-agent/issues%E6%8F%90%E4%BA%A4issue%EF%BC%9B%E8%8B%A5%E6%B6%89%E5%8F%8AAgent%E6%9C%AC%E8%BA%AB%EF%BC%8C%E5%8F%82%E8%80%83%E5%85%B6http://docs.datadoghq.com/%E6%88%96https://github.com/DataDog/dd-agent/wiki%E3%80%82