# 应用层接入AOM AOM作为华为云服务可观测性分析统一入口，提供接入中心，支持将应用层组件的调用链接入APM，来监控应用相关的性能图表或接口性能指标等。例如：请求平均时延、错误调用次数、请求吞吐量等。 #### 配置应用层接入AOM 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 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应用](https://support.huaweicloud.com/usermanual-apm2/apm_08_0024.html)。 | | Go | 在"接入应用"页面接入Go应用相关调用链指标，具体操作请参见[监控GO应用](https://support.huaweicloud.com/usermanual-apm2/apm_08_0025.html)。 | | Php | 在"接入应用"页面接入Php应用相关调用链指标，具体操作请参见[监控Php应用](https://support.huaweicloud.com/usermanual-apm2/apm_08_0026.html)。 | | .NET | 在"接入应用"页面接入.NET应用相关调用链指标，具体操作请参见[监控.Net应用](https://support.huaweicloud.com/usermanual-apm2/apm_08_0029.html)。 | | C++ | 在"接入应用"页面接入C++应用相关调用链指标，具体操作请参见[监控C++应用](https://support.huaweicloud.com/usermanual-apm2/apm_08_0028.html)。 | - [监控JAVA应用（快速接入Agent）] AOM提供应用接入功能，通过快速接入Agent来监控JAVA应用。Java语言支持增强型探针、OpenTelemetry和Skywalking。 - **前提条件：** 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用"curl -kv"命令测试目标机器与APM服务器网络是否**连通。** 例如，以检查华北-北京四区域，且接入方式选择"增强型探针"的连通性为例，请登录应用所部署的机器，并输入命令curl -kv 100.125.12.108:41333，其他区域地址请参考[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。 - **操作步骤：** 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在左侧导航栏中选择"接入中心 \> 接入中心"。 3. 单击"应用层"类型中的"Java"卡片。（新版接入中心，单击"组件层"类型中的"JAVA组件"卡片。） 4. 在"基础信息"下选择"区域"和"应用"。 如果现有的应用无法满足需要，可以单击"创建应用"添加应用，详细参数说明请参见[表2]。 图1基础信息 ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002492500362.png "点击放大") 表2创建应用参数说明 | 参数名称 | 说明 | |:---|:---| | 应用名称 | 应用显示的名称，不能为空。 支持输入1\~128个字符，只能包含数字、字母、下划线、中划线、并且以英文字母开头。 | | 应用别名 | 应用的别名。设置应用别名后应用名称优先展示应用别名。 支持输入1\~128个字符，只能包含数字、字母、中文、下划线、中划线、括号以及小数点。 | | 企业项目 | 在下拉菜单中选择企业项目，仅开通企业版才会显示。 | | 描述 | 应用的描述信息，最多可输入1000个字符。 | 5. 接入方式默认选择"增强型探针"。 6. 数据接入方式选择"虚机接入"，按照界面提示步骤接入。 图2虚机接入 ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002492340658.png "点击放大") 1. 使用PuTTY等远程登录工具，登录待安装Agent的Linux操作系统主机，并以root权限执行复制的命令来下载并安装JavaAgent。 ``` curl -k https://apm2-javaagent-***/apm_agent_install2.sh -o apm_agent_install.sh && bash apm_agent_install.sh -ak * -sk * -masteraddress https://**** -obsaddress https://apm2-javaagent-***.com -version latest; history -cw; history -r ``` - APM_AK/APM_SK：安装JavaAgent的AK和SK。获取AK和SK方法参见[访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。直接复制安装JavaAgent的命令，请注意填写"APM_AK"和"APM_SK"时，需删除"{}"。 - master.address：APM探针接入地址，请参见[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。 - 支持通过配置环境变量的方式动态配置安装JavaAgent命令中的AK/SK，以及master.address：给环境变量APM_MASTER_ADDRESS、APM_ACCESS_KEY（apm-ak）以及APM_SECRET_KEY（apm-sk）赋值。 2. 安装JavaAgent完毕后，在应用服务器的启动脚本中添加JVM参数，然后重新启动您的应用。 表3JVM参数说明 | 参数 | 说明 | 是否必填 | |:---|:---|:---| | 探针安装路径 | Agent探针安装的路径。 | 必填 | | 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才能正常工作。 可使用"curl -kv"命令测试目标机器与APM服务器网络是否**连通。** 例如，以检查华北-北京四区域，且接入方式选择"增强型探针"的连通性为例，请登录应用所部署的机器，并输入命令curl -kv 100.125.12.108:41333，其他区域地址请参考[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。 - 访问[地区和终端节点](https://developer.huaweicloud.com/endpoint?AOM)，获取所在region的endpoint。 - 在[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)左侧导航栏选择"APM配置 \> 访问密钥"，进入访问密钥页面，查看获取接入javaagent所需的AK/SK。 - **使用说明：** CCE工作负载创建时和创建后，均可以对JAVA类工作负载监控进行性能管理配置。目前只支持为部署在CCE容器中的JAVA应用安装Agent，详细操作请参考[设置性能管理配置](https://support.huaweicloud.com/usermanual-cce/cce_10_0055.html)。CCE容器安装Agent建议使用自有探针。 相关参数说明参见[表4]。 表4APM性能管理配置参数列表 | 参数名称 | 参数说明 | |:---|:---| | 安装探针 | 选择安装探针。目前支持"不启动"、"APM 2.0探针"。 | | 探针版本 | 选择探针的版本。探针版本的类型建议与工作负载所在node节点的CPU架构对应版本一致。 | | 探针升级策略 | 探针升级的方式、策略。默认为"重启自动升级"。 - 重启自动升级：每次都尝试重新下载镜像。 - 重启手动升级：如果本地有该镜像，则使用本地镜像，本地不存在时下载镜像。 | | APM环境 | 输入APM环境名称，该参数为选填。 | | APM应用 | 选择一个已有的APM应用。 | | 子应用 | 输入APM子应用，该参数为选填。 | | 接入密钥 | 将会自动获取APM服务的密钥信息，详情参见[前提条件]。 | - [监控Node.js应用（快速接入Agent）] AOM提供应用接入功能，通过快速接入Agent来监控Node.js应用。 - **前提条件：** 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用"curl -kv"命令测试目标机器与APM服务器网络是否**连通。** 例如，以检查华北-北京四区域，且接入方式选择"增强型探针"的连通性为例，请登录应用所部署的机器，并输入命令curl -kv 100.125.12.108:41333，其他区域地址请参考[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。 - **操作步骤：** 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在左侧导航栏中选择"接入中心 \> 接入中心"。 3. 单击"应用层"类型中的"Node.js"卡片。（新版接入中心，单击"组件层"类型中的"Node.js组件"卡片。） 4. 在"基础信息"下选择"区域"和"应用"。 如果现有的应用无法满足需要，可以单击"创建应用"添加应用，详细参数说明请参见[表5]。 图3基础信息 ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002492500362.png "点击放大") 表5创建应用参数说明 | 参数名称 | 说明 | |:---|:---| | 应用名称 | 应用显示的名称，不能为空。 支持输入1\~128个字符，只能包含数字、字母、下划线、中划线、并且以英文字母开头。 | | 应用别名 | 应用的别名。设置应用别名后应用名称优先展示应用别名。 支持输入1\~128个字符，只能包含数字、字母、中文、下划线、中划线、括号以及小数点。 | | 企业项目 | 在下拉菜单中选择企业项目，仅开通企业版才会显示。 | | 描述 | 应用的描述信息，最多可输入1000个字符。 | 5. 接入方式默认选择"增强型探针"。 6. 数据接入方式选择"无侵入接入"，通过接入命令接入。 图4数据接入 ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002532876825.png "点击放大") 表6环境参数说明 | 环境变量 | 入参 | 描述 | 选项 | |:---|:---|:---|:---| | APM_APP_NAME | appName | 组件名称，代表一个组件。同一个应用下，组件名称不能重复。一个组件可以包含多个环境，不能重复，如果要重复，使用APM_INSTANCE_NAME区分。 | 必填 | | APM_AK | AK | APM访问密钥ID（AK）。获取AK方法参见[访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。 | 必填 | | APM_SK | SK | APM秘密访问密钥（SK）。获取SK方法参见[访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。 | 必填 | | APM_MASTER_ADDRESS | masterAddress | APM探针的接入地址。请参见[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。 | 必填 | | 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才能正常工作。 可使用"curl -kv"命令测试目标机器与APM服务器网络是否**连通。** 例如，以检查华北-北京四区域，且接入方式选择"增强型探针"的连通性为例，请登录应用所部署的机器，并输入命令curl -kv 100.125.12.108:41333，其他区域地址请参考[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。 - **操作步骤：** 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在左侧导航栏中选择"接入中心 \> 接入中心"，单击页面右上角"返回旧版"。 3. 单击"应用层"类型中的"Node.js"卡片。（新版接入中心，单击"组件层"类型中的"Node.js组件"卡片。） 4. 在"基础信息"下选择"区域"和"应用"。 如果现有的应用无法满足需要，可以单击"创建应用"添加应用，详细参数说明请参见[表7]。 图5基础信息 ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002492500362.png "点击放大") 表7创建应用参数说明 | 参数名称 | 说明 | |:---|:---| | 应用名称 | 应用显示的名称，不能为空。 支持输入1\~128个字符，只能包含数字、字母、下划线、中划线、并且以英文字母开头。 | | 应用别名 | 应用的别名。设置应用别名后应用名称优先展示应用别名。 支持输入1\~128个字符，只能包含数字、字母、中文、下划线、中划线、括号以及小数点。 | | 企业项目 | 在下拉菜单中选择企业项目，仅开通企业版才会显示。 | | 描述 | 应用的描述信息，最多可输入1000个字符。 | 5. 接入方式默认选择"增强型探针"。 6. 数据接入方式选择"自定义接入"，按照步骤接入。 图6数据接入 ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002112586214.png "点击放大") 表8环境参数说明 | 环境变量 | 入参 | 描述 | 选项 | |:---|:---|:---|:---| | APM_APP_NAME | appName | 组件名称，代表一个组件。同一个应用下，组件名称不能重复。一个组件可以包含多个环境，不能重复，如果要重复，使用APM_INSTANCE_NAME区分。 | 必填 | | APM_AK | AK | APM访问密钥ID（AK）。获取AK方法参见[访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。 | 必填 | | APM_SK | SK | APM秘密访问密钥（SK）。获取SK方法参见[访问密钥](https://support.huaweicloud.com/usermanual-apm2/apm_07_0034.html)。 | 必填 | | APM_MASTER_ADDRESS | masterAddress | APM探针的接入地址。请参见[探针接入地址](https://support.huaweicloud.com/usermanual-apm2/apm_07_1008.html)。 | 必填 | | APM_BUSINESS | business | 应用名称，代表一个逻辑单元，是一个全局概念，各个region都可以看到相同的应用信息，比如一个租户下面比较独立的功能模块可以定义为一个应用。如果填写，则必须提前创建该应用。如果为空，则代表默认应用。 | 选填 | | APM_SUB_BUSINESS | subBusiness | 子应用名称。在一个应用下面可以创建多个子应用，主要起文件夹和管理的功能，子应用为全局概念，当前最多支持三层子应用，子应用格式为：sub1/sub2/sub3 | 选填 | | APM_ENV | env | 环境名称。一个组件由于部署不同的配置参数，会形成的多个环境。 | 选填 | | APM_ENV_TAG | envTag | 环境标签，是在环境上的一个属性，多个环境可能具有相同的标签，可以通过标签对环境进行过滤。 | 选填 | | APM_INSTANCE_NAME | instanceName | 实例是环境下的一个进程，名称由主机名+ip+实例名称组成。 | 选填 |