手动接入Agent

前提条件

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

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

接入Agent

1. 登录AOM 2.0控制台。
2. 在左侧导航栏中选择“接入中心”。
3. 在右侧“应用层”面板单击“Node.js”卡片。
4. 在“基础信息”下选择“区域”和“应用”。
   如果现有的应用无法满足需要，可以单击“创建应用”添加，详细参数说明请参见表1。

   图1 基础信息
   

   表1 创建应用参数说明

   参数名称	说明
   应用名称	应用显示的名称，不能为空。 支持输入1~128个字符，只能包含数字、字母、下划线、中划线、并且以英文字母开头。
   应用别名	应用的别名。设置应用别名后应用名称优先展示应用别名。 支持输入1~128个字符，只能包含数字、字母、中文、下划线、中划线、括号以及小数点。
   企业项目	在下拉菜单中选择企业项目，仅开通企业版才会显示。
   描述	应用的描述信息，最多可输入1000个字符。

5. 接入方式默认选择“增强型探针”。
6. 数据接入方式选择“自定义接入”，按照步骤接入。
   图2 数据接入
   

   表2 参数列表

   环境变量	入参	描述	选项
   APM_APP_NAME	appName	组件名称，代表一个组件。同一个应用下，组件名称不能重复。一个组件可以包含多个环境，不能重复，如果要重复，使用APM_INSTANCE_NAME区分。	必填
   APM_AK	AK	APM访问密钥ID（AK）。	必填
   APM_SK	SK	APM秘密访问密钥（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+实例名称组成。	选填