#安装

#概览

监控组件在可观测性模块中充当监控、告警、检查和健康检查功能的基础设施。本文档介绍如何在集群中安装 ACP Monitoring with Prometheus 插件或 ACP Monitoring with VictoriaMetrics 插件。

#安装准备

在安装监控组件之前，请确保满足以下条件：

• 请参考 监控组件选择指南 选择合适的监控组件。
• 在业务集群中安装时，请确保 global 集群能够访问业务集群的 11780 端口。
• 如果需要为监控数据使用 StorageClass 或持久卷存储，请提前在 存储 部分创建相应资源。

#通过控制台安装 ACP Monitoring with Prometheus 插件

#安装步骤

1. 进入 App Store Management > Cluster Plugins，选择目标集群。

2. 找到 ACP Monitoring with Prometheus 插件并点击 安装。

3. 配置以下参数：

   参数	描述
   Scale Configuration	支持三种配置：Small Scale、Medium Scale 和 Large Scale： - 默认值基于平台推荐的压测值设置 - 可根据实际集群规模选择或自定义配额 - 默认值会随着平台版本更新；对于固定配置，建议使用自定义设置
   Storage Type	- LocalVolume：本地存储，数据存放在指定节点上 - StorageClass：使用存储类自动生成持久卷 - PV：使用现有持久卷 注意：安装后无法修改存储配置
   Replica Count	设置监控组件 Pod 的数量 注意：Prometheus 仅支持单节点安装
   Parameter Configuration	可按需调整监控组件的数据参数

4. 点击 安装 完成安装。

#访问方式

安装完成后，可通过以下地址访问组件（请将 <> 替换为实际值）：

#通过 YAML 安装 ACP Monitoring with Prometheus 插件

#1. 检查可用版本

通过检查 global 集群中的 ModulePlugin 和 ModuleConfig 资源，确认插件已发布：

# kubectl get moduleplugin | grep prometheus
prometheus                       30h
# kubectl get moduleconfig | grep prometheus
prometheus-v4.1.0                30h

这表示集群中存在 ModulePlugin prometheus，并且版本 v4.1.0 已发布。

#2. 创建 ModuleInfo

创建一个 ModuleInfo 资源，以在不配置任何参数的情况下安装插件：

kind: ModuleInfo
apiVersion: cluster.alauda.io/v1alpha1
metadata:
  name: global-prometheus
  labels:
    cpaas.io/cluster-name: global
    cpaas.io/module-name: prometheus
    cpaas.io/module-type: plugin
spec:
  version: v4.1.0
  config:
    storage:
      type: LocalVolume
      capacity: 40
      nodes:
        - xxx.xxx.xxx.xx
      path: /cpaas/monitoring
      storageClass: ""
      pvSelectorK: ""
      pvSelectorV: ""
    replicas: 1
    components:
      prometheus:
        retention: 7
        scrapeInterval: 60
        scrapeTimeout: 45
        resources: null
      nodeExporter:
        port: 9100
        resources: null
      alertmanager:
        resources: null
      kubeStateExporter:
        resources: null
      prometheusAdapter:
        resources: null
      thanosQuery:
        resources: null
    size: Small

资源设置参考，以 prometheus 为例：

spec:
  config:
    components:
      prometheus:
        resources:
          limits:
            cpu: 2000m
            memory: 2000Mi
          requests:
            cpu: 1000m
            memory: 1000Mi

更多详情，请参考 监控组件容量规划

YAML 字段参考（VictoriaMetrics）：

#3. 验证安装

由于创建后 ModuleInfo 名称会发生变化，请通过标签定位资源以检查插件状态和版本：

kubectl get moduleinfo -l cpaas.io/module-name=victoriametrics
NAME                                             CLUSTER         MODULE            DISPLAY_NAME     STATUS    TARGET_VERSION   CURRENT_VERSION   NEW_VERSION
global-e671599464a5b1717732c5ba36079795          global          victoriametrics   victoriametrics  Running   v4.1.0           v4.1.0            v4.1.0

字段说明：

• NAME：ModuleInfo 资源名称
• CLUSTER：安装插件的集群
• MODULE：插件名称
• DISPLAY_NAME：插件显示名称
• STATUS：安装状态；Running 表示已成功安装并运行
• TARGET_VERSION：期望安装的版本
• CURRENT_VERSION：安装前的版本
• NEW_VERSION：可用于安装的最新版本

#通过控制台安装 ACP Monitoring with VictoriaMetrics 插件

#前提条件

• 如果仅安装 VictoriaMetrics Agent，请确保已在其他集群中安装 VictoriaMetrics Center。

#安装步骤

1. 进入 App Store Management > Cluster Plugins，选择目标集群。

2. 找到 ACP Monitoring with VictoriaMetrics 插件并点击 安装。

3. 配置以下参数：

   参数	描述
   Scale Configuration	支持三种配置：Small Scale、Medium Scale 和 Large Scale： - 默认值基于平台推荐的压测值设置 - 可根据实际集群规模选择或自定义配额 - 默认值会随着平台版本更新；对于固定配置，建议使用自定义设置
   Install Agent Only	- Off：安装完整的 VictoriaMetrics 组件套件 - On：仅安装 VMAgent 采集组件，依赖 VictoriaMetrics Center
   VictoriaMetrics Center	选择已安装完整 VictoriaMetrics 组件的集群
   Storage Type	- LocalVolume：本地存储，数据存放在指定节点上 - StorageClass：使用存储类自动生成持久卷 - PV：使用现有持久卷
   Replica Count	设置监控组件 Pod 的数量： - LocalVolume 存储类型不支持多个从节点 - 其他存储类型请参考界面提示进行配置
   Parameter Configuration	可调整监控组件的数据参数 注意：数据在删除前可能会暂时超过保留周期

4. 点击 安装 完成安装。

#通过 YAML 安装 ACP Monitoring with VictoriaMetrics 插件

#1. 检查可用版本

通过检查 global 集群中的 ModulePlugin 和 ModuleConfig 资源，确认插件已发布：

# kubectl get moduleplugin | grep victoriametrics
victoriametrics                       30h
# kubectl get moduleconfig | grep victoriametrics
victoriametrics-v4.1.0                30h

这表示集群中存在 ModulePlugin victoriametrics，并且版本 v4.1.0 已发布。

#2. 创建 ModuleInfo

创建一个 ModuleInfo 资源，以在不配置任何参数的情况下安装插件：

kind: ModuleInfo
apiVersion: cluster.alauda.io/v1alpha1
metadata:
  name: business-1-victoriametrics
  labels:
    cpaas.io/cluster-name: business-1
    cpaas.io/module-name: victoriametrics
    cpaas.io/module-type: plugin
spec:
  version: v4.1.0
  config:
    storage:
      type: LocalVolume
      capacity: 40
      nodes:
        - xxx.xxx.xxx.xx
      path: /cpaas/monitoring
      storageClass: ""
      pvSelectorK: ""
      pvSelectorV: ""
    replicas: 1
    agentOnly: false
    agentReplicas: 1
    crossClusterDependency:
      victoriametrics: ""
    components:
      nodeExporter:
        port: 9100
        resources: null
      vmstorage:
        retention: 7
        resources: null
      kubeStateExporter:
        resources: null
      vmalert:
        resources: null
      prometheusAdapter:
        resources: null
      vmagent:
        scrapeInterval: 60
        scrapeTimeout: 45
        resources: null
      vminsert:
        resources: null
      alertmanager:
        resources: null
      vmselect:
        resources: null
    size: Small

资源设置参考，以 prometheus 为例：

spec:
  config:
    components:
      vmagent:
        resources:
          limits:
            cpu: 2000m
            memory: 2000Mi
          requests:
            cpu: 1000m
            memory: 1000Mi

更多详情，请参考 监控组件容量规划

YAML 字段参考（Prometheus）：

#3. 验证安装

由于创建后 ModuleInfo 名称会发生变化，请通过标签定位资源以检查插件状态和版本：

kubectl get moduleinfo -l cpaas.io/module-name=prometheus
NAME                                             CLUSTER         MODULE        DISPLAY_NAME   STATUS    TARGET_VERSION   CURRENT_VERSION   NEW_VERSION
global-e671599464a5b1717732c5ba36079795          global          prometheus    prometheus     Running   v4.1.0           v4.1.0            v4.1.0

字段说明：

• NAME：ModuleInfo 资源名称
• CLUSTER：安装插件的集群
• MODULE：插件名称
• DISPLAY_NAME：插件显示名称
• STATUS：安装状态；Running 表示已成功安装并运行
• TARGET_VERSION：期望安装的版本
• CURRENT_VERSION：安装前的版本
• NEW_VERSION：可用于安装的最新版本