# Java应用接入APM
#### Java应用接入APM
1. 登录[APM控制台](https://console.huaweicloud.com/apm2/)。
2. 在左侧导航栏中选择"应用监控 \> 应用列表"。
3. 进入"接入应用"页面。 
   - 首次接入应用时，单击"点击接入应用"，进入"接入应用"页面。
   
   - 已有探针接入时，在页面右上角，单击"接入应用"，进入"接入应用"页面。
   
   
   
   
4. 选择"区域"和"应用"。若未有应用，可单击"创建应用"，弹出"创建应用"弹窗，具体操作请参见[创建应用](https://support.huaweicloud.com/usermanual-apm2/apm_07_0050.html#apm_07_0050__section1684713176449)。
5. "接入方式"选择OpenTelemetry。
6. "服务端语言"选择Java。
7. 数据接入。 
   1. 下载OpenTelemetry Java Agent。 前往[Agent下载地址](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases)，下载后将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       | 上报地址，请参见*[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。*                                                     | 必填   |
      | Authentication | 鉴权信息，获取信息方式请参见[查看应用管理](https://support.huaweicloud.com/usermanual-apm2/apm_07_0101.html#apm_07_0101__section15411119102711)中获取"APPKEY"的值。 | 必填   |