更新时间:2026-04-16 GMT+08:00
分享

Blackbox指标接入AOM

在运维监控场景中,为了确保服务的高可用性和快速故障定位,需要对主机上的各种服务端点进行有效的监控。然而,传统的监控方式往往难以覆盖所有类型的端点,特别是HTTP、HTTPS、DNS、TCP、ICMP和gRPC等多种协议的端点,这导致了监控盲区的存在。为了确保所有服务端点都能被有效监控,您可以在主机上安装AOM提供的Blackbox Exporter插件,然后通过配置指标接入规则来创建采集任务,就可以监控主机中的Blackbox相关指标,从而实现对目标系统的全面监控。

前提条件

配置Blackbox Exporter接入AOM

  1. 登录AOM 2.0控制台
  2. 在左侧导航栏选择“接入中心 > 接入中心”,选择“自建中间件”类型下的“Blackbox”卡片,并单击卡片上的“接入指标(AOM)”,进入配置页面。
  3. 在接入Blackbox指标配置页面中,配置相关参数信息。

    1. Prometheus实例配置。
      1. Prometheus 实例类型:选择Prometheus实例类型,支持选择“Prometheus for ECS”和“通用实例”。

        (当前版本已不支持创建ECS类型Prometheus实例,仅支持选择之前创建的ECS类型的Prometheus 实例。)

      2. 选择 Prometheus 实例:在下拉列表中选择Prometheus实例。

        单击“查看实例”可跳转至所选实例的详情页面。如果当前没有可选的Prometheus实例,可以单击“新建 Prometheus 实例”去创建“Prometheus 通用实例”类型Prometheus实例

    2. 单击“下一步”,安装插件并测试连通性。
      1. 参考参数配置表配置安装插件相关参数信息。
        表1 采集插件参数配置表

        操作

        参数

        说明

        基础配置

        接入规则名称

        自定义指标接入规则名称。长度范围为1到50个字符,支持大小写字母,数字,特殊字符(_-),以字母开头。

        配置指标采集插件

        操作系统

        主机的操作系统,当前只支持选择Linux。

        采集插件

        采集插件默认Blackbox Exporter,并选择插件的版本。

        选择安装指标采集插件的服务器

        选择服务器

        单击“选择服务器”,选择运行中的服务器,用于配置采集任务和安装Exporter。

        • 在选择服务器页面,可通过服务器ID、服务器名称、运行状态、IP地址搜索选择服务器。
        • 选择的服务器必须是UniAgent状态为运行中的服务器,否则创建的采集任务无法采集数据。
        • 如果没有您需要的服务器,可能是因为您的服务器上没有安装UniAgent,需要先安装UniAgent,同时UniAgent版本需在1.1.3及以上,如果低于此版本,请升级UniAgent到最新版本。

        连接Blackbox实例

        blackbox配置文件路径

        在安装指标采集插件的服务器上存放blackbox配置文件路径。只能包含大小写字母、数字、连字符、下划线、斜杠,英文句号和英文冒号。例如:/opt/blackbox.yml

        blackbox配置文件的配置方式可参考Blackbox exporter配置指导

      2. 单击“安装插件并测试连通性”,即可下发Exporter安装任务。
        • 当安装成功后,单击“下一步”。
        • 当安装失败时,单击“查看日志”,可以查看当前Exporter安装任务的执行日志。
      图1 采集插件配置结果
    3. 接入规则配置。
      参考表2配置指标接入规则相关参数信息。
      表2 指标接入规则参数配置表

      操作

      参数

      说明

      指标采集规则

      指标采集间隔(秒)

      指标采集的周期,单位为秒(s),默认为60s,可选择10、30和60。

      指标采集超时时间(秒)

      执行指标采集任务的超时时间,单位为秒(s),默认为60s,可选择10、30和60。

      超时时间必须小于或等于采集周期。

      执行用户

      执行指标接入规则的用户,即所选服务器的用户,默认为root。

      其他配置

      自定义键值对维度

      以键值对形式添加静态维度,用于标识指标的附加属性。单击“添加维度”可配置多个自定义键值对维度,最多可添加10个指标维度。
      • labelKey为指标附加属性的key。可以包含大小写字母、数字、下划线,且必须以字母或下划线开头。自定义键值对维度的key不允许重复。
      • labelValue为指标附加属性的key对应的值。参数值不能包含:“&”、“|”、“>”、“<”、“$”、“;”、“'”、“!”、“-”、“(”,“)”。

      例如:配置label_key为app,配置label_value为abc。

      指标采集规则参数配置完成后,可单击“YAML格式”,查看yaml格式化的配置数据。

  4. 配置完成后,单击“下一步”,即可完成Blackbox Exporter接入。

    成功接入Blackbox Exporter后,您还可以执行以下操作:

    • 返回接入中心继续接入其他数据源,详情请参见接入中心总览
    • 前往“接入管理”页面查看并管理该Exporter的接入指标配置信息,详情请参见接入管理
    • 前往“指标浏览”页面可视化分析指标,详情请参见指标浏览

相关文档