更新时间:2024-11-14 GMT+08:00

快速接入Agent

前提条件

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

可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如,以检查中国-香港区域,且代码源选择“增强型探针”的连通性为例,请登录应用所部署的机器,并输入命令telnet 100.125.6.106:41333,其他区域地址请参考接入地址

Java语言支持增强型探针。

操作步骤

  1. 登录管理控制台。
  2. 单击左侧,选择“应用服务 > 应用性能管理 APM”,进入APM服务页面。
  3. 在左侧导航栏中选择“应用监控 > 应用列表”。
  4. 单击“接入应用”,进入接入应用页面。

    图1 接入应用

  5. 选择“区域”和“应用”。

    图2 基础信息

  6. “接入方式”选择增强型探针。
  7. “服务端语言”选择Java。

    图3 接入方式

  8. 根据应用类型选择接入对应的接入方式,按照步骤接入。

    图4 数据接入
    表1 参数说明

    参数

    说明

    是否必填

    APM_AK

    APM_SK

    安装JavaAgent的AK和SK。获取APM_AK和APM_SK方法参见访问密钥

    注意:

    如果直接复制命安装JavaAgent的命令,请注意填写“APM_AK”和“APM_SK”时,删除“{}”。

    例如:

    curl -k https://javaagent.***/apm_agent_install2.sh -o apm_agent_install.sh && bash apm_agent_install.sh -ak * -sk * -masteraddress https://**** -obsaddress https://javaagent.***.com -version latest; history -cw; history -r 

    必填

    探针安装路径

    Agen探针安装的路径。

    必填

    appName

    组件名称,代表一个组件,需要使用英文字符开头。同一个应用下,组件名称不能重复。一个组件可以包含多个环境。不能重复,如果要重复,使用instanceName区分。

    必填

    env

    环境名称,代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境,比如测试环境,现网环境。每个环境都在一个region部署,具有唯一的region属性。该参数可以为空,代表默认环境。

    选填

    envTag

    环境标签,主要用于环境过滤,多个环境打上相同的环境标签,在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。

    选填

    business

    应用英文名称,为全局概念。如果填写,则必须提前创建该应用。如果为空,则代表默认应用(开通APM时系统会自动创建一个默认应用)。

    选填

    subBusiness

    子应用,为全局概念,在应用下面子文件夹。该参数可以为空,为空代表资源挂载在根应用下面,子应用最多支持三层。比如 a/b/c,a、b、c各代表一层。

    选填

    用户应用

    用户所属的应用名称。

    必填

动态配置master.address以及AK/SK

APM支持动态配置master.address以及AK/SK。

用户可以通过配置环境变量的方式,给APM_MASTER_ADDRESS、APM_ACCESS_KEY(apm-ak)以及APM_SECRET_KEY(apm-sk)赋值。获取AK/SK的具体操作,请参见为JAVA应用手工安装Agent,获取master.address,请参见接入地址

  • 如果javaagent配置文件和环境变量同时配置了AK、SK、master.address,那么环境变量配置的值优先生效。
  • Agent 2.3.19之后版本支持动态配置master.address以及AK/SK。