#Установка

#Обзор

Компонент мониторинга предоставляет инфраструктуру для функций мониторинга, оповещения, инспекции и проверки состояния в модуле observability. В этом документе описывается, как установить ACP Monitoring with Prometheus или ACP Monitoring with VictoriaMetrics в кластере.

Чтобы определить, какой плагин устанавливать, сначала ознакомьтесь с Руководством по выбору компонента мониторинга и выберите вариант, который лучше всего соответствует масштабу вашего кластера, плану хранения и эксплуатационным требованиям.

#Перед началом

Перед установкой компонентов мониторинга убедитесь, что выполнены следующие условия:

• Выбран подходящий компонент мониторинга на основе Руководства по выбору компонента мониторинга.
• При установке в workload-кластере убедитесь, что global-кластер может обращаться к порту 11780 workload-кластера.
• Если для данных мониторинга требуется использовать storage class или persistent volume storage, заранее создайте соответствующие ресурсы в разделе Storage.

#ACP Monitoring with Prometheus

#Установка через консоль

1. Перейдите в App Store Management > Cluster Plugins и выберите целевой кластер.

2. Найдите плагин ACP Monitoring with Prometheus и нажмите Install.

3. Настройте следующие параметры:

   В консоли выделены наиболее распространенные параметры установки. Для подробного описания настраиваемых полей см. справку YAML в этом разделе.

   Параметр	Описание
   Конфигурация масштаба	Поддерживает три конфигурации: Small Scale, Medium Scale и Large Scale: - Значения по умолчанию заданы на основе рекомендуемых значений нагрузочного тестирования платформы - Можно выбрать или настроить квоты в зависимости от фактического масштаба кластера - Значения по умолчанию будут обновляться вместе с версиями платформы; для фиксированных конфигураций рекомендуется использовать пользовательские настройки
   Тип хранилища	- LocalVolume: локальное хранилище с сохранением данных на указанных узлах - StorageClass: автоматически создает persistent volume с использованием storage class - PV: использует существующие persistent volume Примечание: конфигурацию хранилища нельзя изменить после установки
   Количество реплик	Задает количество pod’ов компонента мониторинга Примечание: Prometheus поддерживает только однузловую установку
   Дополнительная конфигурация	Сворачиваемый раздел для параметров планирования на уровне плагина.
   Node Selectors	Отображается в Дополнительная конфигурация. Настройте правила node selector на уровне плагина для workloads плагина Prometheus.
   Node Tolerations	Отображается в Дополнительная конфигурация. Настройте правила toleration на уровне плагина для workloads плагина Prometheus.
   Конфигурация параметров	При необходимости можно изменить параметры данных для компонента мониторинга

4. Нажмите Install, чтобы завершить установку.

#Установка с помощью YAML

Проверка доступных версий

Убедитесь, что плагин опубликован, проверив ресурсы ModulePlugin и ModuleConfig в кластере global:

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

Это означает, что ModulePlugin prometheus существует в кластере и версия v4.1.0 опубликована.

Создание 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:
      nodeSelector:
        - key: kubernetes.io/os
          value: linux
      tolerations:
        - effect: NoSchedule
          key: node-role.kubernetes.io/infra
          operator: Exists
      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 (Prometheus):

Проверка установки

Так как имя 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: последняя доступная версия для установки

#Размещение workloads Prometheus на infra-узлах

Если вы хотите, чтобы workloads плагина Prometheus запускались на выделенных infra-узлах, настройте правила планирования на уровне плагина во время установки или обновления, а не изменяйте сгенерированные workloads после установки.

• В консоли используйте Дополнительная конфигурация, чтобы задать Node Selectors и Node Tolerations.
• В YAML задайте spec.config.components.nodeSelector и spec.config.components.tolerations.

Пример:

config:
  components:
    nodeSelector:
      - key: kubernetes.io/os
        value: linux
    tolerations:
      - effect: NoSchedule
        key: node-role.kubernetes.io/infra
        operator: Exists

Перед применением этих правил планирования убедитесь, что планирование infra-узлов и размещение хранилища совместимы. Дополнительные рекомендации см. в руководствах Monitoring в разделе How To, включая Planning Infra Nodes for Monitoring.

#Доступ к установленным компонентам

После завершения установки компоненты будут доступны по следующим адресам (замените <> на фактические значения):

#ACP Monitoring with VictoriaMetrics

#Предварительные требования

• Если вы устанавливаете только агент VictoriaMetrics, убедитесь, что VictoriaMetrics Center установлен в другом кластере.

#Установка через консоль

1. Перейдите в App Store Management > Cluster Plugins и выберите целевой кластер.

2. Найдите плагин ACP Monitoring with VictoriaMetrics и нажмите Install.

3. Настройте следующие параметры:

   В консоли выделены наиболее распространенные параметры установки. Для подробного описания настраиваемых полей см. справку YAML в этом разделе.

   Параметр	Описание
   Конфигурация масштаба	Поддерживает три конфигурации: Small Scale, Medium Scale и Large Scale: - Значения по умолчанию заданы на основе рекомендуемых значений нагрузочного тестирования платформы - Можно выбрать или настроить квоты в зависимости от фактического масштаба кластера - Значения по умолчанию будут обновляться вместе с версиями платформы; для фиксированных конфигураций рекомендуется использовать пользовательские настройки
   Установить только агент	- Off: установить полный набор компонентов VictoriaMetrics - On: установить только компонент сбора VMAgent, который зависит от VictoriaMetrics Center
   VictoriaMetrics Center	Выберите кластер, в котором установлен полный набор компонентов VictoriaMetrics
   Тип хранилища	- LocalVolume: локальное хранилище с сохранением данных на указанных узлах - StorageClass: автоматически создает persistent volume с использованием storage class - PV: использует существующие persistent volume
   Путь хранения	Отображается, когда Тип хранилища имеет значение LocalVolume. Укажите базовый путь хранения для данных мониторинга. По умолчанию: /cpaas/monitoring.
   Количество реплик	Отображается, когда Тип хранилища имеет значение StorageClass или PV. Задает количество pod’ов компонента мониторинга. Когда Тип хранилища имеет значение LocalVolume, количество выбранных узлов определяет количество реплик VMStorage.
   Дополнительная конфигурация	Сворачиваемый раздел для параметров планирования на уровне плагина.
   Node Selectors	Отображается в Дополнительная конфигурация. Настройте правила node selector на уровне плагина для workloads плагина VictoriaMetrics.
   Node Tolerations	Отображается в Дополнительная конфигурация. Настройте правила toleration на уровне плагина для workloads плагина VictoriaMetrics.
   Конфигурация параметров	При необходимости можно изменить параметры данных для компонента мониторинга Примечание: данные могут временно превышать срок хранения до удаления

4. Нажмите Install, чтобы завершить установку.

#Установка с помощью YAML

Проверка доступных версий

Убедитесь, что плагин опубликован, проверив ресурсы ModulePlugin и ModuleConfig в кластере global:

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

Это означает, что ModulePlugin victoriametrics существует в кластере и версия v4.1.0 опубликована.

Создание 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:
      nodeSelector:
        - key: kubernetes.io/os
          value: linux
      tolerations:
        - effect: NoSchedule
          key: node-role.kubernetes.io/infra
          operator: Exists
      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

Пример настройки ресурсов (vmagent):

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

Подробности см. в разделе Планирование емкости компонента мониторинга.

Справка по полям YAML (VictoriaMetrics):

Проверка установки

Так как имя 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: последняя доступная версия для установки

#Размещение workloads VictoriaMetrics на infra-узлах

Если вы хотите, чтобы workloads плагина VictoriaMetrics запускались на выделенных infra-узлах, настройте правила планирования на уровне плагина во время установки или обновления, а не изменяйте сгенерированные workloads после установки.

• В консоли используйте Дополнительная конфигурация, чтобы задать Node Selectors и Node Tolerations.
• В YAML задайте spec.config.components.nodeSelector и spec.config.components.tolerations.

Пример:

config:
  components:
    nodeSelector:
      - key: kubernetes.io/os
        value: linux
    tolerations:
      - effect: NoSchedule
        key: node-role.kubernetes.io/infra
        operator: Exists

Перед применением этих правил планирования убедитесь, что планирование infra-узлов и размещение хранилища совместимы. Дополнительные рекомендации см. в руководствах Monitoring в разделе How To, включая Planning Infra Nodes for Monitoring.

#Доступ к установленным компонентам

После завершения установки компоненты будут доступны по следующему адресу (замените <> на фактические значения):