文档中心

托管 Prometheus

云服务接入

云监控接入

托管 Prometheus 支持接入云监控，满足用户对云上基础资源、云产品、自定义业务的统一监控需求。本文为您介绍如何在托管 Prometheus 上接入云监控。

说明

【邀测·申请试用】：该功能依赖云监控产品开白能力，如需使用，请联系您的客户经理，协助您开通云监控 Exporter 功能。

背景信息

方案介绍

云监控是火山引擎云上一站式监控告警解决方案。可以帮助您收集并可视化展示火山引擎上多种类型云产品的资源状态和监控信息，包括：云服务器、集群、网关、专线连接、云存储等。详情请参见什么是云监控。

您可以通过在托管 Prometheus 上接入云监控的方式，将云监控上的云产品监控数据实时导出到托管 Prometheus，与您集群中的业务监控数据进行汇聚，实现业务数据和基础资源数据的统一监控。同时，还可以借助托管 Prometheus 与 Grafana 的天然兼容性，使用 Grafana 搭建业务相关的大盘。

支持的云产品

托管 Prometheus 接入中心仅支持通过云监控，导出部分云产品的指标到 Prometheus。支持的云产品详情，请参见支持的云产品。

指标结构

云监控产品导出的数据中，指标名称由Namespace、SubNamespace、MetricName组成，其中：

Namespace表示云产品。各云产品的Namespace请参见云产品指标查询。

SubNamespace表示云产品下的指标细分分类。

MetricName表示指标名。

说明

例如，当您导出云服务器（ECS）指标时，Namespace为VCM_ECS，SubNamespace为GPU，MetricName为GpuTemperature导出的指标名为GpuTemperature_GPU_VCM_ECS。

前提条件

已开通云监控和云监控的按量计费方式，详情请参见产品计费。

相关云产品已接入云监控。

已创建托管 Prometheus 工作区，详情请参见创建工作区。

操作步骤

配置集成任务

在顶部导航栏，选择目标地域。

在左侧导航栏中选择接入中心 > 组件，在组件中心单击需要接入的产品名称。本文以应用型负载均衡为例。

说明

如果您没有在接入中心找到需要接入的产品，可以单击云监控（批量接入），尝试接入目标云产品。

服务授权检查。系统会检查云监控服务相关权限是否已经授权。如未授权或开通，请根据页面指引，完成服务授权或功能开通。

单击创建集成任务，并选择开始接入页签，配置集成任务的详情。

配置项	说明
基础信息
任务名称	配置集成任务的名称。支持中文、英文大小写、数字和下划线_。取值范围为 1～40 个字符。
工作区	选择已创建的托管 Prometheus 工作区。
JobName	配置云监控采集任务的名称。该名称用于区分不同的采集任务。接入后，您可以在资源消耗中使用该名称查看采集到的指标数量。
云产品选择
地域	选择需要通过云监控采集指标云产品所在的地域。对于部分无地域属性的云产品（例如：云企业网），请选择无地域展示。
云产品选择	选择需要从云监控拉取指标的云产品。
采集设置
采集间隔	配置指标采集间隔。支持选择 30s、1m、2m 和 5m。
元信息 Label 导出方式	配置云产品元信息导出方式。元信息主要包含云产品实例的 ProjectName、Name 等 Label。追加到原始指标：元信息将会追加到原始指标中，作为原始指标的 Label。支持使用原始指标进行查询。添加为独立指标：元信息将作为独立指标。支持使用volc_resource_info指标进行查询。说明仅部分云产品支持导出元信息，且不同云产品支持导出的元信息字段不同，详情请参见云监控文档。
高级设置
实例导出标签键	单击添加标签键，配置从云监控拉取产品指标时，需要导出的火山引擎资源标签。详情请参见标签概述。说明若标签键列表获取失败，根据报错提示，检查 GetTagKeys 权限或网络环境后重试。
Metric Relabel 配置	配置指标 Relabel，支持在指标采集的过程中，新增或替换指标中的 Label。详情请参见指标 Relabel。
ProductConfig 配置	配置指标筛选，支持基于 Project、Subnamespace、指标和实例 ID 对采集对象进行筛选。详情请参见下文 ProductConfig 配置说明。

获取监控大盘

选择效果预览页签，支持查看云产品监控大盘示例。在云产品选择下拉菜单中选择您需要监控的云产品，单击获取 Grafana 模版，即可下载 JSON 格式的 Grafana 监控大盘模版。

查询监控指标

选择采集指标页签。

在云产品选择下拉菜单中选择您需要监控的云产品，并在 SubNamespace 下拉菜单中选择该云产品的指标分类。即可查看该分类下的指标详情。

说明

更多云产品指标，请参见云监控指标查询。

后续操作

配置完成后，您可以查看集成任务的状态和详情，确定云监控是否正确接入 Promethues。同时，支持基于模版配置告警规则，以便出现异常时能够及时触发告警。

在左侧导航栏中选择接入中心 > 接入任务，并选择托管环境页签。

在任务列表中，选择目标任务，单击任务名称，进入任务详情页面，即可查看集成任务的任务详情和监控看板。

选择任务信息，支持查看任务详情。

选择看板大盘，支持查看集成任务的监控大盘。包括：云产品实例数量、云产品指标数量、上一轮采集总耗时等。

选择告警模版，可查看对应产品的预置告警模板，展示了该模板的名称/ID、版本、模版分类、描述、关联规则组数、时间等信息。单击操作栏中的应用模板，即可基于该模板创建告警规则组。

高级配置

ProductConfig 配置说明

 #仅采集指定 project 下的资源对象指标​
ProjectName: [""]​
​
 #仅采集指定 SubNamespace 下的指标​
OnlyIncludeSubNamespaces: [""]​
​
 #排除采集 SubNamespace 下的指标​
ExcludeSubNamespaces: [""]​
​
 #仅需要采集的指标，<sub-namespace>为云产品子命名空间​
OnlyIncludeMetrics:​
  <subNamespace>: [""]​
​
 #排除指标列表，<sub-namespace>为云产品子命名空间​
ExcludeMetrics: ​
  <subNamespace>: [""]​
​
 #仅采集指定实例 ID 列表的指标​
OnlyIncludeInstances: [""]​
​
 #排除采集实例 ID 列表的指标​
ExcludeInstances: [""]​

配置项	说明
ProjectName	使用 Project 对采集对象进行筛选。例如配置为ProjectName: ["default"]时，表示仅采集属于default 项目的对象。
OnlyIncludeSubNamespaces	使用云产品 SubNamespace 对采集指标进行筛选，仅采集指定 SubNamespace 下的指标。例如：接入 ECS 产品时，如果配置为OnlyIncludeSubNamespaces: ["GPU"]，表示仅采集 ECS 实例中 GPU 相关的指标。云产品 SubNamespace 查询，请参见云产品指标查询。
ExcludeSubNamespaces	使用云产品 SubNamespace 对采集指标进行筛选，排除采集指定 SubNamespace 下的指标。例如：接入 ECS 产品时，如果配置为OnlyIncludeSubNamespaces: ["GPU"]，表示不采集 ECS 实例中 GPU 相关的指标，其他指标均采集。云产品 SubNamespace 查询，请参见云产品指标查询。
OnlyIncludeMetrics	配置仅需要采集的指标。其中，<sub-namespace>为云产品子命名空间。云产品指标查询，请参见云产品指标查询。例如，当接入产品为 ECS，并配置为如下代码时，表示仅采集 SubNamespace 为Instance中的 CPU 指标和 SubNamespace 为 GPU 中的 GPU 指标。 OnlyIncludeMetrics: Instance: ["CpuSystem","CPUUser","CpuOther"] GPU: ["GpuMemoryUsedSpace","GpuUsedUtilization"]
ExcludeMetrics	配置需要排除的指标。其中，<sub-namespace>为云产品子命名空间。云产品指标查询，请参见云产品指标查询。例如，当接入产品为 ECS，并配置为如下代码时，表示不采集 SubNamespace 为Instance中的 CPU 指标和 SubNamespace 为 GPU 中的 GPU 指标。其他指标均采集。 ExcludeMetrics: Instance: ["CpuSystem","CPUUser","CpuOther"] GPU: ["GpuMemoryUsedSpace","GpuUsedUtilization"]
OnlyIncludeInstances	使用云产品实例 ID 对采集对象进行筛选，仅采集指定实例的指标。例如：接入 ECS 产品时，如果配置为OnlyIncludeInstances: ["i-ye3dvuypkws6ip***"]，表示仅采集指定 ECS 实例中的指标。
ExcludeInstances	使用云产品实例 ID 对采集对象进行筛选，排除采集指定实例的指标。例如：接入 ECS 产品时，如果配置为OnlyIncludeInstances: ["i-ye3dvuypkws6ip***"]，表示不采集指定 ECS 实例中的指标。

说明

您可以同时配置多个筛选条件，多个条件之间为与关系，即只有同时满足所有条件的对象或指标，才会被采集。

监控信息

查询云产品指标

在顶部导航栏，选择目标地域。

单击左侧导航栏的 Explore，进入 Explore 页面。

在右上角的配置项中，配置需要查询指标的工作区，并在指标检索文本框内，使用云监控的指标（例如CPUUser_Instance_VCM_ECS）查询，确认是否能够正确查询到对应的指标。

说明

云监控导出指标的名称格式为MetricName_SubNamespace_Namespace，例如CPUUser_Instance_VCM_ECS。不同云服务产品的指标详情，请参见云产品监控指标。

您可以使用ResourceID字段，对资源进行细粒度筛选，查看具体资源的监控信息。

如果您需要使用 Grafana 构建监控大盘，可以将托管 Prometheus 的数据接入自建 Grafana。详情请参见在容器服务集群中部署 Grafana 并接入工作区。

查询云产品实例元信息

说明

仅部分云产品支持导出元信息，且不同云产品支持导出的元信息字段不同。详情请参考云监控文档。

当元信息 Label 导出方式选择追加到原始指标时，可以直接在 Explorer 页面查看云产品的原始指标。查询结果中包含云产品的元信息 Label。例如在本例中，可以在 ECS 的原始指标CPUUser_Instance_VCM_ECS中查看到其元信息 Label（ProjectName、Name、Status、AvailableZone 等）。