Datadog Agent (AMD64 弃用版) 镜像文档

1. 镜像概述和主要用途

本镜像为 Datadog Agent 的历史 AMD64 架构专用版本，目前已正式弃用。Datadog 官方明确建议所有用户迁移至支持多架构的 datadog/agent 镜像（Docker Hub 地址），以获取持续的功能更新、跨平台支持及安全补丁。

2. 核心功能和特性

2.1 原镜像功能（已停止维护）

• 提供 AMD64 架构环境下的基础监控能力，包括系统指标采集、日志聚合、APM 追踪等核心功能。
• 仅支持 Linux/AMD64 单一架构，无跨平台适配能力。

2.2 替代方案：datadog/agent 多架构镜像核心特性

• 多架构支持：覆盖 AMD64、ARM64 等主流架构，适配物理机、虚拟机、容器及边缘设备。
• 持续迭代：包含最新功能更新（如实时监控、扩展集成）、性能优化及安全修复。
• 完整兼容性：与 Datadog 平台全栈产品（指标、日志、安全监控等）无缝对接。

3. 使用场景和适用范围

3.1 原镜像适用场景（已不推荐）

• 仅限老旧 AMD64 架构环境的临时监控需求，且无法获得官方技术支持及更新。

3.2 推荐使用场景（基于 datadog/agent 镜像）

• 所有需要部署 Datadog Agent 的生产/测试环境，包括：
  • 混合架构集群（如 AMD64 + ARM64 节点的 Kubernetes 集群）。
  • 需长期运行并依赖持续功能更新的监控场景。
  • 对安全合规性有要求的企业级环境。

4. 使用方法和配置说明

4.1 重要提示

不建议继续使用本弃用镜像，其功能和安全性将不再更新，可能导致监控数据异常或潜在风险。以下内容仅作为迁移指导。

4.2 迁移至 datadog/agent 镜像的步骤

4.2.1 停止并清理旧容器

# 停止运行中的旧 Agent 容器（假设容器名为 datadog-agent-old）
docker stop datadog-agent-old

# 移除旧容器（可选，避免资源占用）
docker rm datadog-agent-old

4.2.2 部署 datadog/agent 新容器（基础示例）

docker run -d \
  --name datadog-agent \
  --restart=always \
  --network=host \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \  # 用于容器监控（Docker 环境）
  -v /proc/:/host/proc:ro \                          # 主机指标采集
  -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \        # 系统资源监控
  -e DD_API_KEY=<YOUR_DATADOG_API_KEY> \             # 必选，替换为实际 API 密钥
  -e DD_SITE="datadoghq.com" \                       # 可选，指定站点（如 datadoghq.eu 对应欧洲区）
  datadog/agent:latest                               # 使用最新稳定版

4.2.3 关键配置参数（datadog/agent 镜像）

4.3 验证迁移结果

1. 启动新容器后，通过 docker logs datadog-agent 检查 Agent 启动日志，确认无错误信息。
2. 登录 Datadog 控制台，在 Infrastructure > Hosts 中确认新 Agent 已成功连接并上报数据。

5. 注意事项

• 迁移前建议备份原 Agent 配置文件（如 datadog.yaml、检查配置等），并在新镜像中复用核心配置。
• 若使用编排工具（如 Docker Compose、Kubernetes），需同步更新镜像名称为 datadog/agent，并移除架构限制参数（如 platform: linux/amd64）。
• 如需技术支持，可参考 Datadog Agent 官方文档 或联系 Datadog 客户成功团队。