Java应用接入APM

登录APM控制台。
在左侧导航栏中选择“应用监控 > 应用列表”。
进入“接入应用”页面。
- 首次接入应用时，单击“点击接入应用”，进入“接入应用”页面。
- 已有探针接入时，在页面右上角，单击“接入应用”，进入“接入应用”页面。
选择“区域”和“应用”。若未有应用，可单击“创建应用”，弹出“创建应用”弹窗，具体操作请参见创建应用。
“接入方式”选择“增强型探针”。
“服务端语言”选择Java。

数据接入。

虚机接入

请到“系统管理 > 访问密钥”界面，获取JavaAgent所需的AK、SK。获取“访问密钥”的方法，请参见管理APM访问密钥。
使用SSH客户端远程登录工具，登录待安装Agent的Linux操作系统主机，并以root或service权限执行相关命令。执行安装命令的用户需要和启动应用的用户保持一致。

执行如下命令，下载并安装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访问密钥。如果直接复制命安装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	接入地址，请参见探针接入地址。	必填
version	Agent版本号。APM提供的latest探针版本，能同时支持多个jdk环境。	必填
探针安装路径	Agent探针安装的路径。	必填
组件名称	组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。	必填
环境名称	环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。	选填
环境标签	环境标签，主要用于环境过滤，多个环境打上相同的环境标签，在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。	选填
应用名称	应用英文名称，为全局概念。如果填写，则必须提前创建该应用。如果为空，则代表默认应用（开通APM时系统会自动创建一个默认应用）。	选填
子应用名称	子应用，为全局概念，在应用下面子文件夹。该参数可以为空，为空代表资源挂载在根应用下面，子应用最多支持三层。比如 a/b/c，a、b、c各代表一层。	选填
用户应用	用户应用jar包名称。	必填

添加启动命令并重启应用。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各代表一层。	选填
用户应用	用户所属的应用名称。	必填