
# API开源协议及其他组件接入AOM
AOM作为华为云服务可观测性分析统一入口，提供接入中心功能，支持将API开源协议及其他类型组件相关指标接入AOM，将调用链接入APM，并支持查看日志接入LTS相关操作文档。
#### 配置API开源协议及其他组件接入AOM
1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。
2. 在左侧导航栏中选择"接入中心 \> 接入中心"，进入新版接入中心页面。 
   如果您进入的是旧版接入中心，需要单击"接入中心"页面右上角"体验新版"进入新版接入中心页面。
   
   
3. 勾选"类型"下的"API开源协议及其他"前的复选框，筛选出API开源协议及其他类型卡片。
4. 单击卡片上的"接入指标（AOM）"、接入调用链（APM）或"接入日志（LTS）简介"链接，可快速接入指标、调用链、日志或查看接入LTS相关的操作文档。 
   - 接入指标（AOM）：AOM提供API开源协议及其他组件指标接入AOM的能力。通过卡片的"接入指标（AOM）"链接，可快速接入API开源协议及其他组件相关指标。
   
   - 接入调用链（APM）：AOM提供API开源协议及其他组件调用链接入APM的入口。通过卡片的"接入调用链（APM）"链接，可快速接入API开源协议及其他组件相关调用链。
   
   - 接入日志（LTS）简介：AOM提供API开源协议及其他组件日志接入LTS的入口。
     - 通过卡片上"接入日志（LTS）简介"中的"简介"链接，查看API开源协议及其他组件日志接入LTS的相关操作文档。您可以根据文档完成日志接入LTS相关操作。
     
     - 部分组件可通过卡片上"接入日志（LTS）简介"中的"接入日志（LTS）"链接入口，快速接入相关日志。例如"跨账号接入 - 日志流映射"卡片。
      
   
   
   表1API开源协议及其他组件接入AOM 
   | 卡片                  | 相关操作                                                                                                                                                                                                              |
   |:---|:---|
   | 应用运维管理AOM API       | 使用AOM的OPEN API上报指标数据。具体操作请参见：[使用API将指标接入（AOM）](https://support.huaweicloud.com/api-aom/aom_04_0013.html)。                                                                                                         |
   | 云日志LTS API          | 使用LTS的OPEN API上报日志数据。具体操作请参见：[使用API将日志接入（LTS）](https://support.huaweicloud.com/usermanual-lts/lts_04_0215.html)。                                                                                                  |
   | 应用性能监控APM API       | 使用APM的OPEN API上报应用性能监控数据。具体操作请参见：[使用API将调用链接入（APM）](https://support.huaweicloud.com/api-apm/apm_04_0006.html)。                                                                                                    |
   | Prometheus 通用实例     | 适合已自建了Prometheus Server，但需要通过远端存储（Remote Write）方式来解决Prometheus存储的可用性和可扩展性场景。具体操作请参见：[配置Prometheus 通用实例接入（AOM）](https://support.huaweicloud.com/usermanual-aom2/mon_01_0070.html#mon_01_0070__section35206695715)。 |
   | KAFKA协议             | 高吞吐、分布式、基于TCP的二进制消息系统协议。具体操作请参见：[使用KAFKA协议上报日志 （LTS）](https://support.huaweicloud.com/usermanual-lts/lts_04_1130.html)。                                                                                           |
   | Open Telemetry      | 使用开源OpenTelemetry协议上报应用性能监控数据。具体操作请参见：[通过OpenTelemetry将调用链接入（APM）](https://support.huaweicloud.com/usermanual-apm2/apm_08_0021.html)。                                                                             |
   | SKYwalking          | 使用开源Skywalking协议上报应用性能监控数据。具体操作请参见：[APM通过Skywalking将调用链接入（APM）](https://support.huaweicloud.com/qs-apm2/apm_02_0003.html)。                                                                                        |
   | Syslog协议            | 系统日志标准，基于UDP/TCP，用于设备间日志交换。具体操作请参见：[使用Flume采集器上报日志（LTS）](https://support.huaweicloud.com/usermanual-lts/lts_04_1131.html)。                                                                                        |
   | Flume               | 使用开源工具Flume采集日志并上传到LTS。具体操作请参见：[使用Flume采集器上报日志（LTS）](https://support.huaweicloud.com/usermanual-lts/lts_04_1131.html)。                                                                                            |
   | Beats               | 使用开源工具Beats采集日志并上传到LTS。具体操作请参见：[使用KAFKA协议上报日志（LTS）](https://support.huaweicloud.com/usermanual-lts/lts_04_1130.html)。                                                                                             |
   | Logstash            | 使用开源工具Logstash采集日志并上传到LTS。具体操作请参见：[使用KAFKA协议上报日志（LTS）](https://support.huaweicloud.com/usermanual-lts/lts_04_1130.html)。                                                                                          |
   | SNMP协议              | 简单网络管理协议，用于远程监控网络设备，有v1、v2、v3三个版本。具体操作请参见：[使用Flume采集器上报日志（LTS）](https://support.huaweicloud.com/usermanual-lts/lts_04_1131.html)。                                                                                 |
   | Java SDK (log4j2)   | 可以直接在log4j2中配置华为云appender，将通过log4j2产生的日志直接上报至云日志服务。具体操作请参见：[通过Java SDK（log4j2插件）上报日志（LTS）](https://support.huaweicloud.com/usermanual-lts/lts_03_0003.html)。                                                      |
   | LOGBack SDK         | 可以直接在logback中配置华为云appender，将通过logback产生的日志直接上报至云日志服务。具体操作请参见：[通过LogBack SDK上报日志 （LTS）](https://support.huaweicloud.com/usermanual-lts/lts_0905.html)。                                                             |
   | 跨账号接入 - 日志流映射       | 通过创建委托，您可以将委托方账号的日志流映射到被委托方账号的日志流。具体操作请参见：[跨IAM账号日志接入（LTS）](https://support.huaweicloud.com/usermanual-lts/lts_04_1112.html)。                                                                                     |
   | 自定义 Prometheus 格式指标 | 接入自定义Prometheus格式指标。具体操作请参见：[自定义Prometheus格式指标接入（AOM）]。                                                                                                                      |
      
   
   
   
 
 #### 配置自定义Prometheus格式指标接入AOM
您可以接入自定义Prometheus格式的指标，并支持自动上报到AOM。
- **约束与限制：**
  - 单次上报指标数据量限制：当前单次上报的指标数据量默认上限为5MB。若单次上报数据量超过5MB，将无法上报成功。如需提升上报限额，请[提交工单](https://support.huaweicloud.com/usermanual-ticket/zh-cn_topic_0127038618.html)申请调整采集限制。
  
  - 采集资源规格调整说明：随着上报指标数据量的增加，采集器所需的资源（CPU）也需要相应调整。具体规格要求如下：
    - 单次上报指标数据量在20MB以内时，无需调整采集器资源配置，默认规格即可满足需求。
    
    - 单次上报指标数据量在20MB至50MB之间时，需[提交工单](https://support.huaweicloud.com/usermanual-ticket/zh-cn_topic_0127038618.html)申请将采集器的CPU限制调整至1核，以确保采集任务正常运行。
     
   
- **前提条件**
  - 已接入通用实例类型Prometheus监控，详情请参见[创建Prometheus 通用实例](https://support.huaweicloud.com/usermanual-aom2/mon_01_0070.html)。
  
  - 已创建主机组，详情请参见[管理主机组](https://support.huaweicloud.com/usermanual-aom2/agent_02_1033.html)。
   
- **操作步骤**
1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。
2. 在左侧导航栏选择"接入中心 \> 接入中心"，单击页面右上角"体验新版"，进入新版接入中心页面。
3. 筛选出"API开源协议及其他"类型下的"自定义 Prometheus 格式指标"卡片，并单击卡片上的"接入指标（AOM）"，进入配置页面。
4. 配置自定义Prometheus格式指标接入的相关参数。
   1. 选择Prometheus实例。
      1. Prometheus 实例类型：选择Prometheus实例类型，支持选择"Prometheus for ECS"和"通用实例"。
      
      2. 选择Prometheus实例：在下拉列表中选择Prometheus实例。 如果当前没有可选的Prometheus实例，可以单击"[新建 Prometheus 实例](https://support.huaweicloud.com/usermanual-aom2/mon_01_0072.html)"去创建一个Prometheus实例。（当前版本已不支持创建ECS类型Prometheus实例，仅支持选择以前创建过的ECS类型Prometheus实例。）
         
       
   
   2. 单击"下一步"，选择主机组。
      在主机组列表中选择待接入采集配置的主机组。
      - 如果当前没有可选的主机组，可以单击"[新建主机组](https://support.huaweicloud.com/usermanual-aom2/uiagent_02_1033.html)"去创建一个主机组。
      
      - 您还可以根据需要对主机组执行编辑、删除等相关操作，详情请参见[管理主机组](https://support.huaweicloud.com/usermanual-aom2/uiagent_02_1033.html)。
       
      配置接入规则时以主机组为单位下发采集配置，方便您对多台主机数据进行采集。当用户扩容主机时，只需在主机组中添加主机，该主机会自动继承主机组关联的接入规则，无需为每台主机重复配置。
      
   
   3. 采集配置。
      在"采集配置"中，参考下表配置相关参数信息。
      表2采集任务参数配置表 
      | 操作     | 参数          | 说明                                                                                                                                                                                                                                                                                                                                                      |
      |:---|:---|:---|
      | 基础配置   | 采集配置名称      | 自定义指标接入规则名称。长度范围为1到50个字符，支持大小写字母，数字，特殊字符(_-)，以字母开头。                                                                                                                                                                                                                                                                                                     |
      | 指标采集规则 | 采集目标        | 设置采集普罗指标的目标端IP地址和端口号，例如：10.0.0.1:3306。                                                                                                                                                                                                                                                                                                                  |
      | 指标采集规则 | 指标采集间隔(秒)   | 指标采集的周期，单位为秒（s），默认为60s，可选择10、30和60。                                                                                                                                                                                                                                                                                                                     |
      | 指标采集规则 | 指标采集超时时间(秒) | 执行指标采集任务的超时时间，单位为秒（s），默认为60s，可选择10、30和60。超时时间必须小于或等于采集周期。                                                                                                                                                                                                                                                                                               |
      | 指标采集规则 | 执行用户        | 执行指标接入规则的用户，即所选主机的用户，默认为root。                                                                                                                                                                                                                                                                                                                           |
      | 其他配置   | 自定义键值对维度    | 以键值对形式添加静态维度，用于标识指标的附加属性。单击"添加标签"可配置多个自定义键值对维度。 - labelKey为指标附加属性的key。长度范围1到64个字符，支持大小写字母、数字、下划线，且必须以字母或下划线开头。  - labelValue为指标附加属性的key对应的值。   最多可添加10个自定义键值对维度。例如：配置labelKey为app，配置labelValue为abc。 |
         
      参数配置完成后，可单击"YAML格式"，查看yaml格式化的配置数据。
      
    
5. 配置完成后，单击"下一步"，即可成功接入自定义Prometheus格式指标。
   成功接入自定义Prometheus格式指标后，您还可以执行以下操作：
   - 前往"指标浏览"页面可视化分析指标，详情请参见[指标浏览](https://support.huaweicloud.com/usermanual-aom2/mon_01_0026.html)。
   
   - 前往"接入管理"页面查看、编辑或删除配置的接入规则，详情请参见[接入管理](https://support.huaweicloud.com/usermanual-aom2/mon_01_0206.html)。
     
 
