eG Java BTM插桩分析器 Docker镜像文档

镜像概述

eG Java BTM插桩分析器Docker镜像是针对Java应用设计的业务事务管理（BTM）工具容器化实现。该镜像集成插桩（Instrumentation）技术，通过Java Agent方式注入到目标Java应用中，实现对Java应用业务事务的全链路性能监控、实时分析及问题诊断，为开发与运维团队提供应用性能优化依据。

核心功能与特性

核心功能

• 业务事务插桩：基于Java Instrumentation技术，对Java应用字节码进行动态插桩，无需修改应用源码即可实现业务事务数据采集
• 性能指标监控：实时采集业务事务响应时间、吞吐量、错误率等关键性能指标（KPI）
• 调用链追踪：记录业务事务执行过程中的方法调用链、数据库操作、外部服务调用等详细链路信息
• 性能诊断：提供事务执行耗时分布、瓶颈节点定位、异常事务标记等诊断能力

特性

• 低侵入性：通过Java Agent注入，无需修改应用代码及部署架构
• 兼容性广：支持主流Java版本（JDK 8+）及常见Java框架（Spring、Spring Boot、Tomcat等）
• 轻量级：对目标应用性能影响小，资源占用低
• 可配置性：支持自定义监控范围、指标采集频率及分析规则

使用场景与适用范围

适用场景

• Java应用性能监控：对生产/测试环境Java应用进行7x24小时业务事务性能监控
• 业务事务追踪：追踪核心业务流程（如订单提交、支付流程）的端到端执行路径与性能
• 性能瓶颈定位：在应用出现响应缓慢、吞吐量下降时，快速定位耗时方法、阻塞资源等瓶颈点
• 版本发布验证：新功能发布后，通过对比事务性能指标验证发布质量

适用范围

• 基于JDK 8+开发的Java应用
• 采用Spring、Spring Boot、Micronaut等主流Java框架的应用
• 需要进行业务级性能监控与分析的企业级Java应用

使用方法与配置说明

基本使用（docker run）

通过docker run命令启动容器，需挂载目标Java应用及配置插桩参数：

bash
docker run -d \
  --name eg-java-btm-profiler \
  -v /path/to/your/java/app:/app \  # 挂载目标Java应用目录
  -v /path/to/profiler/config:/config \  # 挂载分析器配置文件目录
  -e JAVA_APP_JAR=app.jar \  # 目标Java应用JAR包名称
  -e JAVA_AGENT_PARAMS="-Dbtm.monitor.port=8080 -Dbtm.trace.level=INFO" \  # Java Agent参数
  -p 8080:8080 \  # 暴露监控端口
  eg-java-btm-instrumentation-profiler:latest

核心环境变量配置

配置文件说明（btm.properties）

配置文件用于定义监控范围、指标采集规则等，典型配置示例：

properties
# 监控的业务事务名称（支持正则表达式）
btm.transaction.names=orderSubmit,userLogin,paymentProcess

# 采集指标类型（responseTime/throughput/errorRate/callChain）
btm.metrics.types=responseTime,throughput,callChain

# 采样率（0.0-1.0，1.0表示全量采样）
btm.sampling.rate=1.0

# 慢事务阈值（毫秒，超过该值标记为慢事务）
btm.slow.transaction.threshold=500

# 排除监控的方法（类名.方法名，支持正则）
btm.exclude.methods=com.example.util.*,com.example.log.*

数据查看与分析

启动容器后，可通过以下方式获取分析数据：

1. 监控端口：通过容器暴露的端口（如8080）访问内置Web控制台，查看实时性能指标与事务追踪数据
2. 日志输出：分析结果默认输出至容器日志，可通过docker logs eg-java-btm-profiler查看
3. 数据持久化：配置btm.data.output.path参数，将分析数据持久化至挂载目录（如/config/output），支持CSV/JSON格式

注意事项

• 目标Java应用需支持Java Agent注入（JDK 8+默认支持）
• 首次启动时需确保配置文件正确，避免因参数错误导致插桩失败
• 高采样率（如1.0）可能增加应用CPU/内存开销，生产环境建议根据业务量调整采样率
• 容器需与目标Java应用网络互通（若分离部署），确保监控数据正常传输