Java语言接入

快速接入操作步骤

1. 登录APM控制台。
2. 单击左侧，选择“管理与监管 > 应用性能管理 APM”，进入APM服务页面。
3. 在左侧导航栏中选择“应用监控 > 应用列表”。
4. 单击“接入应用”，进入接入应用页面。
5. 选择“区域”和“应用”。单击“创建应用”，弹出“创建应用”弹窗，可以具体操作参见创建应用。
6. “接入方式”选择增强型探针。
7. “服务端语言”选择Java。
8. 数据接入。
   • 虚机接入
     1. 请到“系统管理 > 访问密钥”界面，获取JavaAgent所需的AK、SK。获取“访问密钥”的方法，请参见访问密钥。
     2. 使用PuTTY等远程登录工具，登录待安装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 https://**.**.**.**:**** -obsaddress https://javaagent.obs..****.com -version latest; history -cw; history -r

        表1 虚机接入参数说明

        参数	说明	是否必填
        APM_AK APM_SK	安装JavaAgent的AK和SK。获取APM_AK和APM_SK方法参见访问密钥。 如果直接复制命安装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包名称。	必填

     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接入
     1. 前提条件。
        • CCE容器安装Agent建议使用自有探针。
        • 已经使用CCE部署了容器应用。
     2. 请到“系统管理 > 访问密钥”界面，获取JavaAgent所需的AK、SK。获取“访问密钥”的方法，请参见访问密钥。
     3. 目前只支持部署CCE的Java应用。相关参数说明参见表3。

        表3 性能管理配置参数列表

        参数名称	参数说明
        安装探针	选择安装探针。目前支持“不启动”和“APM 2.0探针”。
        探针版本	选择探针的版本类型。探针类型建议与负载所在node节点的CPU架构对应版本一致。 APM提供的latest探针版本，能同时支持多个jdk环境。
        探针升级策略	探针升级的方式、策略。默认为“重启自动升级”。 重启自动升级：每次都尝试重新下载镜像。 重启手动升级：如果本地有该镜像，则使用本地镜像，本地不存在时下载镜像。
        APM环境	输入APM环境名称，该参数为选填。
        APM应用	选择一个已有的APM应用。
        子应用	输入APM子应用，该参数为选填。
        接入密钥	将会自动获取APM服务的密钥信息，详情参见访问密钥。

     4. 登录CCE控制台，将容器服务上的Java应用通过Pinpoint探针接入到APM。CCE接入方法参见CCE容器接入JavaAgent。