应用层接入AOM

配置应用层接入AOM

1. 登录AOM 2.0控制台。
2. 在左侧导航栏中选择“接入 > 接入中心”，进入接入中心页面。（如果您进入的是新版接入中心，需单击页面右上角“返回旧版”，进入旧版接入中心。）当前仅华南-广州区域的菜单路径为“接入中心 > 接入中心”。
3. 在右侧“应用层”类型中单击需要接入的卡片，参考下表执行相关接入操作。

   表1 应用层接入AOM

   卡片	相关操作
   Java	在“接入应用”页面接入Java应用相关调用链指标。AOM支持通过快速接入Agent来监控JAVA应用，以及为部署在CCE容器中的JAVA应用安装Agent来监控JAVA应用，具体操作请参见监控JAVA应用（快速接入Agent）和监控JAVA应用（为部署在CCE容器中的JAVA应用安装Agent）。
   Node.js	在“接入应用”页面接入Node.js应用相关调用链指标。AOM支持通过快速接入Agent或手动接入Agent来监控Node.js应用，具体操作请参见监控Node.js应用（快速接入Agent）和监控Node.js应用（手动接入Agent）。
   Python	在“接入应用”页面接入Python应用相关调用链指标，具体操作请参见监控Python应用。
   Go	在“接入应用”页面接入Go应用相关调用链指标，具体操作请参见监控GO应用。
   Php	在“接入应用”页面接入Php应用相关相关调用链指标，具体操作请参见监控Php应用。
   .NET	在“接入应用”页面接入.NET应用相关调用链指标，具体操作请参见监控.Net应用。
   C++	在“接入应用”页面接入C++应用相关调用链指标，具体操作请参见监控C++应用。

监控JAVA应用（快速接入Agent）

AOM提供应用接入功能，通过快速接入Agent来监控JAVA应用。Java语言支持增强型探针、OpenTelemetry和Skywalking。

• 前提条件：

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

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

• 操作步骤：
  1. 登录AOM 2.0控制台。
  2. 在左侧导航栏中选择“接入 > 接入中心”。当前仅华南-广州区域的菜单路径为“接入中心 > 接入中心”。
  3. 单击“应用层”类型中的“Java”卡片。（新版接入中心，单击“组件层”类型中的“JAVA组件”卡片。）
  4. 在“基础信息”下选择“区域”和“应用”。
     如果现有的应用无法满足需要，可以单击“创建应用”添加应用，详细参数说明请参见表2。

     图1 基础信息
     

     表2 创建应用参数说明

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

  5. 接入方式默认选择“增强型探针”。
  6. 数据接入方式选择“虚机接入”，按照界面提示步骤接入。
     图2 虚机接入
     
     1. 使用PuTTY等远程登录工具，登录待安装Agent的Linux操作系统主机，并以root权限执行复制的命令来下载并安装JavaAgent。

        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_AK/APM_SK：安装JavaAgent的AK和SK。获取AK和SK方法参见访问密钥。直接复制安装JavaAgent的命令，请注意填写“APM_AK”和“APM_SK”时，需删除“{}”。
        • master.address：APM探针接入地址，请参见探针接入地址。
        • 支持通过配置环境变量的方式动态配置安装JavaAgent命令中的AK/SK，以及master.address：给环境变量APM_MASTER_ADDRESS、APM_ACCESS_KEY（apm-ak）以及APM_SECRET_KEY（apm-sk）赋值。
     2. 安装JavaAgent完毕后，在应用服务器的启动脚本中添加JVM参数，然后重新启动您的应用。

        表3 JVM参数说明

        参数	说明	是否必填
        探针安装路径	Agen探针安装的路径。	必填
        appName	组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。	必填
        env	环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。	选填
        envTag	环境标签，主要用于环境过滤，多个环境打上相同的环境标签，在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。	选填
        business	应用英文名称，为全局概念。如果填写，则必须提前创建该应用。如果为空，则代表默认应用（开通APM时系统会自动创建一个默认应用）。	选填
        subBusiness	子应用名称，为全局概念，在应用下面子文件夹。该参数可以为空，为空代表资源挂载在根应用下面，子应用最多支持三层。比如 a/b/c，a、b、c各代表一层。	选填
        用户应用	用户所属的应用名称。	必填

监控JAVA应用（为部署在CCE容器中的JAVA应用安装Agent）

AOM提供应用接入功能，可以为部署在CCE容器中的JAVA应用安装APM探针Agent，来监控JAVA应用，以提供更精准的问题分析与定位，协助您高效解决应用难题。

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

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

  • 访问地区和终端节点，获取所在region的endpoint。
  • 在AOM 2.0控制台左侧导航栏选择“APM配置 > 访问密钥”，进入访问密钥页面，查看获取接入javaagent所需的AK/SK。
• 使用说明：

  CCE工作负载创建时和创建后，均可以对JAVA类工作负载监控进行性能管理配置。目前只支持为部署在CCE容器中的JAVA应用安装Agent，详细操作请参考设置性能管理配置。CCE容器安装Agent建议使用自有探针。

  相关参数说明参见表4。

  表4 APM性能管理配置参数列表

  参数名称	参数说明
  安装探针	选择安装探针。目前支持“不启动”、“APM 2.0探针”。
  探针版本	选择探针的版本。探针版本的类型建议与工作负载所在node节点的CPU架构对应版本一致。
  探针升级策略	探针升级的方式、策略。默认为“重启自动升级”。 重启自动升级：每次都尝试重新下载镜像。 重启手动升级：如果本地有该镜像，则使用本地镜像，本地不存在时下载镜像。
  APM环境	输入APM环境名称，该参数为选填。
  APM应用	选择一个已有的APM应用。
  子应用	输入APM子应用，该参数为选填。
  接入密钥	将会自动获取APM服务的密钥信息，详情参见前提条件。

监控Node.js应用（快速接入Agent）

AOM提供应用接入功能，通过快速接入Agent来监控Node.js应用。

• 前提条件：

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

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

• 操作步骤：
  1. 登录AOM 2.0控制台。
  2. 在左侧导航栏中选择“接入 > 接入中心”。当前仅华南-广州区域的菜单路径为“接入中心 > 接入中心”。
  3. 单击“应用层”类型中的“Node.js”卡片。（新版接入中心，单击“组件层”类型中的“Node.js组件”卡片。）
  4. 在“基础信息”下选择“区域”和“应用”。
     如果现有的应用无法满足需要，可以单击“创建应用”添加应用，详细参数说明请参见表5。

     图3 基础信息
     

     表5 创建应用参数说明

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

  5. 接入方式默认选择“增强型探针”。
  6. 数据接入方式选择“无侵入接入”，通过接入命令接入。
     图4 数据接入
     

     表6 环境参数说明

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

监控Node.js应用（手动接入Agent）

AOM提供应用接入功能，通过手动接入Agent来监控Node.js应用。

• 前提条件：

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

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

• 操作步骤：
  1. 登录AOM 2.0控制台。
  2. 在左侧导航栏中选择“接入 > 接入中心”，单击页面右上角“返回旧版”。当前仅华南-广州区域的菜单路径为“接入中心 > 接入中心”。
  3. 单击“应用层”类型中的“Node.js”卡片。（新版接入中心，单击“组件层”类型中的“Node.js组件”卡片。）
  4. 在“基础信息”下选择“区域”和“应用”。
     如果现有的应用无法满足需要，可以单击“创建应用”添加应用，详细参数说明请参见表7。

     图5 基础信息
     

     表7 创建应用参数说明

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

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

     表8 环境参数说明

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