Datadog Agent 镜像文档

镜像概述和主要用途

Datadog Agent 镜像是基于 Datadog Agent 6 版本构建的容器化部署包，主要用于在容器环境中运行 Datadog Agent，实现对系统、应用及容器的监控指标收集、日志聚合与性能分析。该镜像原用于简化 Agent 的容器化部署流程，但目前已被官方标记为弃用（deprecated），不再提供维护和更新。官方推荐使用替代镜像 datadog/agent-buildimages-circleci-runner 以获取持续支持。

核心功能和特性

原镜像核心功能（基于 Datadog Agent 6）

• 系统与应用监控：收集主机、容器、应用的关键指标（CPU、内存、网络、磁盘等）。
• 日志收集：支持容器日志、应用日志的聚合与转发至 Datadog 平台。
• 分布式追踪：集成 APM（应用性能监控）功能，追踪分布式系统中的请求链路。
• 自动发现：自动识别容器化环境中的服务与实例，动态调整监控范围。
• 配置灵活性：支持通过环境变量、配置文件自定义监控规则与集成。

重要说明

由于该镜像已停止维护，上述功能可能存在安全漏洞或兼容性问题，且无法获得官方更新支持，不建议在生产环境中继续使用。

使用场景和适用范围

原适用场景

• 容器化环境（如 Kubernetes、Docker Swarm）中的系统监控。
• 微服务架构下的应用性能与日志集中管理。
• 需要快速部署 Datadog Agent 的临时测试或演示环境。

当前建议

鉴于镜像已弃用，所有基于该镜像的部署场景均应迁移至官方替代镜像 datadog/agent-buildimages-circleci-runner，以确保监控功能的稳定性、安全性及持续更新支持。

使用方法和配置说明

原基本使用方法（不推荐，仅供迁移参考）

环境变量配置

原镜像运行需至少配置以下核心环境变量：

• DD_API_KEY：Datadog 账户 API 密钥（必填），用于 Agent 与 Datadog 平台认证。
• DD_SITE：Datadog 平台站点（如 datadoghq.com 或 datadoghq.eu，默认 datadoghq.com）。

Docker 运行示例（原方式）

docker run -d \
  --name datadog-agent \
  -e DD_API_KEY=<YOUR_API_KEY> \
  -e DD_SITE=datadoghq.com \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc:ro \
  -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
  datadog/agent:latest

弃用与迁移指引

1. 停止使用原镜像：逐步下线基于 datadog/agent 镜像的部署实例。
2. 迁移至替代镜像：使用 datadog/agent-buildimages-circleci-runner 替代，具体使用方法参考该镜像官方文档。
3. 更新配置：根据替代镜像的要求调整环境变量、挂载卷及监控规则，确保与当前 Datadog 平台功能兼容。

注意事项

• 安全风险：原镜像不再接收安全更新，可能存在未修复漏洞，请勿用于生产环境。
• 功能滞后：无法支持 Datadog 平台新增功能（如新型指标、集成插件），监控能力可能受限。
• 官方支持：原镜像相关问题将不再获得 Datadog 技术支持，建议通过替代镜像的官方渠道获取帮助。