文档首页/ 应用性能管理 APM/ 用户指南（2.0）/ 接入APM/ 增强型、OpenTelemetry以及SkyWalking方式接入APM实现性能指标监控/ 增强型方式接入APM实现指标监控/ 使用代理接入APM
更新时间：2026-08-13 GMT+08:00
查看PDF
分享

使用代理接入APM

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

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

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

前提条件

  • Agent 2.4.1之后版本支持采用代理接入。
  • Java语言支持增强型探针。
  • 已在ECS安装UniAgent，且ECS服务器已绑定EIP。具体操作请参考安装UniAgent（新版）。
  • 修改apm.config配置文件。将apm.proxy写入配置文件中，如下图所示。格式：apm.proxy=ip:port。
  • 获取接入javaagent所需的AK/SK，具体操作请参见管理APM访问密钥。

使用代理接入APM

  1. 配置代理机。其中，配置代理区域的网络类型为“内网”，具体操作请参见配置代理区域和代理机。
  2. 在ECS界面配置代理机安全组，在入方向规则添加代理端口，并放通客户端网段。

  3. 下载并配置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配置文件。master.address配置请参见探针接入地址，将管理APM访问密钥中获取的AK/SK写入配置文件access.key/secret.key中，并添加apm.proxy=ip:port（此处为aom界面的代理ip:端口），如下图所示。

  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界面手动创建，其余层级可以根据参数自动生成。

相关文档