快速接入Agent

前提条件

部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。

可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且源代码选择“增强型探针”的连通性为例，请登录应用所部署的机器，并输入命令telnet 100.125.12.108:41333，其他区域地址请参考接入地址。

接入应用

1. 登录AOM 2.0控制台。
2. 在左侧导航栏中选择“接入中心”。
3. 在右侧“应用层”面板单击“Java”卡片。
4. 在“基础信息”下选择“区域”和“应用”。
   如果现有的应用无法满足需要，可以单击“创建应用”添加，详细参数说明请参见表1。

   图1 基础信息
   

   表1 创建应用参数说明

   参数名称	说明
   应用名称	应用显示的名称，不能为空。 支持输入1~128个字符，只能包含数字、字母、下划线、中划线、并且以英文字母开头。
   应用别名	应用的别名。设置应用别名后应用名称优先展示应用别名。 支持输入1~128个字符，只能包含数字、字母、中文、下划线、中划线、括号以及小数点。
   企业项目	在下拉菜单中选择企业项目，仅开通企业版才会显示。
   描述	应用的描述信息，最多可输入1000个字符。

5. 接入方式默认选择“增强型探针”。
6. 数据接入方式选择“虚机接入”，按照步骤接入。
   图2 虚机接入
   

   表2 参数说明

   参数	说明	是否必填
   pwd	apm-javaagent.jar包所在路径。	必填
   appName	组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。	必填
   env	环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。	选填
   envTag	环境标签，主要用于环境过滤，多个环境打上相同的环境标签，在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。	选填
   business	应用英文名称，为全局概念。如果填写，则必须提前创建该应用。如果为空，则代表默认应用（开通APM时系统会自动创建一个默认应用）。	选填
   subBusiness	子应用，为全局概念，在应用下面子文件夹。该参数可以为空，为空代表资源挂载在根应用下面，子应用最多支持三层。比如 a/b/c，a、b、c各代表一层。	选填
   instanceName	默认为空。当一个应用在机器上部署多个实例，可以通过instanceName来区分，比如7001或者8001两个端口实例。这种实际情况下很少发生，一台机器部署多个java实例往往是不同的应用程序，相同应用程序的部署两个实例很少见。	选填

动态配置master.address以及AK/SK

支持动态配置master.address以及AK/SK。

用户可以通过配置环境变量的方式，给APM_MASTER_ADDRESS、APM_ACCESS_KEY（apm-ak）以及APM_SECRET_KEY（apm-sk）赋值。获取AK/SK的具体操作，请参见获取AK/SK，获取master.address，请参见接入地址。

• 如果javaagent配置文件和环境变量同时配置了AK、SK、master.address，那么环境变量配置的值优先生效。
• Agent 2.3.19之后版本支持动态配置master.address以及AK/SK。