datadog/agent

Datadog Agent Docker镜像文档

镜像概述与主要用途

Datadog Agent的Docker容器化版本，用于监控、收集和上报系统、应用程序及服务的性能指标、日志与事件数据，支持多环境下的统一可观测性管理。

核心功能与特性

• 多架构与系统支持

  • 架构：amd64、arm64v8
  • 操作系统：Linux、Windows（支持版本：1809、1909、2004、20h2）

• 多版本支持

  • 提供Agent 7（推荐）和Agent 6两个系列，满足不同环境需求。

• 灵活镜像变体

  • 基础版：不含Java运行时，体积轻量，适用于非JMX监控场景。
  • JMX版：内置Java Runtime Environment（JRE），支持JMX协议监控（如Java应用）。

使用场景与适用范围

• JMX监控需求：若需监控Java应用（如JVM指标、MBean数据），选择带-jmx后缀的镜像变体。
• 轻量级部署：无需JMX监控时，选择基础版镜像以减少资源占用。
• 版本稳定性：生产环境建议使用固定版本标签（如7.X.X），避免自动升级导致的兼容性问题；测试环境可使用最新版本标签（如7）。

版本与标签说明

Agent 7系列

包含Python 3解释器，支持Python监控插件，为当前主力版本。

Agent 6系列

包含Python 2解释器（Python 2已于2020年1月1日停止维护），仅推荐用于过渡期兼容场景。

镜像变体详情

agent:<version>（基础版）

• 特点：不含Java运行时，镜像体积更小。
• 适用场景：无需JMX协议监控的环境（如纯Linux系统、非Java应用）。

agent:<version>-jmx（JMX版）

• 特点：内置JRE，支持通过JMX协议采集Java应用指标。
• 适用场景：需监控Java应用（如Tomcat、Spring Boot）或依赖JMX的服务。
• 推荐：若不确定监控需求，优先选择此变体以保证兼容性。

使用方法

镜像拉取

根据版本和变体需求拉取镜像：

bash
# 拉取Agent 7最新minor版本（JMX版）  
docker pull gcr.io/datadoghq/agent:7-jmx  

# 拉取Agent 7固定版本（基础版）  
docker pull gcr.io/datadoghq/agent:7.45.0  

容器部署

基本运行示例（需结合实际配置参数，具体参考官方文档）：

bash
# 运行Agent 7 JMX版容器（示例，需补充API密钥等配置）  
docker run -d \  
  --name datadog-agent \  
  gcr.io/datadoghq/agent:7-jmx  

注意：实际部署需配置必要参数（如DD_API_KEY、监控目标等），详情参见官方镜像使用说明。

官方文档与支持

文档资源

• 官方文档：[***]
• 镜像使用指南：https://github.com/DataDog/datadog-agent/tree/master/Dockerfiles/agent
• Agent核心文档：https://github.com/DataDog/datadog-agent/tree/master/docs

支持与反馈

• 技术支持：联系Datadog支持团队
• 问题反馈/贡献：https://github.com/DataDog/datadog-agent

许可证信息

• 软件许可证：https://github.com/DataDog/datadog-agent/blob/master/LICENSE
• 镜像可能包含基础系统（如Bash）及依赖组件，用户需确保其使用符合所有组件的许可证要求。