部署 VM Agent

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

概述

高可用性说明

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

组件说明

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

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

默认规格

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

前提条件

• 已创建自建 Kubernetes 集群，并通过 云企业网 等方式打通私有网络（VPC）与云下数据中心（IDC）。
• 已创建 VMP 工作区，详情请参见 创建工作区。
• 使用脚本安装 VM Agent 时，需要使用本地环境（Linux/Mac）中的 wget、echo、curl 和 sed 工具，请保证您的系统中已经正确安装上述命令行工具。

部署实例（默认配置）

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

1. 在本地环境中下载脚本，详情请参见 获取脚本。
2. 使用 kubectl 正确连接 Kubernetes 集群。
3. 执行以下命令，部署 VM Agent 采集器。

./install.sh \
--agent vmagent \ # 采集器类型。
--region cn-beijing \ # VM 工作区所在地域。
--remote-write-url http://write.prometheus-cn-beijing.ivolces.com/workspaces/b762e1a3-37***/api/v1/write \ # VMP 工作区的 Remote Write 地址，并添加 api/vi/write 后缀。
--namespace volcano-metrics \ # 部署采集器的命名空间。
--basic-auth-username username-demo \ # VMP 工作区 Basic Auth 认证模式下的认证用户名。
--basic-auth-password password-demo  # VMP 工作区 Basic Auth 认证模式下的认证密码。

部署实例（自定义配置）

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

1. 在本地环境中下载脚本，详情请参见 获取脚本。
2. 使用 kubectl 正确连接 Kubernetes 集群。
3. 执行以下命令，修改配置项并部署 VM Agent 采集器。

./install.sh \
--region cn-beijing \ # VMP 工作区所在地域。
--remote-write-url http://write.prometheus-cn-beijing.ivolces.com/workspaces/b762e1a3-37***/api/v1/write \ # VMP 工作区的 URL 地址，并添加 api/v1/write 后缀。
--basic-auth-username username-demo \ # VMP 工作区 Basic Auth 认证模式下的认证用户名。
--basic-auth-password password-demo \ # VMP 工作区 Basic Auth 认证模式下的认证密码。
--agent vmagent \ # 采集器类型。
--namespace volcano-metrics \ # 部署采集器的命名空间。
--agent-scrape-interval 15s \ # 采集器的数据采集间隔。
--vmagent-replicas 1 \ # VM Agent 采集器的副本数。
--vmagent-shards 2 \ # VM Agent 采集器的分片数。
--vmagent-resources-requests-cpu 100m \ # VM Agent 采集器的 CPU 请求值。
--vmagent-resources-requests-memory 200Mi \ # VM Agent 采集器的内存请求值。
--vmagent-resources-limits-cpu 100m \ # VM Agent 采集器的 CPU 上限值。
--vmagent-resources-limits-memory 200Mi \ # VM Agent 采集器的内存上限值。
--kube-state-metrics-shards 2 \ # kube-state-metrics 组件的分片数。
--kube-state-metrics-resources-requests-cpu 50m \ # kube-state-metrics 的 CPU 请求值。
--kube-state-metrics-resources-requests-memory 100Mi \ # kube-state-metrics 的内存请求值。
--kube-state-metrics-resources-limits-cpu 50m \ # kube-state-metrics 的 CPU 上限值。
--kube-state-metrics-resources-limits-memory 100Mi # kube-state-metrics 的内存上限值。

部署实例（自定义参数）

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

1. 在本地环境中下载脚本，详情请参见 获取脚本。
2. 使用 kubectl 正确连接 Kubernetes 集群。
3. 执行以下命令，配置您的自定义参数，并输出 install.yaml 配置文件。

./install.sh \
--region cn-beijing \
--remote-write-url http://write.prometheus-cn-beijing.ivolces.com/workspaces/b762e1a3-37***/api/v1/write \
--basic-auth-username username-demo \
--basic-auth-password password-demo \
--agent vmagent \
--rendering-only > install.yaml

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

vim install.yaml

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

kubectl apply -f install.yaml

检查结果

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

后续操作

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

使用帮助

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

./install.sh install --help

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

./install.sh install --help
install agent and system metrics exporter. if it is VM Agent, vmoperator will also be installed

Usage: install.sh install [flag...]

Flag:
  {{flag}} {{current val if exist}}
  --agent vmagent
  --remote-write-url http://write.prometheus-cn-beijing.com/workspace/b762e1a3-37***/api/v1/write
  --basic-auth-username username-demo
  --basic-auth-password password-demo
  --access-key AKLTMxxx
  --secret-key Tkdabxxx
  --region cn-beijing
  --exec-script-env local
  --rendering-only
  --namespace volcano-metrics
  --topology-key-zone topology.kubernetes.io/zone
  --topology-key-node kubernetes.io/hostname
  --storage-class 
  --kube-state-metrics-shards 1
  --kube-state-metrics-resources-requests-cpu 100m
  --kube-state-metrics-resources-requests-memory 250Mi
  --kube-state-metrics-resources-limits-cpu 500m
  --kube-state-metrics-resources-limits-memory 1Gi
  --agent-scrape-interval 15s
  --vmpagent-name vmpagent
  --vmpagent-replicas 1
  --vmpagent-pvc-capacity
  --vmpagent-resources-requests-cpu 500m
  --vmpagent-resources-requests-memory 1Gi
  --vmpagent-resources-limits-cpu 2
  --vmpagent-resources-limits-memory 4Gi
  --vmagent-replicas 1
  --vmagent-shards 2
  --vmagent-pvc-capacity
  --vmagent-resources-requests-cpu 200m
  --vmagent-resources-requests-memory 400Mi
  --vmagent-resources-limits-cpu 1
  --vmagent-resources-limits-memory 2Gi
  --disable-cadvisor
  --cadvisor-only
  --disable-install-node-exporter