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

Windows IIS如何安装JavaAgent

前提条件

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

    可使用“curl -kv”命令测试目标机器与APM服务器网络是否连通。

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

Windows IIS中安装JavaAgent

  1. 登录APM控制台。
  2. 在左侧导航栏中选择“应用监控 > 应用列表”。
  3. 进入“接入应用”页面。

    • 首次接入应用时，单击“点击接入应用”，进入“接入应用”页面。
    • 已有探针接入时，在页面右上角，单击“接入应用”，进入“接入应用”页面。

  4. 选择“区域”和“应用”。若未有应用，可单击“创建应用”，弹出“创建应用”弹窗，具体操作请参见创建应用。
  5. “接入方式”选择“增强型探针”。
  6. “服务端语言”选择Java。
  7. 选择“数据接入 > 虚机接入”，复制JavaAgent OBS下载地址。

    图1 数据接入

  8. 下载JavaAgent到需要接入APM机器的任意目录。下载方法如下：

    • 下载apm-javaagent，下载地址可参考探针下载地址。
    • 在浏览器中输入{obsaddress}/apm2_javaagent/apm-javaagent-x.x.x.tar
    • 在命令行窗口中执行如下命令。 
      curl -kv {obsaddress}/apm2_javaagent/apm-javaagent-x.x.x.tar -output apm-javaagent.tar

  9. 解压apm-javaagent.tar。
  1. 修改JavaAgent中的apm.config配置文件。master.address配置请参见探针接入地址，将AK/SK写入配置文件中。

    图2 写入AK/SK

  1. 添加启动命令并重启应用。 

    java -javaagent:<探针安装路径>/apm-javaagent/apm-javaagent.jar=appName=<组件名称>,env=<环境名称>,envTag=<环境标签>,business=<应用名称>,subBusiness=<子应用名称> -jar <用户应用>.jar

相关文档