# 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. "接入方式"选择"增强型探针"。 6. "服务端语言"选择Java。 7. 数据接入。 - 虚机接入 1. 请到"系统管理 \> 访问密钥"界面，获取JavaAgent所需的AK、SK。获取"访问密钥"的方法，请参见[管理APM访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。 2. 使用SSH客户端远程登录工具，登录待安装Agent的Linux操作系统主机，并以root或service权限执行相关命令。执行安装命令的用户需要和启动应用的用户保持一致。 3. 执行如下命令，下载并安装JavaAgent。 ``` curl -k https://javaagent.obs.****.com/apm_agent_install2.sh -o apm_agent_install.sh && bash apm_agent_install.sh -ak {APM_AK} -sk {APM_SK} -masteraddress APM探针的接入地址 -obsaddress https://javaagent.obs..****.com -version latest; history -cw; history -r ``` 表1虚机接入参数说明 | 参数 | 说明 | 是否必填 | |:---|:---|:---| | APM_AK APM_SK | 安装JavaAgent的AK和SK。获取APM_AK和APM_SK方法参见[管理APM访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。 如果直接复制命安装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 ``` | 必填 | | masteraddress | 接入地址，请参见[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。 | 必填 | | version | Agent版本号。APM提供的latest探针版本，能同时支持多个jdk环境。 | 必填 | | 探针安装路径 | Agent探针安装的路径。 | 必填 | | 组件名称 | 组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。 | 必填 | | 环境名称 | 环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。 | 选填 | | 环境标签 | 环境标签，主要用于环境过滤，多个环境打上相同的环境标签，在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。 | 选填 | | 应用名称 | 应用英文名称，为全局概念。如果填写，则必须提前创建该应用。如果为空，则代表默认应用（开通APM时系统会自动创建一个默认应用）。 | 选填 | | 子应用名称 | 子应用，为全局概念，在应用下面子文件夹。该参数可以为空，为空代表资源挂载在根应用下面，子应用最多支持三层。比如 a/b/c，a、b、c各代表一层。 | 选填 | | 用户应用 | 用户应用jar包名称。 | 必填 | 4. 添加启动命令并重启应用。Agent安装大约需要1分钟。安装完毕后，在应用服务器的启动脚本中添加以下JVM参数，然后重新启动您的应用。启动命令格式如下。 ``` java -javaagent:探针安装路径/apm-javaagent/apm-javaagent.jar=appName=组件名称,env=环境名称,envTag=环境标签,business=应用别名,subBusiness=子应用名称 -jar 用户应用.jar ``` 启动命令示例。 ``` java -javaagent:/root/my-dir/apm-javaagent/apm-javaagent.jar=appName=my-service,env=dev -jar test-2.0.0-SNAPSHOT.jar ``` 表2启动命令参数说明 | 参数 | 说明 | 是否必填 | |:---|:---|:---| | 探针安装路径 | Agent探针安装的路径。 | 必填 | | 组件名称 | 组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。 | 必填 | | 环境名称 | 环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。 | 选填 | | 环境标签 | 环境标签，主要用于环境过滤，多个环境打上相同的环境标签，在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。 | 选填 | | 应用名称 | 应用英文名称，为全局概念。如果填写，则必须提前创建该应用。如果为空，则代表默认应用（开通APM时系统会自动创建一个默认应用）。 | 选填 | | 子应用名称 | 子应用，为全局概念，在应用下面子文件夹。该参数可以为空，为空代表资源挂载在根应用下面，子应用最多支持三层。比如 a/b/c，a、b、c各代表一层。 | 选填 | | 用户应用 | 用户所属的应用名称。 | 必填 | - CCE接入 目前只支持部署在CCE的Java应用通过探针接入到APM，具体操作请参见[CCE容器通过Java探针接入APM](https://support.huaweicloud.com/usermanual-apm2/apm_08_0052.html)。