文档首页/ 应用性能管理 APM/ 用户指南（2.0）/ 接入APM/ 增强型、OpenTelemetry以及SkyWalking方式接入APM实现性能指标监控/ OpenTelemetry方式接入APM实现指标监控/ Java应用接入APM
更新时间：2026-08-13 GMT+08:00
查看PDF
分享

Java应用接入APM

Java应用接入APM

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

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

  4. 选择“区域”和“应用”。若未有应用，可单击“创建应用”，弹出“创建应用”弹窗，具体操作请参见创建应用。
  5. “接入方式”选择OpenTelemetry。
  6. “服务端语言”选择Java。
  7. 数据接入。

    1. 下载OpenTelemetry Java Agent。

      前往Agent下载地址，下载后将Agent文件放在Java进程有访问权限的目录。

    2. 添加探针启动参数并重启应用。 
      java -javaagent:探针安装路径  \
  -Dotel.exporter.otlp.protocol=grpc  \
  -Dotel.exporter.otlp.traces.endpoint=上报地址 \
  -Dotel.exporter.otlp.headers=Authentication=鉴权信息  \
  -Dotel.service.name=应用名称.组件名称.环境名称  \  
  -Dotel.metrics.exporter=none  \
  -Dotel.logs.exporter=none  \
  -jar <用户应用>.jar  &
      启动命令示例： 
      curl http://***.**.**.***:****/rolldice?player=Alex
      表1 参数说明

      参数

      说明

      是否必填

      探针安装路径

      opentelemetry-agent-path，即：探针下载后存放的路径。

      必填

      应用名称

      应用显示的名称。一个应用代表一个逻辑单元，是一个全局概念，各个region都可以看到相同的应用信息，比如一个租户下面比较独立的功能模块可以定义为一个应用。

      必填

      组件名称

      组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。

      必填

      环境名称

      环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。

      选填

      Endpoint

      上报地址，请参见探针接入地址。

      必填

      Authentication

      鉴权信息，获取信息方式请参见查看应用管理中获取“APPKEY”的值。

      必填

相关文档