更新时间:2024-07-04 GMT+08:00

为JAVA应用手工安装Agent

前提条件

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

    可使用Telnet命令测试目标机器与APM服务器网络是否连通。

    如果接入APM的机器与APM服务网络无法连通,可以接入代理。

  • 选择“系统管理 > 访问密钥”进入访问密钥页面,查看获取接入javaagent所需的AK/SK。

操作步骤

  1. 下载JavaAgent,参考JavaAgent下载地址下载apm-javaagent,并将javaagent下载到需要接入APM机器的任意目录。

    示例命令:

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

  1. 执行tar命令解压javaagent。

    示例命令:

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

  1. 修改javaagent中的apm.config配置文件。master.address配置请参见接入地址master.address配置,将AK/SK写入配置文件中,如下图所示。

    图1 写入AK/SK

  1. 修改java进程启动脚本。

    在服务启动脚本的java命令之后,配置apm-javaagent.jar包所在路径,并指定java进程的组件名。

    添加-javaagent参数示例:

    java -javaagent:/xxx/apm-javaagent/apm-javaagent.jar=appName={appName}

    当企业业务很多的情况下,也支持更为复杂一些的配置,添加-javaagent参数的复杂模式如:

    java -javaagent:/xxx/apm-javaagent/apm-javaagent.jar=appName=myApp,env=myEnv,envTag=myTag,business=myBusiness,subBusiness=mySub
    • 上述参数属于APM内置的CMDB信息,具体详情见CMDB管理章节。
    • 由于历史原因,APM启动参数设置的元数据,跟CMDB概念有一些冲突,这里进行说明。

      启动参数一般会设置 -javaagent:D:\javaagent-package\apm-javaagent\apm-javaagent.jar=appName=xxx,env=yyy,business=zzz,subBusiness=sss,envTag=xxx,在这里appName代表组件,business代表应用,subBusiness代表子应用,envTag代表环境标签。

      如果没有在web界面对business参数进行设置,启动javaagent时系统就会报错;其他参数如果没有设置,在启动javaagent时会自动创建出来,包括子应用、组件、环境及环境标签等。

      同一个应用下,组件名称不能重复。

  2. 重新部署应用。