使用代理接入Agent

通常部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。如果接入APM的机器与APM服务网络无法连通，可以通过接入代理的方式完成APM Agent接入。

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

APM支持云下业务接入云上APM，详细操作参见云下业务接入云上APM。

1. 配置代理机。
   1. 登录AOM 2.0控制台。
   2. 在菜单栏选择“全局设置”，在左侧导航栏中，选择“采集设置 > 代理区域管理”，进入代理区域管理页面。
   3. 单击“新增代理区域”，自定义代理区域名称，并设置网络类型为“内网”。

      

   4. 单击“添加代理机”，选择新增的代理区域和要作为代理机的主机，代理ip为代理机的公网ip，端口默认填充32555，取值范围支持1025到65535。

      

   5. 在ECS界面配置代理机安全组，在入方向规则添加代理端口，并放通客户端网段。

      

2. 下载并配置JavaAgent。
   1. 下载JavaAgent，参考探针下载地址下载apm-javaagent，并将JavaAgent下载到需要接入APM机器的任意目录。示例命令如下：

      curl -O https://xxx/apm-javaagent-x.x.x.tar

   2. 执行tar命令解压JavaAgent。示例命令如下：

      tar -xvf apm-javaagent-x.x.x.tar

   3. 修改JavaAgent中的apm.config配置文件，详见修改apm.config配置文件。master.address配置请参见探针接入地址，将获取接入JavaAgent所需的AK/SK中获取的AK/SK写入配置文件access.key/secret.key中，并添加apm.proxy=ip:port（此处为aom界面的代理ip:端口），如下图所示。

      

3. 重启应用。

   在启动服务的java命令中配置apm-配置apm-javaagent.jar包所在路径，并指定java进程在APM界面所属的应用名、组件名和环境名。

   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=myApp,env=dev,business=myBusiness -jar myAppjar

   注意，应用名称需要在APM界面手动创建，其余层级可以根据参数自动生成。