appdynamics/dynamic-agent-ma

镜像概述

本Docker镜像集成了AppD Machine Agent与专用扩展，旨在提供对Java进程的动态检测能力。通过该镜像，用户可在不修改Java应用代码的情况下，实现对Java进程的实时监控、性能指标收集和分析，无缝集成到AppDynamics监控体系中。

核心功能和特性

• 集成AppD Machine Agent：内置完整的AppD Machine Agent，提供基础的机器级监控能力，包括系统资源使用率、进程状态等指标
• 动态Java进程检测：通过专用扩展实现对Java进程的动态instrumentation，无需重启应用或修改代码
• 性能数据收集：支持收集Java应用的关键性能指标，如响应时间、调用链、JVM状态等
• 灵活配置：可通过环境变量和配置文件自定义检测规则、监控范围及上报策略
• AppDynamics生态集成：与AppDynamics控制器无缝对接，支持数据可视化和告警功能

使用场景和适用范围

• Java应用性能监控：适用于需要对Java应用进行实时性能监控的场景
• 无侵入式监控：适用于无法或不愿修改应用代码以集成监控逻辑的环境
• 多环境支持：可部署于开发、测试和生产环境，满足全生命周期监控需求
• AppDynamics用户：特别适合已采用AppDynamics监控体系的企业用户
• 动态进程管理：适用于需要监控动态启动或频繁变更的Java进程场景

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name appd-java-instrument-agent \
  -e APPD_CONTROLLER_HOST=controller.example.com \
  -e APPD_CONTROLLER_PORT=8090 \
  -e APPD_ACCOUNT_NAME=my-account \
  -e APPD_ACCESS_KEY=your-secure-access-key \
  -e JAVA_PROCESS_PATTERN="java -jar application.jar" \
  --pid=host \
  docker.xuanyuan.run/appdynamics/machine-agent-java-instrument:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  appd-agent:
    image: docker.xuanyuan.run/appdynamics/machine-agent-java-instrument:latest
    container_name: appd-java-instrument-agent
    environment:
      - APPD_CONTROLLER_HOST=controller.example.com
      - APPD_CONTROLLER_PORT=8090
      - APPD_ACCOUNT_NAME=my-account
      - APPD_ACCESS_KEY=your-secure-access-key
      - JAVA_PROCESS_PATTERN=java -jar /app/*.jar
      - LOG_LEVEL=DEBUG
    pid: host
    restart: unless-stopped

高级配置

自定义扩展配置

通过挂载卷方式提供自定义扩展配置文件：

bash
docker run -d \
  --name appd-java-instrument-agent \
  -e APPD_CONTROLLER_HOST=controller.example.com \
  -e APPD_CONTROLLER_PORT=8090 \
  -e APPD_ACCOUNT_NAME=my-account \
  -e APPD_ACCESS_KEY=your-secure-access-key \
  -e JAVA_PROCESS_PATTERN="java -jar application.jar" \
  -v /path/to/custom-extensions:/opt/appdynamics/machine-agent/extensions \
  --pid=host \
  docker.xuanyuan.run/appdynamics/machine-agent-java-instrument:latest

多进程匹配

通过设置多个JAVA_PROCESS_PATTERN环境变量（使用不同后缀）监控多个Java进程：

bash
docker run -d \
  --name appd-java-instrument-agent \
  -e APPD_CONTROLLER_HOST=controller.example.com \
  -e APPD_CONTROLLER_PORT=8090 \
  -e APPD_ACCOUNT_NAME=my-account \
  -e APPD_ACCESS_KEY=your-secure-access-key \
  -e JAVA_PROCESS_PATTERN_1="java -jar app1.jar" \
  -e JAVA_PROCESS_PATTERN_2="java -jar app2.jar" \
  --pid=host \
  docker.xuanyuan.run/appdynamics/machine-agent-java-instrument:latest

注意事项

• 必须使用--pid=host参数，以允许容器访问主机进程空间
• 确保容器具有足够权限访问主机上的Java进程信息
• JAVA_PROCESS_PATTERN应准确匹配目标Java进程的启动命令，建议使用独特的命令片段作为匹配模式
• 在生产环境中，建议设置APPD_CONTROLLER_SSL_ENABLED=true以确保数据传输安全
• 首次启动时，代理需要几分钟时间完成初始化和与控制器的连接