datadog/cluster-agent-dev

Datadog Cluster Agent (DCA) Docker镜像文档

1. 镜像概述和主要用途

本镜像为Datadog官方提供的Cluster Agent（简称DCA）Docker镜像，用于在集群环境中部署和运行Datadog Cluster Agent。DCA作为集群级监控组件，主要用于简化容器集群（如Kubernetes）的监控管理，提供集中化的指标聚合、配置分发及服务发现等能力。

2. 核心功能和特性

DCA的核心功能包括但不限于集群级监控指标聚合、跨节点代理配置管理、服务发现优化等。具体功能详情请参考https://github.com/DataDog/datadog-agent%E3%80%82

3. 使用场景和适用范围

适用于需要在容器集群环境中部署Datadog监控的场景，尤其适合Kubernetes等编排平台，帮助用户简化集群监控架构、减少监控资源占用、提升监控数据采集效率。

4. 使用方法和配置说明

4.1 前提条件

• 已获取有效的Datadog API密钥（可从Datadog控制台获取）。
• 目标环境已安装Docker引擎或Docker Compose。

4.2 快速启动（docker run命令）

使用以下命令启动DCA容器，替换<YOUR_API_KEY>为实际的Datadog API密钥：

shell
docker run -d -ti \
  -e DD_API_KEY=<YOUR_API_KEY> \
  -e DD_CMD_PORT=1245 \  # 可选，指定DCA服务端口
  -e DD_HOSTNAME=my-dca-host \  # 可选，指定metrics主机名
  datadog/cluster-agent-dev:dca

参数说明：

• -d：后台运行容器；
• -ti：分配交互终端（用于容器日志和调试）；
• -e：设置环境变量。

4.3 Docker Compose配置示例

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  datadog-cluster-agent:
    image: datadog/cluster-agent-dev:dca
    container_name: dca
    restart: always
    environment:
      - DD_API_KEY=<YOUR_API_KEY>  # 必填，替换为实际API密钥
      - DD_HOSTNAME=cluster-agent-01  # 可选，自定义主机名
      - CMD_PORT=1245  # 可选，服务端口，默认可能有默认值（需参考官方文档）
    ports:
      - "1245:1245"  # 映射DCA服务端口到主机（如指定了CMD_PORT）

启动服务：

shell
docker-compose up -d

4.4 环境变量配置说明

5. 更多信息

如需了解DCA的完整功能、高级配置及最佳实践，请参考：

• Datadog Cluster Agent官方文档
• https://github.com/DataDog/datadog-agent