Cisco AppDynamics Machine Agent Docker镜像文档

镜像概述和主要用途

Cisco AppDynamics Machine Agent Docker镜像是由Cisco官方提供的Machine Agent容器化部署方案，用于简化AppDynamics Machine Agent的安装、配置和运行流程。Machine Agent作为AppDynamics应用性能监控（APM）生态的核心组件，负责收集服务器级别的系统性能指标（如CPU利用率、内存消耗、磁盘I/O、网络流量等）及应用扩展指标，并将数据发送至AppDynamics Controller进行聚合分析与可视化，助力用户全面监控基础设施和应用性能状态。

核心功能和特性

• 容器化部署：基于Docker容器技术，支持快速启动、停止和横向扩展，确保跨环境（物理机、虚拟机、Kubernetes等）的一致性部署体验。
• 官方维护：由Cisco AppDynamics团队持续开发维护，保障与最新版Machine Agent及Controller的兼容性，及时提供安全更新和功能迭代。
• 全面监控能力：内置系统指标采集模块，覆盖CPU、内存、磁盘、网络等核心资源监控，同时支持集成扩展监控器（如数据库、消息队列）。
• 灵活配置机制：支持通过环境变量、配置文件挂载或命令行参数自定义配置（如Controller连接信息、代理属性、监控范围等），适配多样化部署场景。
• 轻量级设计：优化镜像体积与资源占用，适合在资源受限环境中部署，降低基础设施开销。

使用场景和适用范围

• 基础设施监控：需实时监控物理服务器、虚拟机或容器主机系统性能的场景。
• APM生态集成：已采用AppDynamics APM解决方案，需补充服务器级性能数据以构建完整监控视图的企业用户。
• DevOps流程嵌入：在CI/CD流水线中自动化部署Machine Agent，实现监控能力与应用部署的同步交付。
• 动态扩展环境：在Kubernetes、Docker Swarm等容器编排平台中，随业务负载动态调整Machine Agent实例数量。

使用方法和配置说明

前提条件

• 已安装Docker Engine（推荐20.10+版本）或Docker Desktop。
• 已获取AppDynamics Controller访问信息（主机地址、端口、账户名、访问密钥等）。

基本使用命令

直接运行容器

通过docker run命令快速启动Machine Agent容器，核心配置通过环境变量传递：

docker run -d \
  --name machine-agent \
  --restart always \
  -e CONTROLLER_HOST=<your-controller-host> \
  -e CONTROLLER_PORT=<your-controller-port> \
  -e ACCOUNT_NAME=<your-account-name> \
  -e ACCESS_KEY=<your-access-key> \
  -e MACHINE_AGENT_NAME=<custom-machine-name> \  # 可选，自定义代理标识名称
  appdynamics/machine-agent:latest

关键环境变量说明

高级配置：挂载配置文件

对于复杂配置（如扩展监控器、自定义指标规则），可通过挂载本地配置文件覆盖容器默认配置。Machine Agent主配置文件路径为/opt/appdynamics/machine-agent/conf/machine-agent.yml，挂载示例：

docker run -d \
  --name machine-agent \
  --restart always \
  -v /path/to/local/machine-agent.yml:/opt/appdynamics/machine-agent/conf/machine-agent.yml \
  appdynamics/machine-agent:latest

Docker Compose示例

在Docker Compose中集成Machine Agent部署：

version: '3'
services:
  machine-agent:
    image: appdynamics/machine-agent:latest
    container_name: machine-agent
    restart: always
    environment:
      - CONTROLLER_HOST=controller.example.com
      - CONTROLLER_PORT=8090
      - ACCOUNT_NAME=my-account
      - ACCESS_KEY=abc123xyz
      - MACHINE_AGENT_NAME=prod-server-01
    # 如需挂载配置文件，添加以下volumes配置
    # volumes:
    #   - ./machine-agent.yml:/opt/appdynamics/machine-agent/conf/machine-agent.yml

注意事项

• 网络连通性：确保Docker容器网络可访问AppDynamics Controller（需开放对应端口，检查防火墙与网络策略）。
• 资源限制：根据监控需求调整容器资源限制（如--memory、--cpus参数），避免资源竞争影响监控准确性。
• 版本控制：建议通过固定标签（如23.10.0）而非latest控制镜像版本，确保部署稳定性。