更新时间:2026-08-13 GMT+08:00
分享

Docker通过Java探针接入APM

前提条件

  • 部署APM Agent时,必须确保接入APM的机器与APM服务网络连通,Agent才能正常工作。
  • Java语言支持增强型探针、OpenTelemetry和SkyWalking。

操作步骤

  1. 登录APM控制台
  2. 在左侧导航栏中选择“应用监控 > 应用列表”。
  3. 进入“接入应用”页面。

    • 首次接入应用时,单击“点击接入应用”,进入“接入应用”页面。
    • 已有探针接入时,在页面右上角,单击“接入应用”,进入“接入应用”页面。

  4. 选择“区域”和“应用”。若未有应用,可单击“创建应用”,弹出“创建应用”弹窗,具体操作请参见创建应用
  5. “接入方式”选择增强型探针、OpenTelemetry或者SkyWalking。
  6. “服务端语言”选择Java。
  7. 单击“下载并安装 JavaAgent”命令后的,复制JavaAgent安装命令。

    如果直接复制安装JavaAgent的命令,请注意填写“APM_AK”和“APM_SK”时,删除“{}”。例如:
    curl -k https://javaagent.***/apm_agent_install2.sh -o apm_agent_install.sh && bash apm_agent_install.sh -ak * -sk * -masteraddress https://**** -obsaddress https://javaagent.***.com -version latest; history -cw; history -r 
    图1 复制JavaAgent安装命令

  8. 将复制的命令放入Dockerfile文件中,并增加JAVA_TOOL_OPTIONS环境变量。

    RUN curl -k https://javaagent.obs.xx-xxx-x.xxxx.huawei.com/apm_agent_install2.sh -o apm_agent_install.sh && bash apm_agent_install.sh -ak {AK} -sk {SK} -masteraddress https://xxx.xx.xx.xx:xxx -obsaddress https://javaagent.obs.xx-xxx-x.xxxx.huawei.com -version latest
    
    ENV JAVA_TOOL_OPTIONS="-javaagent:\({PROJECT_DIR}/apm-javaagent/apm-javaagent.jar=appName=\){APP_NAME}"

  9. 重新构建镜像,Dockerfile文件示例。

    FROM openjdk
    RUN mkdir /opt/cloud 
    ENV PROJECT_DIR=/opt/cloud
    ENV APP_NAME=hello
    WORKDIR $PROJECT_DIR
    ADD ${APP_NAME}.jar ${APP_NAME}.jar
    RUN curl -k https://javaagent.obs.xx-xxx-x.xxxx.huawei.com/apm_agent_install2.sh -o apm_agent_install.sh && bash apm_agent_install.sh -ak {AK} -sk {SK} -masteraddress https://xxx.xx.xx.xx:xxx -obsaddress https://javaagent.obs.xx-xxx-x.xxxx.huawei.com -version latest
    ENV JAVA_TOOL_OPTIONS="-javaagent:${PROJECT_DIR}/apm-javaagent/apm-javaagent.jar=appName=${APP_NAME}"
    CMD ["bash","-c","java -jar ${APP_NAME}.jar" ]

  10. 重新部署应用。

相关文档