Datadog Agent (ARM64 弃用版) Docker 镜像文档

1. 镜像概述和主要用途

1.1 概述

本镜像为 Datadog Agent 的 ARM64 架构专用版本，目前已正式弃用。Datadog 官方已停止对该镜像的维护与更新，推荐所有用户迁移至支持多架构的 datadog/agent 镜像。

1.2 主要用途

原用于在 ARM64 架构的 Linux 环境中部署 Datadog Agent，实现系统、应用性能监控及日志收集。由于功能已被多架构镜像完全覆盖，当前无继续使用的必要。

2. 核心功能和特性

2.1 原功能特性

• 与官方 Datadog Agent 功能一致，支持 metrics 采集、日志收集、APM 追踪等核心能力
• 针对 ARM64 架构优化的二进制执行文件

2.2 弃用说明

• 不再提供更新：包括功能迭代、安全补丁及 bug 修复
• 兼容性风险：未来可能与 Datadog 后端服务不兼容
• 替代方案：所有功能已集成至多架构镜像 docker.io/datadog/agent，支持 x86_64、ARM64 等主流架构

3. 使用场景和适用范围

3.1 原适用场景

• ARM64 架构服务器/设备（如 AWS Graviton、树莓派等）的监控需求
• 需要在 ARM64 环境中运行 Datadog Agent 的容器化部署

3.2 当前适用范围

无推荐使用场景。所有原使用本镜像的场景均应迁移至 datadog/agent 多架构镜像。

4. 使用方法和配置说明

4.1 迁移至多架构镜像指南

4.1.1 停止并移除旧容器

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

# 移除旧容器
docker rm datadog-agent-arm64

4.1.2 使用多架构镜像部署新 Agent

# 拉取最新多架构镜像（自动匹配当前架构，包括 ARM64）
docker pull datadog/agent:latest

# 启动新 Agent 容器（配置参数与旧版兼容）
docker run -d \
  --name datadog-agent \
  --restart=always \
  --network=host \
  --pid=host \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc:ro \
  -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
  -e DD_API_KEY=<YOUR_DATADOG_API_KEY> \
  -e DD_SITE="datadoghq.com" \
  datadog/agent:latest

4.1.3 验证迁移结果

# 检查新容器状态
docker ps | grep datadog-agent

# 查看 Agent 日志确认正常启动
docker logs datadog-agent

4.2 配置迁移说明

• 原容器的环境变量（如 DD_API_KEY、DD_SITE 等）可直接复用至新镜像
• 挂载的配置文件（如 datadog.yaml）与多架构版完全兼容，无需修改
• 数据卷（如 /var/lib/datadog）可迁移以保留历史监控数据

5. 注意事项

• 安全风险：弃用镜像不再接收安全更新，可能存在未修复漏洞，建议立即迁移
• 功能限制：新功能（如 Datadog 最新监控特性）仅在多架构镜像中提供
• 官方支持：Datadog 技术支持不再受理基于本弃用镜像的问题排查请求

6. 替代方案详情

推荐使用的多架构镜像信息：

• 镜像名称：docker.io/datadog/agent
• 支持架构：x86_64、ARM64、ARMv7 等
• 官方文档：Datadog Agent Docker 部署指南
• 标签策略：提供 latest（最新稳定版）、7（主版本）、7.47.0（具体版本）等标签，支持版本锁定