appdynamics/machine-agent-analytics

Machine Agent（带Kubernetes分析支持）

镜像概述与主要用途

该Docker镜像是一个为Kubernetes环境设计的Machine Agent，基于OpenJDK 8运行时构建，集成了分析（Analytics）功能。主要用于在Kubernetes集群中监控容器化应用的性能指标、资源使用情况及运行状态，并通过分析功能提供深度 insights，帮助运维和开发团队实现对容器环境的有效监控与问题诊断。

核心功能与特性

• 基于OpenJDK 8运行时：采用openjdk:8-jre-slim作为基础镜像，提供轻量级且稳定的Java运行环境。
• 集成分析功能：包含AppDynamics Machine Agent及其分析代理组件，支持对Kubernetes环境的监控数据进行分析。
• 安全校验机制：支持通过APPD_AGENT_SHA256构建参数对Agent安装包进行SHA256校验，确保文件完整性与安全性。
• 预装系统工具：内置unzip、bash、iproute2、procps、sysstat等必要系统工具，满足监控与诊断需求。
• 环境变量配置：通过MACHINE_AGENT_HOME环境变量指定Agent安装路径（默认/opt/appdynamics），便于路径管理。
• 非root用户兼容：对/opt目录设置组权限（chgrp -R 0、chmod -R g=u），支持非root用户运行，符合容器安全最佳实践。
• 监控端口暴露：默认暴露9090端口，用于Agent通信与监控数据传输。
• 启动脚本支持：通过startup.sh脚本统一启动流程，包含分析代理更新脚本updateAnalyticsAgent.sh，便于初始化配置。

使用场景与适用范围

• Kubernetes集群监控：适用于对Kubernetes集群中容器、Pod、节点的性能指标（如CPU、内存、网络）进行实时监控的场景。
• 容器化应用分析：支持对微服务架构下的容器化应用进行深度分析，识别性能瓶颈、资源争用等问题。
• DevOps/SRE工作流：可集成到CI/CD管道或运维监控系统中，为开发和运维团队提供容器环境的可视化监控数据。
• 大规模容器环境：可部署于生产级Kubernetes集群，支持多节点、多命名空间的监控覆盖。

使用方法与配置说明

构建参数

构建镜像时需指定以下参数：

• APPD_AGENT_VERSION（必填）：Machine Agent版本号，用于指定待部署的Agent安装包版本（如21.10.0）。
• APPD_AGENT_SHA256（可选）：Agent安装包的SHA256校验和。若提供，构建过程会执行校验；若不提供，直接解压安装包。

环境变量

运行容器时可配置的环境变量：

• MACHINE_AGENT_HOME：Agent安装目录，默认值为/opt/appdynamics，通常无需修改。

端口映射

容器默认暴露9090端口，需映射到主机端口以实现Agent通信，建议映射为9090:9090。

Docker部署示例

构建镜像

（需提前准备MachineAgent-${APPD_AGENT_VERSION}.zip安装包）

bash
docker build \
  --build-arg APPD_AGENT_VERSION=21.10.0 \
  --build-arg APPD_AGENT_SHA256=abc123def456... \  # 可选，替换为实际校验和
  -t appdynamics/machine-agent-analytics:latest .

运行容器

bash
docker run -d \
  -p 9090:9090 \
  --name machine-agent \
  -e MACHINE_AGENT_HOME=/opt/appdynamics \  # 可选，默认已设置
  appdynamics/machine-agent-analytics:latest

Kubernetes部署示例（Deployment片段）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: machine-agent
spec:
  replicas: 1
  selector:
    matchLabels:
      app: machine-agent
  template:
    metadata:
      labels:
        app: machine-agent
    spec:
      containers:
      - name: machine-agent
        image: appdynamics/machine-agent-analytics:latest
        ports:
        - containerPort: 9090
        env:
        - name: MACHINE_AGENT_HOME
          value: /opt/appdynamics