#Установка

Система логирования платформы состоит из трёх плагинов: Alauda Container Platform Log Essentials, Alauda Container Platform Log Collector и Alauda Container Platform Log Storage. В этой главе будет представлено руководство по установке этих плагинов.

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

Плагины Alauda Container Platform Log Storage можно устанавливать в любом кластере, и для сбора логов можно выбрать компонент хранения логов любого кластера для взаимодействия с данными хранения.

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

• Избегайте развертывания плагинов хранения логов в глобальном кластере. Вместо этого разворачивайте их в рабочих кластерах, чтобы сбои в управляющем кластере не нарушали процесс решения проблем на основе логов.

• Старайтесь централизовать логи в одном кластере хранения логов. Если объём логов превышает максимальные пороги, распределяйте логи по нескольким кластерам хранения.

• Разворачивайте как минимум один экземпляр хранения логов в каждой сетевой зоне для локальной агрегации логов, что минимизирует трафик по публичной сети между дата-центрами (что дорого и увеличивает задержки).

• Выделяйте отдельные узлы под хранение логов, избегая совместного развертывания с другими приложениями или компонентами платформы. Хранение логов требует высокой пропускной способности ввода-вывода и может страдать от помех.

• Монтируйте выделенные SSD-диски для хранения логов для значительного повышения производительности.

#Установка Alauda Container Platform Log Essentials через консоль

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

2. На вкладке Plugins нажмите кнопку действий справа от Alauda Container Platform Log Essentials > Install.

3. Нажмите Install.

#Установка Alauda Container Platform Log Essentials через YAML

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

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

# kubectl get moduleplugin | grep log-api
log-api                       30h
# kubectl get moduleconfig | grep log-api
log-api-v4.2.0                30h

Это означает, что в кластере существует ModulePlugin log-api и опубликована версия v4.2.0.

#2. Создание ModuleInfo

Создайте ресурс ModuleInfo для установки плагина без параметров конфигурации:

apiVersion: cluster.alauda.io/v1alpha1
kind: ModuleInfo
metadata:
  annotations:
    cpaas.io/display-name: log-api
    cpaas.io/module-name: '{"en": "Alauda Container Platform Log Essentials", "zh":
      "Alauda Container Platform Log Essentials"}'
  labels:
    cpaas.io/cluster-name: global
    cpaas.io/module-name: log-api
    cpaas.io/module-type: plugin
    cpaas.io/product: Platform-Center
  name: global-b4a67e6adb67bad47544354e9bf2bdff
spec:
  version: v4.2.0
  valuesOverride:
    ait/chart-alauda-log-api:
      global:
        nodeSelector:
          node-role.kubernetes.io/infra: "true"
        tolerations:
        - effect: NoSchedule
          key: node-role.kubernetes.io/infra
          value: reserved
          operator: Equal

Справочник по полям YAML:

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

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

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

Объяснение полей:

• NAME: имя ресурса ModuleInfo
• CLUSTER: кластер, в котором установлен плагин
• MODULE: имя плагина
• DISPLAY_NAME: отображаемое имя плагина
• STATUS: статус установки; Running означает успешную установку и работу
• TARGET_VERSION: версия, которую планируется установить
• CURRENT_VERSION: версия до установки
• NEW_VERSION: последняя доступная версия для установки

#Установка Alauda Container Platform Log Storage с ElasticSearch через консоль

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

2. На вкладке Plugins нажмите кнопку действий справа от Alauda Container Platform Log Storage with ElasticSearch > Install.

3. Следуйте инструкциям для настройки соответствующих параметров.

   Параметр	Описание
   Connect External Elasticsearch	Оставьте закрытым для установки плагина хранения логов внутри платформы.
   Component installation Settings	LocalVolume: Локальное хранилище, данные логов будут храниться в локальном пути выбранного узла. Преимущество — компонент логирования напрямую привязан к локальному хранилищу, что исключает доступ к хранилищу по сети и обеспечивает лучшую производительность. StorageClass: Динамическое создание ресурсов хранения с помощью классов хранения для сохранения логов. Преимущество — большая гибкость; при наличии нескольких классов хранения для всего кластера администраторы могут выбирать соответствующий класс для компонентов логирования в зависимости от сценариев использования, снижая влияние сбоев хоста на хранение. Однако производительность StorageClass может зависеть от пропускной способности и задержек сети, а также полагается на механизмы избыточности бэкенда хранения для обеспечения высокой доступности.
   Retention Period	Максимальное время хранения логов, событий и аудита в кластере. Данные, превышающие период хранения, будут автоматически удалены. Совет: Вы можете делать резервные копии данных, которые нужно хранить длительное время. При необходимости обратитесь в техническую поддержку.

4. Нажмите Install.

#Установка Alauda Container Platform Log Storage с ElasticSearch через YAML

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

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

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

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

#2. Создание ModuleInfo

Создайте ресурс ModuleInfo для установки плагина без параметров конфигурации:

apiVersion: cluster.alauda.io/v1alpha1
kind: ModuleInfo
metadata:
  annotations:
    cpaas.io/display-name: logcenter
    cpaas.io/module-name: '{"en": "Alauda Container Platform Log Storage for Elasticsearch", "zh": "Alauda Container Platform Log Storage for Elasticsearch"}'
  labels:
    cpaas.io/cluster-name: go
    cpaas.io/module-name: logcenter
    cpaas.io/module-type: plugin
    cpaas.io/product: Platform-Center
  name: <cluster>-log-center
spec:
  config:
    clusterView:
      isPrivate: "true"
    components:
      elasticsearch:
        address: ""
        basicAuthSecretName: ""
        hostpath: /cpaas/data/elasticsearch
        httpPort: 9200
        install: true
        k8sNodes:
        - 192.168.139.75
        masterK8sNodes: []
        masterReplicas: 0
        masterResources:
          limits:
            cpu: "2"
            memory: 4Gi
          requests:
            cpu: 200m
            memory: 256Mi
        masterStorageSize: 5
        nodeReplicas: 1
        nodeStorageSize: 200
        resources:
          limits:
            cpu: "4"
            memory: 4Gi
          requests:
            cpu: "1"
            memory: 1Gi
        tcpPort: 9300
        type: single
      kafka:
        address: ""
        auth: true
        basicAuthSecretName: ""
        exporterPort: 9308
        install: true
        k8sNodes:
        - 192.168.139.75
        port: 9092
        storageSize: 10
        tls: true
        zkElectPort: 3888
        zkExporterPort: 9141
        zkLeaderPort: 2888
        zkPort: 2181
      kibana:
        install: false
      storageClassConfig:
        name: elasticsearch-local-log-sc
        type: LocalVolume
      zookeeper:
        storageSize: 1
    ttl:
      audit: 180
      event: 180
      logKubernetes: 7
      logPlatform: 7
      logSystem: 7
      logWorkload: 7
  version: v4.1.0
  valuesOverride:
    ait/chart-alauda-log-center:
      global:
        nodeSelector:
          node-role.kubernetes.io/infra: "true"
        tolerations:
        - effect: NoSchedule
          key: node-role.kubernetes.io/infra
          value: reserved
          operator: Equal

Справочник по полям YAML:

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

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

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

Объяснение полей:

• NAME: имя ресурса ModuleInfo
• CLUSTER: кластер, в котором установлен плагин
• MODULE: имя плагина
• DISPLAY_NAME: отображаемое имя плагина
• STATUS: статус установки; Running означает успешную установку и работу
• TARGET_VERSION: версия, которую планируется установить
• CURRENT_VERSION: версия до установки
• NEW_VERSION: последняя доступная версия для установки

#Установка Alauda Container Platform Log Storage с Clickhouse через консоль

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

2. На вкладке Plugins нажмите кнопку действий справа от Alauda Container Platform Log Storage with Clickhouse > Install.

3. Следуйте инструкциям для настройки соответствующих параметров.

   Параметр	Описание
   Component installation Settings	LocalVolume: Локальное хранилище, данные логов будут храниться в локальном пути выбранного узла. Преимущество — компонент логирования напрямую привязан к локальному хранилищу, что исключает доступ к хранилищу по сети и обеспечивает лучшую производительность. StorageClass: Динамическое создание ресурсов хранения с помощью классов хранения для сохранения логов. Преимущество — большая гибкость; при наличии нескольких классов хранения для всего кластера администраторы могут выбирать соответствующий класс для компонентов логирования в зависимости от сценариев использования, снижая влияние сбоев хоста на хранение. Однако производительность StorageClass может зависеть от пропускной способности и задержек сети, а также полагается на механизмы избыточности бэкенда хранения для обеспечения высокой доступности.
   Retention Period	Максимальное время хранения логов, событий и аудита в кластере. Данные, превышающие период хранения, будут автоматически удалены. Совет: Вы можете делать резервные копии данных, которые нужно хранить длительное время. При необходимости обратитесь в техническую поддержку.

4. Нажмите Install.

#Установка Alauda Container Platform Log Storage с Clickhouse через YAML

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

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

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

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

#2. Создание ModuleInfo

Создайте ресурс ModuleInfo для установки плагина без параметров конфигурации:

apiVersion: cluster.alauda.io/v1alpha1
kind: ModuleInfo
metadata:
  name: global-logclickhouse
  labels:
    cpaas.io/cluster-name: global
    cpaas.io/module-name: logclickhouse
    cpaas.io/module-type: plugin
spec:
  version: v4.1.0
  config:
    components:
      storageClassConfig:
        type: LocalVolume
        name: ""
      clickhouse:
        resources:
          limits:
            cpu: "2"
            memory: 4Gi
          requests:
            cpu: 200m
            memory: 256Mi
        k8sNodes:
          - xxx.xxx.xxx.xx
        hostpath: /cpaas/data/clickhouse
        nodeReplicas: 1
        nodeStorageSize: 200
        type: single
      razor:
        resources:
          limits:
            cpu: "2"
            memory: 1Gi
          requests:
            cpu: 10m
            memory: 256Mi
      vector:
        resources:
          limits:
            cpu: "4"
            memory: 1Gi
          requests:
            cpu: 10m
            memory: 256Mi
    ttl:
      audit: 180
      event: 180
      logKubernetes: 7
      logPlatform: 7
      logSystem: 7
      logWorkload: 7
  valuesOverride:
    ait/chart-alauda-log-clickhouse:
      global:
        nodeSelector:
          node-role.kubernetes.io/infra: "true"
        tolerations:
        - effect: NoSchedule
          key: node-role.kubernetes.io/infra
          value: reserved
          operator: Equal

Справочник по полям YAML (ClickHouse):

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

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

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

Объяснение полей:

• NAME: имя ресурса ModuleInfo
• CLUSTER: кластер, в котором установлен плагин
• MODULE: имя плагина
• DISPLAY_NAME: отображаемое имя плагина
• STATUS: статус установки; Running означает успешную установку и работу
• TARGET_VERSION: версия, которую планируется установить
• CURRENT_VERSION: версия до установки
• NEW_VERSION: последняя доступная версия для установки

#Установка плагина Alauda Container Platform Log Collector

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

2. На вкладке Plugins нажмите кнопку действий справа от Alauda Container Platform Log Collector > Install.

3. Выберите Storage Cluster (где установлен Alauda Container Platform Log Storage) и нажмите Select/Deselect для выбора типов логов, которые нужно собирать в кластере.

4. Нажмите Install.

#Установка плагина Alauda Container Platform Log Collector через YAML

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

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

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

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

#2. Создание ModuleInfo

Создайте ресурс ModuleInfo для установки плагина без параметров конфигурации:

apiVersion: cluster.alauda.io/v1alpha1
kind: ModuleInfo
metadata:
  annotations:
    cpaas.io/display-name: logagent
    cpaas.io/module-name: '{"en": "Alauda Container Platform Log Collector", "zh": "Alauda Container Platform Log Collector"}'
  labels:
    cpaas.io/cluster-name: go
    cpaas.io/module-name: logagent
    cpaas.io/module-type: plugin
    cpaas.io/product: Platform-Center
    logcenter.plugins.cpaas.io/cluster: go
  name: <cluster>-log-agent
spec:
  config:
    crossClusterDependency:
      logcenter: go
      logclickhouse: null
    dataSource:
      audit: true
      event: true
      kubernetes: true
      platform: false
      system: false
      workload: true
    storage:
      type: Elasticsearch
  version: v4.1.0
  valuesOverride:
    ait/chart-alauda-log-agent:
      global:
        nodeSelector:
          node-role.kubernetes.io/infra: "true"
        tolerations:
        - effect: NoSchedule
          key: node-role.kubernetes.io/infra
          value: reserved
          operator: Equal

Справочник по полям YAML (Log Collector):

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

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

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