#Установка

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

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

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

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

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

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

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

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

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

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

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

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

3. Следуйте приведенным ниже инструкциям, чтобы настроить соответствующие параметры.

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

4. Нажмите Install.

#Установка Alauda Container Platform Log Storage with 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 with Clickhouse через консоль

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

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

3. Следуйте приведенным ниже инструкциям, чтобы настроить соответствующие параметры.

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

4. Нажмите Install.

#Установка Alauda Container Platform Log Storage with 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