文档中心

托管 Prometheus

高可用采集方案

部署 VM Agent

采用高可用采集方案，您需要首先在目标集群中部署 VM Agent 采集器。本文为您详细介绍 VM Agent 采集器的基本概念、部署步骤和参数配置。

注意

VM Agent 为 VictoriaMetrics 原生版本，暂时不支持火山引擎 AK/SK 鉴权方式。

如果您使用的是火山引擎容器服务（VKE）集群，建议您直接在集群中使用组件管理功能安装采集器和组件，详情请参见容器服务接入。

概述

高可用性说明

VM Agent 采集器自带 Operator，能够实现采集器和 kube-state-metrics 组件的分片和数据采集，性能和可用性较高。

组件说明

当您在集群中安装 VM Agent 采集器时，会同时安装 vm-operator、kube-state-metrics 和 node-exporter 组件。每个组件的名称、类型和作用说明如下表所示。

组件名称	负载类型	命名空间	说明
vmagent	StatefulSet	volcano-metrics	采集集群内 kubelet、kubelet-cadvisor 、kube-state-metrics 、node-exporter 暴露的指标。
vm-operator	Deployment	volcano-metrics	VM Agent 控制组件。
kube-state-metrics	StatefulSet	volcano-metrics	提供 Kubernetes 资源信息指标数据。
node-exporter	DaemonSet	volcano-metrics	提供节点资源信息指标数据。

在此场景下，VM Agent 充当 VMP 服务的数据采集组件，直接抓取监控对象的监控数据，并将监控数据发送至 VMP 服务进行保存。默认情况下，监控数据包括： node-exporter、 kubelet metrics/cadvisor、kubelet metrics、kube-state-metrics 和 agent 自身。

默认规格

VM Agent 采集器中涉及的组件，默认的实例规格如下表所示。

组件名称	默认 CPU 请求值	默认内存请求值	默认 CPU 上限值	默认内存上限值
vmagent	2 Core	2 GiB	4 Core	4 GiB
kube-state-metrics	0.2 Core	512 MiB	0.8 Core	2 GiB
node-exporter	0.05 Core	128 MiB	0.1 Core	256 MiB

前提条件

已创建自建 Kubernetes 集群，并通过云企业网等方式打通私有网络（VPC）与云下数据中心（IDC）。

已创建 VMP 工作区，详情请参见创建工作区。

使用脚本安装 VM Agent 时，需要使用本地环境（Linux/Mac）中的 wget、echo、curl 和 sed 工具，请保证您的系统中已经正确安装上述命令行工具。

注意

VM Agent 采集器与容器服务集群中的 promethues-agent 组件冲突，不能同时使用，部署 VM Agent 前，请确认您的集群中没有安装 promethues-agent 组件。详情请参见容器服务接入。

部署实例（默认配置）

您可以使用部署脚本，快速部署 VM Agent 采集器。当采用缺省配置部署时，操作步骤如下：

在本地环境中下载脚本，详情请参见获取脚本。

使用 kubectl 正确连接 Kubernetes 集群。

执行以下命令，部署 VM Agent 采集器。

说明

上述配置中，请根据您的实际情况，修改 region、remote-write-url、namespace、basic-auth-username 和 basic-auth-password 参数。

部署实例（自定义配置）

如果采集器的默认规格无法满足您的需求，支持在部署前，使用部署脚本中的预定义参数，修改实例配置（例如：采集器的 CPU 和内存容量）。操作步骤如下：

在本地环境中下载脚本，详情请参见获取脚本。

使用 kubectl 正确连接 Kubernetes 集群。

执行以下命令，修改配置项并部署 VM Agent 采集器。

部署实例（自定义参数）

如果部署脚本中预定义的参数无法满足您的需求，您也可以自定义相关参数，操作步骤如下：

在本地环境中下载脚本，详情请参见获取脚本。

使用 kubectl 正确连接 Kubernetes 集群。

执行以下命令，配置您的自定义参数，并输出 install.yaml 配置文件。

进入 install.yaml 文件，配置相关参数并保存。

执行如下命令，部署相关组件。

检查结果

VM Agent 正确部署后，登录集群，在无状态负载列表中，可以查看到 vm-operator 工作负载。在有状态负载列表中，可以查看到 VM Agent 和 kube-state-metrics 工作负载。

说明

为了保证采集器能够正常采集数据，除需要保证采集器正常工作外，还需要保证采集对象的 Metrics API 或 Exporter 正常。相关的配置和部署，需要您自己完成并保证正确。

后续操作

采集器部署完成后，除默认的采集规则外，您可以使用 ServiceMonitor 或 PodMonitor 配置面向自定义目标的采集规则。详情请参见服务发现。

使用帮助

您可以通过安装脚本的 --help 参数，查看脚本中所有的预定义字段和含义。

安装脚本中不同字段的含义和示例如下。

参数	说明
--agent	选择部署的采集器，取值固定为 vmagent。
--remote-write-url	VMP 工作区的 Remote Write 地址，详情请参见获取工作区地址。
--basic-auth-username	VMP 工作区 Basic Auth 认证模式下的认证用户名。
--basic-auth-password	VMP 工作区 Basic Auth 认证模式下的认证密码。
--region	部署采集器集群的地域，例如：cn-beijing。详情请参见地域和可用区。
--exec-script-env	部署脚本执行环境，包括： local: 本地环境。表示您在本地环境中执行该脚本。 public-cloud-vpc：VPC 环境。表示您在 VPC 环境中执行该脚本。
--rendering-only	仅查看 VM Agent、vm-operator 等组件的安装清单，不实际安装。
--namespace	部署采集器的命名空间，如未配置该参数，默认部署在volcano-metrics命名空间。
--storage-class	PVC 存储类型。
--kube-state-metrics-shards	kube-state-metrics 组件的分片数。
--kube-state-metrics-resources-requests-cpu	kube-state-metrics 的 CPU 请求值，整数形式，单位为 m，例如：100m 表示 CPU 请求值为 100 毫核。
--kube-state-metrics-resources-requests-memory	kube-state-metrics 的内存请求值，整数形式，单位为 Mi ，例如：200Mi 表示内存请求值为 200MB。
--kube-state-metrics-resources-limits-cpu	kube-state-metrics 的 CPU 上限值，整数形式，单位为 m，例如：100m 表示 CPU 上限值为 100 毫核。
--kube-state-metrics-resources-limits-memory	kube-state-metrics 的内存上限值，整数形式，单位为 Mi ，例如：200Mi 表示内存上限值为 200MB。
--agent-scrape-interval	采集器的数据采集间隔，整数形式，单位为 s，例如：15s。
--vmpagent-name	VMP Agent 采集器的名称。
--vmpagent-replicas	VMP Agent 采集器的副本数。
--vmpagent-pvc-capacity	VMP Agent 采集器的存储能力。
--vmpagent-resources-requests-cpu	VMP Agent 采集器的 CPU 请求值，整数形式，单位为 m，例如：100m 表示 CPU 请求值为 100 毫核。
--vmpagent-resources-requests-memory	VMP Agent 采集器的内存请求值，整数形式，单位为 Mi ，例如：200Mi 表示内存请求值为 200MB。
--vmpagent-resources-limits-cpu	VMP Agent 采集器的 CPU 上限值，整数形式，单位为 m，例如：100m 表示 CPU 上限值为 100 毫核。
--vmpagent-resources-limits-memory	VMP Agent 采集器的内存上限值，整数形式，单位为 Mi ，例如：200Mi 表示内存上限值为 200MB。
--vmagent-replicas	VM Agent 采集器的副本数。
--vmagent-shards	VM Agent 采集器的分片数。
--vmagent-pvc-capacity	VM Agent 采集器的存储容量。
--vmagent-resources-requests-cpu	VM Agent 采集器的 CPU 请求值，整数形式，单位为 m，例如：100m 表示 CPU 请求值为 100 毫核。
--vmagent-resources-requests-memory	VM Agent 采集器的内存请求值，整数形式，单位为 Mi ，例如：200Mi 表示内存请求值为 200MB。
--vmagent-resources-limits-cpu	VM Agent 采集器的 CPU 上限值，整数形式，单位为 m，例如：100m 表示 CPU 上限值为 100 毫核。
--vmagent-resources-limits-memory	VM Agent 采集器的内存上限值，整数形式，单位为 Mi ，例如：200Mi 表示内存上限值为 200MB。
--disable-cadvisor	禁用 VMP Agent 采集器对 cadvisor 的采集规则。
--cadvisor-only	仅启用 VMP Agent 采集器对 cadvisor 采集规则。
--disable-install-node-exporter	禁用 VMP Agent 采集器对 node-exporter 的采集规则。

最近更新时间：2025.06.23 14:33:15

这个页面对您有帮助吗？

有用

无用