# 使用增强型Java探针监控应用指标 华为云应用性能管理服务（Application Performance Management，简称APM）帮助运维人员快速发现应用的性能瓶颈，以及故障根源的快速定位，为用户体验保驾护航。您无需修改代码，只需为应用安装一个APM Agent，就能够对该应用进行全方位监控，帮助您快速定位出错接口和慢接口、重现调用参数、发现系统瓶颈，从而大幅提升线上问题诊断的效率。 本文以增强型Java探针接入APM为例，帮助您快速上手使用应用性能管理服务。首先需要接入增强型Java探针；然后在APM界面查看探针接入是否成功。待增强型Java探针接入成功后，即可在APM控制台上查看性能监控指标。 #### 操作流程 1. [首次开通APM 2.0并授权]。 2. [接入增强型Java探针]。 3. [查看APM接口调用指标]。 #### 前提条件 - 使用APM 2.0前，需要先注册一个华为账号并进行实名认证。如果您已有一个华为账号，可直接跳过如下操作。 1. 进入[华为云](https://www.huaweicloud.com/)官网，单击页面右上角的"注册"。 2. 参考[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)中操作，完成注册。 3. 注册后参考[实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html)完成个人或企业账号实名认证。 - 为账户充值。如果您的账户有足够金额，请跳到下一个任务。如果您的账户还没有足够金额，请先为账户充值。 - 关于应用性能管理 APM的价格，请参见[APM价格详情](https://www.huaweicloud.com/pricing/calculator.html?tab=detail#/apm)。 - 关于充值，请参见[账户充值](https://support.huaweicloud.com/usermanual-billing/bills-topic_30000002.html)。 - 为用户添加应用性能管理 APM的操作权限。 您需要有APM的管理员权限"APM FullAccess"，具体操作请参考[授权IAM用户使用APM](https://support.huaweicloud.com/usermanual-apm2/apm_07_0037.html)。 - 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。可使用"curl -kv"命令测试目标机器与APM服务器网络是否**连通。** 例如，以检查华北-北京四区域，且接入方式选择"增强型探针"的连通性为例，请登录应用所部署的机器，并输入命令curl -kv 100.125.12.108:41333，其他区域地址请参考[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。 #### 首次开通APM 2.0并授权 1. 使用APM 2.0 前，需要先开通APM 2.0。如果您已开通APM 2.0，可直接跳过如下操作。 1. 登录[APM控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/console/#/login)。 首次登录APM控制台，您可以选择使用应用性能管理的"免费体验"或"开通企业版"。"免费体验"与"开通企业版"的差异参见[产品规格差异](https://support.huaweicloud.com/productdesc-apm2/apm_01_0006.html)。 图1APM控制台首页 ![](https://support.huaweicloud.com/qs-apm2/zh-cn_image_0000002542173331.png "点击放大") 2. 单击"免费体验"，进入免费体验应用性能管理页面。 图2免费体验应用性能管理 ![](https://support.huaweicloud.com/qs-apm2/zh-cn_image_0000002502494970.png "点击放大") 3. 阅读[《APM应用性能管理服务声明》](https://www.huaweicloud.com/declaration/tsa_apm.html) 、 [《法律声明》](https://www.huaweicloud.com/declaration/statement.html)以及[《隐私政策声明》](https://www.huaweicloud.com/declaration/sa_prp.html)后，选择"□ 我已阅读 《APM应用性能管理服务声明》以及《法律声明及隐私权政策》"。 4. 单击"立即体验 "，弹出"请确认已阅读《华为APM应用性能管理服务声明》及《法律声明及隐私权政策》。"提示框。 5. 单击"确定"，最多可以免费使用10个Agent。 2. 自动创建访问密钥。 APM 2.0通过AK/SK进行签名验证，通过授权的账户才能上报数据。 1. 登录[APM控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/console/#/login)。 2. 单击左侧导航栏"系统管理 \> 访问密钥"，进入访问密钥页面。 3. 在访问密钥页面查看自动创建的访问密钥。 #### 接入增强型Java探针 1. 登录[APM控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/console/#/login)。 2. 单击左侧![](https://support.huaweicloud.com/qs-apm2/zh-cn_image_0000002253027164.png)，选择"管理与监管 \> 应用性能管理 APM"，进入APM服务页面。 3. 在左侧导航栏中选择"应用监控 \> 应用列表"。 4. 单击"接入应用"，进入接入应用页面。 5. 选择"区域"和"应用"。单击"创建应用"，弹出"创建应用"弹窗，可以具体操作参见[创建应用](https://support.huaweicloud.com/usermanual-apm2/apm_07_0151.html)。 6. "接入方式"选择增强型探针。 7. "服务端语言"选择Java。 8. 请到"系统管理 \> 访问密钥"界面，获取JavaAgent所需的AK、SK。获取"访问密钥"的方法，请参见[访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。 9. 使用PuTTY等远程登录工具，登录待安装Agent的Linux操作系统主机，并以root或service权限执行相关命令。执行安装命令的用户需要和启动应用的用户保持一致 10. 执行如下命令，下载并安装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 ``` 启动命令示例。 ``` curl -k https://javaagent.obs.cn-north-7.ulanqab.huawei.com/apm_agent_install2.sh -o apm_agent_install.sh && bash apm_agent_install.sh -ak 8fjsIX7QUY8RkeVc -sk 3OgSLPYOlp4R9rUVhMaFGkAhTwNsn6Em2Yciqc0s1NveijRfxSsiWO65VpjS7rvtF2v9ABHQIpzOvTUclHsRzh3iBdyHFUBmKXlzwhunjxS8cxNZrB3pwXDueIp4zvidpznWy5qCMcrCWRh3sGnDVr3RHqV1o4flkPsoUKM1hpddAUyoG8OUxi -masteraddress https:ion latest; history -cw; history -r ``` 表1虚机接入参数说明 | 参数 | 说明 | 是否必填 | |:---|:---|:---| | APM_AK APM_SK | 安装JavaAgent的AK和SK。获取APM_AK和APM_SK方法参见[访问密钥](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包名称。 | 必填 | 11. 添加启动命令并重启应用。Agent安装大约需要1分钟。安装完毕后，在应用服务器的启动脚本中添加以下JVM参数，然后重新启动您的应用。启动命令格式如下。 ``` java -javaagent:探针安装路径/apm-javaagent/apm-javaagent.jar=appName=组件名称,env=环境名称,envTag=环境标签,business=应用别名,subBusiness=子应用名称 -jar 用户应用.jar ``` 启动命令示例。 ``` java -javaagent:/root/apm-javaagent/apm-javaagent.jar=appName=test001,env=env001,envTag=tag001,business=LubanApm -Dserver.port=1024 -jar benchmark-1.jar ``` 表2启动命令参数说明 | 参数 | 说明 | 是否必填 | |:---|:---|:---| | 探针安装路径 | Agent探针安装的路径。 | 必填 | | 组件名称 | 组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。 | 必填 | | 环境名称 | 环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。 | 选填 | | 环境标签 | 环境标签，主要用于环境过滤，多个环境打上相同的环境标签，在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。 | 选填 | | 应用英文名称 | 应用英文名称，为全局概念。如果填写，则必须提前创建该应用。如果为空，则代表默认应用（开通APM时系统会自动创建一个默认应用）。 | 选填 | | 子应用 | 子应用，为全局概念，在应用下面子文件夹。该参数可以为空，为空代表资源挂载在根应用下面，子应用最多支持三层。比如 a/b/c，a、b、c各代表一层。 | 选填 | | 用户应用 | 用户所属的应用名称。 | 必填 | 12. 在左侧导航栏中选择"应用监控 \> 应用列表"，在列表中找到组件名称为"test001"的组件，其"Agent 状态"为"正常"，增强型 Java探针接入成功。 #### 查看APM接口调用指标 增强型 Java探针接入成功后，可以在APM控制台上查看"接口调用"指标。 1. 在左侧导航栏中选择"应用监控 \> 应用列表"，在列表中找到组件名称为"test001"的组件。 2. 单击蓝色字体"test001"，跳转至组件"test001"的"拓扑"界面。 3. 单击"接口调用"，默认显示接口调用页签，"全部实例"的"URL监控"信息。