#Установка

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

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

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

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

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

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

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

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

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

#Установка 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

Справочник по полям 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

Справочник по полям 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

Справочник по полям 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