dynatrace/dynatrace-activegate

Dynatrace-ActiveGate 镜像文档

1. 镜像概述和主要用途

Dynatrace-ActiveGate 是 Dynatrace 软件智能平台的核心组件，旨在支持平台对可观测性和安全数据的高效摄入，从而释放 Dynatrace 端到端大规模分析能力。该镜像专为容器化环境设计，能够无缝集成至各类部署架构中。在 Kubernetes 环境中，其主要用途包括：

• 实现 Kubernetes API 监控
• 安全路由可观测性数据至 Dynatrace 集群

2. 核心功能和特性

2.1 数据摄入与集成

支持高效采集、处理可观测性（如 metrics、logs、traces）和安全数据，确保数据完整性和实时性。

2.2 Kubernetes API 监控

深度集成 Kubernetes 环境，提供对 Kubernetes API 资源的实时监控能力，支持集群状态跟踪与问题诊断。

2.3 安全数据路由

通过加密通道将采集的数据安全路由至 Dynatrace 集群，保障数据传输过程中的机密性和可靠性。

2.4 容器化部署优化

适配容器化环境特性，支持灵活扩展和资源优化，可与 Kubernetes 等容器编排平台无缝协同。

3. 使用场景和适用范围

3.1 适用环境

• Kubernetes 集群（用于 API 监控和数据路由）
• 需要集成可观测性数据至 Dynatrace 平台的各类容器化部署架构

3.2 典型使用场景

• 企业级 Kubernetes 集群的全链路可观测性数据采集与监控
• 安全数据与可观测性数据的统一集成与分析
• 大规模分布式系统中数据的高效路由与处理

4. 使用方法和配置说明

4.1 前置要求

• 已部署 Dynatrace 集群并获取接入凭证
• 目标环境满足镜像支持的版本要求（详见第 6 章）

4.2 基本部署步骤

详细配置选项（如环境变量、网络策略、资源限制等）需参考 Dynatrace 官方文档。以下为基础部署示例：

4.2.1 Docker 运行示例

bash
docker run -d \
  --name dynatrace-activegate \
  --restart unless-stopped \
  # 需根据实际配置添加环境变量（如Dynatrace集群URL、认证令牌等） \
  -e DT_TENANT=<Dynatrace租户URL> \
  -e DT_TOKEN=<接入令牌> \
  # 挂载必要的配置文件或持久化存储（如需） \
  -v /path/to/local/config:/var/lib/dynatrace/activegate/config \
  dynatrace/activegate:latest

4.2.2 Docker Compose 配置示例

yaml
version: '3'
services:
  activegate:
    image: dynatrace/activegate:latest
    container_name: dynatrace-activegate
    restart: unless-stopped
    environment:
      - DT_TENANT=<Dynatrace租户URL>
      - DT_TOKEN=<接入令牌>
      # 其他配置参数参考官方文档
    volumes:
      - /path/to/local/config:/var/lib/dynatrace/activegate/config
    # 如需网络配置，添加network_mode或ports映射

4.3 详细配置说明

ActiveGate 的完整配置（如数据采集规则、网络代理设置、资源限制等）需参考 Dynatrace 官方文档，根据具体业务场景调整参数。

5. 镜像签名验证

该容器镜像使用 https://github.com/sigstore/cosign 进行签名，可通过以下公钥验证镜像完整性：
公钥地址：https://ca.dynatrace.com/v1/cosign.pub

验证命令示例：

bash
cosign verify --key https://ca.dynatrace.com/v1/cosign.pub dynatrace/activegate:latest

6. 支持版本

部署前需确认环境满足以下支持版本要求（详情见官方文档）：

• Kubernetes 版本：参考 Dynatrace Kubernetes/OpenShift 支持模型
• 操作系统版本：参考 ActiveGate Linux 系统要求
• CPU 架构：参考 ActiveGate Linux 系统要求 - 支持的 CPU 架构

7. 客户支持

如遇部署或运行问题，可通过 Dynatrace 支持团队 获取技术支持。

8. 使用条款

使用本镜像需遵守 Dynatrace 使用条款。