快速接入Agent
前提条件
部署APM Agent时,必须确保接入APM的机器与APM服务网络连通,Agent才能正常工作。
可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如,以检查华北-北京四区域,且接入方式选择“增强型探针”的连通性为例,请登录应用所部署的机器,并输入命令telnet 100.125.12.108:41333,其他区域地址请参考探针接入地址。
Node.js语言,支持增强型探针、Skywalking和OpenTelemetry。
操作步骤
- 登录管理控制台。
- 单击左侧,选择“管理与监管 > 应用性能管理 APM”,进入APM服务页面。
- 在左侧导航栏中选择“应用监控 > 应用列表”。
- 单击“接入应用”,进入接入应用页面。
图1 接入应用
- 选择“区域”和“应用”。单击“创建应用”,弹出“创建应用”弹窗,可以具体操作参见创建应用。
图2 基础信息
- “接入方式”选择增强型探针、Skywalking或者OpenTelemetry。
- “服务端语言”选择Node.js。
图3 接入方式
- 使用PuTTY等远程登录工具,登录待安装Agent的Linux操作系统主机,并以root权限执行相关命令。
- 根据应用类型选择接入对应的接入方式,按照步骤接入。
如果接入方式选择“增强型探针”,则数据接入方式选择“无侵入接入”;
如果接入方式选择其他类型的探针,则数据接入方式选择“自定义接入”。
图4 无侵入接入
表1 参数列表 环境变量
入参
描述
选项
APM_APP_NAME
appName
组件名称,代表一个组件。同一个应用下,组件名称不能重复。一个组件可以包含多个环境,不能重复,如果要重复,使用APM_INSTANCE_NAME区分。
必填
APM_AK
AK
APM访问密钥ID(AK),获取AK方法参见访问密钥。
注意:如果直接复制命安装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 ”
必填
APM_SK
SK
APM秘密访问密钥(SK),获取SK方法参见访问密钥。
必填
APM_MASTER_ADDRESS
masterAddress
APM探针的接入地址。
必填
APM_BUSINESS
business
应用:代表一个逻辑单元,是一个全局概念,各个region都可以看到相同的应用信息,比如一个租户下面比较独立的功能模块可以定义为一个应用。如果填写,则必须提前创建该应用。如果为空,则代表默认应用。
选填
APM_SUB_BUSINESS
subBusiness
子应用:在一个应用下面可以创建多个子应用,主要起文件夹和管理的功能,子应用为全局概念,当前最多支持三层子应用,子应用格式为:sub1/sub2/sub3
选填
APM_ENV
env
环境:一个组件由于部署不同的配置参数,会形成的多个环境。
选填
APM_ENV_TAG
envTag
环境标签:是在环境上的一个属性,多个环境可能具有相同的标签,可以通过标签对环境进行过滤。
选填
APM_INSTANCE_NAME
instanceName
实例:是环境下的一个进程,名称由主机名+ip+实例名称组成。
选填