Elastic APM监控WSO2应用：仅能采集指标无法捕获链路追踪求助

问题背景 #

已为基于WSO2的API配置Elastic APM监控，可正常查看指标数据，但无法捕获链路追踪数据。已按配置说明完成操作并检查参数，追踪数据仍未出现，具体操作如下：

• 将Elastic APM Java Agent添加到micro-integrator.sh启动脚本，配置片段：

while [ "$status" = "$START_EXIT_STATUS" ]
do
    $JAVACMD \
    .....
    -javaagent:/path/to/elastic-apm-agent-1.43.0.jar \
    -Delastic.apm.service_name=tracing-service \
    -Delastic.apm.application_packages=com.example \
    -Delastic.apm.environment=develop \
    -Delastic.apm.server_urls=http://127.0.0.1:8200 \
    org.wso2.micro.integrator.bootstrap.Bootstrap $*
    status=$?
done

• 应用及Elastic APM Agent日志无错误或警告
• Elastic APM UI仅展示指标，无链路追踪记录

排查与修复方案 #

1. 修正application_packages配置 #

当前配置的com.example未覆盖WSO2微集成器的核心业务包，Agent只会追踪指定包下的代码链路。需添加WSO2核心包路径：

-Delastic.apm.application_packages=org.wso2,com.example

org.wso2是WSO2微集成器核心组件的根包，添加后Agent才能捕获API处理的完整链路。

2. 开启Agent调试日志 #

虽然无报错，但调试日志能暴露追踪触发的细节问题。在启动参数中添加：

-Delastic.apm.log_level=DEBUG

重启服务后，查看Agent日志（默认输出到控制台或wso2mi/logs目录），重点排查是否有“未匹配可追踪方法”“采样率为0”等提示。

3. 强制设置采样率 #

若采样率被全局配置覆盖为0，会导致无追踪数据生成。显式设置采样率：

-Delastic.apm.transaction_sample_rate=1.0

4. 验证流量触发 #

链路追踪需要实际API请求触发，确保已向目标API发送测试请求，且请求经过微集成器处理流程。

5. 检查版本兼容性 #

当前Agent版本为1.43.0，需确保与Elastic APM Server版本兼容（建议两者版本一致，或Agent版本不高于Server版本），版本不匹配可能导致追踪数据上报失败。

6. 解决类加载器隔离问题 #

WSO2微集成器使用自定义类加载器，可能导致Agent无法拦截核心类方法。添加参数强制Agent加载到系统类加载器：

-Delastic.apm.bootstrap_attach=true

内容的提问来源于stack exchange，提问作者Some Guy