adobeplatform/ethos-dd-agent

Datadog Agent Docker镜像

本镜像为Datadog Agent容器的基础镜像，需基于此镜像配置并运行Agent以实现监控功能。

快速启动

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

bash
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} adobeplatform/ethos-dd-agent

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

bash
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} adobeplatform/ethos-dd-agent

版本控制

从Agent 5.5.0开始，镜像采用新的版本模式：X.Y.Z，其中X为镜像主版本，Y为次版本，Z为Agent版本（如10.0.550对应Agent 5.5.0）。

配置说明

环境变量

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

• 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数据接收服务器（用于代理模式）
• DOGSTATSD_ONLY：仅启动独立DogStatsD实例

启用集成

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

1. 主机创建配置目录（如/opt/dd-agent-conf.d）并编写YAML配置文件
2. 运行容器时挂载该目录到/conf.d：

   bash
   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} adobeplatform/ethos-dd-agent
   

容器启动时会自动将/conf.d下的YAML文件复制到Agent配置目录。

构建自定义镜像

若需固化配置，可基于本镜像构建自定义镜像：

1. 编写Dockerfile：

   dockerfile
   FROM adobeplatform/ethos-dd-agent
   # 示例：添加MySQL集成配置
   ADD conf.d/mysql.yaml /etc/dd-agent/conf.d/mysql.yaml
   

2. 构建镜像：docker build -t dd-agent-custom .
3. 运行自定义镜像：同快速启动命令，替换镜像名为dd-agent-custom

状态与日志

查看Agent状态

bash
docker exec dd-agent service datadog-agent info

复制日志到主机

bash
docker cp dd-agent:/var/log/datadog /tmp/log-datadog-agent

查看容器日志

bash
docker logs dd-agent

DogStatsD相关

独立DogStatsD

添加DOGSTATSD_ONLY=true环境变量启动独立DogStatsD：

bash
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 adobeplatform/ethos-dd-agent

暴露端口

• 对外暴露：-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主机默认IP172.17.42.1:8125

限制

• 未挂载到Agent容器的卷无法收集磁盘指标
• 因Docker隔离，部分主机指标（如网络、进程列表）可能缺失或不准确

贡献

若发现问题，可在GitHub提交Issue（镜像相关：https://github.com/DataDog/docker-dd-agent/issues%EF%BC%9BAgent%E6%9C%AC%E8%BA%AB%EF%BC%9A%E5%8F%82%E8%80%83Datadog%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E6%88%96wiki%EF%BC%89%E3%80%82