# 使用代理接入APM
通常部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。如果接入APM的机器与APM服务网络无法连通，可以通过接入代理的方式完成APM Agent接入。
可使用"curl -kv"命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式选择"增强型探针"的连通性为例，请登录应用所部署的机器，并输入命令curl -kv 100.125.12.108:41333，其他区域地址请参考[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。
APM支持云下业务接入云上APM，详细操作参见[云下业务接入云上APM](https://support.huaweicloud.com/usermanual-apm2/apm_08_0004.html)。
#### 前提条件
- Agent 2.4.1之后版本支持采用代理接入。
- Java语言支持增强型探针。
- 已在ECS安装UniAgent，且ECS服务器已绑定EIP。具体操作请参考[安装UniAgent（新版）](https://support.huaweicloud.com/usermanual-aom2/agent_02_0005.html)。
- 修改apm.config配置文件。将apm.proxy写入配置文件中，如下图所示。格式：apm.proxy=ip:port。
- ![](https://support.huaweicloud.com/usermanual-apm2/zh-cn_image_0000002698413489.png "点击放大")
- 获取接入javaagent所需的AK/SK，具体操作请参见[管理APM访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。
 
#### 使用代理接入APM
1. 配置代理机。其中，配置代理区域的网络类型为"内网"，具体操作请参见[配置代理区域和代理机](https://support.huaweicloud.com/usermanual-aom2/agent_01_0010.html)。
2. 在ECS界面配置代理机安全组，在入方向规则添加代理端口，并放通客户端网段。 
   ![](https://support.huaweicloud.com/usermanual-apm2/zh-cn_image_0000002525369814.png "点击放大")
   
   
   
3. 下载并配置JavaAgent。 
   1. 下载JavaAgent，参考[探针下载地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1007.html)下载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配置文件。master.address配置请参见[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)，将[管理APM访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)中获取的AK/SK写入配置文件access.key/secret.key中，并添加apm.proxy=ip:port（此处为aom界面的代理ip:端口），如下图所示。
      ![](https://support.huaweicloud.com/usermanual-apm2/zh-cn_image_0000002556689663.png "点击放大")
      
   
   
   
   
4. 重启应用。 
   在启动服务的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界面手动创建，其余层级可以根据参数自动生成。