安装

平台的日志系统由三个插件组成：Alauda Container Platform Log Essentials、Alauda Container Platform Log Collector 和 Alauda Container Platform Log Storage。本章将介绍这些插件的安装方法。

WARNING

global 集群可以查询平台内任意业务集群上存储的日志数据。请确保 global 集群能够访问业务集群的 11780 端口。
Alauda Container Platform Log Storage with Clickhouse 插件依赖 Clickhouse operator，安装该插件前，请确保集群中已上传 Clickhouse operator。

安装规划

INFO

日志的部分组件较为消耗资源。建议将其运行在 infra 节点上，并设置 nodeSelector 和 tolerations，以确保它们仅在这些节点上运行。如果您正在评估产品且尚未配置 infra 节点，可以移除这些设置，使组件在所有节点上运行。

有关规划 infra 节点的指导，请参见集群节点规划。

Alauda Container Platform Log Storage 插件可以安装在任意集群中，日志采集可以选择任意集群的日志存储组件来对接存储数据。

因此，在安装日志存储插件之前，您需要规划日志存储组件将要安装的集群和节点。

按范围分离日志存储。在 global 集群中部署日志存储，用于存储 global 集群自身的日志，使 global 集群独立采集、存储和查询自身日志。将业务集群的应用日志集中存储到专用的日志存储业务集群，而不是 global 集群，这样 global 集群故障不会影响基于日志的应用问题排查，应用日志负载也不会影响管理集群。
如果 global 集群部署了容灾，请勿将业务集群的日志发送到主 global 集群或备 global 集群。容灾仅同步 global 集群的 etcd 数据，并排除 cpaas-system 等命名空间，因此日志数据不会复制到备集群。每个 global 集群仅存储和查询自身的日志，切勿使用另一集群的日志存储；否则故障切换后应用日志将不可用。有关同步范围，请参见 Global 集群容灾。
优先将日志集中到单个日志存储集群。如果日志量超过最大容量阈值，再将日志分散到多个存储集群。
每个网络区域至少部署一个日志存储实例，以便本地聚合日志，尽量减少跨数据中心的公网流量（公网流量成本高、延迟大）。
为日志存储分配专用节点，避免与其他应用或平台组件混合部署。日志存储需要高 I/O 吞吐量，可能受到干扰影响。
为日志存储挂载专用 SSD 磁盘，以显著提升性能。

Alauda OS 节点上的主机路径

本章中的默认主机路径使用 /cpaas 前缀，这是传统操作系统的布局。Alauda OS 节点是不可变的：仅 /var/cpaas 可写，因此 /cpaas 下的路径在这些节点上无效。

在 Alauda OS 节点上安装日志存储插件时，请将主机路径字段中的 /cpaas 前缀替换为 /var/cpaas。主机路径在插件的 ModuleInfo 中设置；控制台安装表单不提供该字段。

插件	字段	Alauda OS 上的路径
Alauda Container Platform Log Storage with Clickhouse	`spec.config.components.clickhouse.hostpath`	`/var/cpaas/data/clickhouse`
Alauda Container Platform Log Storage with ElasticSearch	`spec.config.components.elasticsearch.hostpath`	`/var/cpaas/data/elasticsearch`

请为所选路径配备可在节点重新部署后仍然保留的持久磁盘，并根据计划的保留期限确定磁盘容量。请在安装前设置路径，因为主机路径之后无法更改。

通过控制台安装 Alauda Container Platform Log Essentials

进入 应用商店管理 > 集群插件，并选择 global 集群。
在插件页签中，单击 Alauda Container Platform Log Essentials 右侧的操作按钮 > 安装。
单击安装。

通过 YAML 安装 Alauda Container Platform Log Essentials

1. 检查可用版本

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


# 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 字段参考：

字段路径	说明
`metadata.labels.cpaas.io/cluster-name`	安装插件的目标集群名称。
`metadata.name`	临时 ModuleInfo 名称；平台将在创建后将其重命名。
`spec.version`	指定要安装的插件版本，必须与 ModuleConfig 中的 `.spec.version` 匹配。
`spec.valuesOverride.ait/chart-alauda-log-api.global.nodeSelector`	可选。日志组件的 nodeSelector。使用此参数为日志组件选择节点。此参数主要用于基础设施节点。
`spec.valuesOverride.ait/chart-alauda-log-api.global.tolerations`	可选。日志组件的 tolerations。如果 nodeSelector 选择了带污点的节点，使用此参数指定污点容忍的 key、value 和 effect。此参数主要用于基础设施节点。

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 with ElasticSearch

进入 应用商店管理 > 集群插件，并选择目标集群。
在插件页签中，单击 Alauda Container Platform Log Storage with ElasticSearch 右侧的操作按钮 > 安装。

请参考以下说明配置相关参数。

参数	说明
连接外部 Elasticsearch	保持关闭，以在平台内安装日志存储插件。
组件安装设置	LocalVolume：本地存储，日志数据将存储在所选节点的本地存储路径中。此方法的优点是日志组件直接绑定到本地存储，无需通过网络访问存储，从而提供更好的存储性能。 StorageClass：使用存储类动态创建存储资源来存储日志数据。此方法的优点是灵活性更高；当整个集群定义了多个存储类时，管理员可以根据使用场景为日志组件选择相应的存储类，降低主机故障对存储的影响。但是，StorageClass 的性能可能受到网络带宽和延迟等因素的影响，并且依赖存储后端提供的冗余机制来实现存储高可用。
保留期限	日志、事件和审计数据在集群上可保留的最长时间。超过保留期限的数据将被自动清理。提示：您可以备份需要长期保留的数据。如需帮助，请联系技术支持人员。

单击安装。

通过 YAML 安装 Alauda Container Platform Log Storage with ElasticSearch

1. 检查可用版本

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


# 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 # On Alauda OS nodes: /var/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 字段参考：

字段路径	说明
`metadata.labels.cpaas.io/cluster-name`	安装插件的目标集群名称。
`metadata.name`	临时 ModuleInfo 名称；平台将在创建后将其重命名。
`spec.config.clusterView.isPrivate`	集群视图的可见性设置。
`spec.config.components.elasticsearch.address`	外部 Elasticsearch 地址；留空以使用平台安装的 Elasticsearch。
`spec.config.components.elasticsearch.basicAuthSecretName`	外部 Elasticsearch 基本认证的 Secret 名称；使用平台 Elasticsearch 时留空。
`spec.config.components.elasticsearch.hostpath`	Elasticsearch 的数据路径。在 Alauda OS 节点上，请使用 `/var/cpaas` 下的路径，例如 `/var/cpaas/data/elasticsearch`。
`spec.config.components.elasticsearch.httpPort`	Elasticsearch HTTP 端口，默认为 9200。
`spec.config.components.elasticsearch.install`	是否通过平台安装 Elasticsearch；使用外部 Elasticsearch 时设置为 false。
`spec.config.components.elasticsearch.k8sNodes`	使用 LocalVolume 时 Elasticsearch Data 的节点 IP 列表。
`spec.config.components.elasticsearch.masterK8sNodes`	Elasticsearch 主节点的节点 IP 列表（仅适用于使用 LocalVolume 的大规模部署）。
`spec.config.components.elasticsearch.masterReplicas`	Elasticsearch 主节点的副本数量（仅适用于大规模部署）。
`spec.config.components.elasticsearch.masterResources`	Elasticsearch 主节点的资源请求/限制（仅适用于大规模部署）。
`spec.config.components.elasticsearch.masterStorageSize`	Elasticsearch 主节点的存储大小（仅适用于大规模部署）。
`spec.config.components.elasticsearch.nodeReplicas`	Elasticsearch Data 的副本数量。
`spec.config.components.elasticsearch.nodeStorageSize`	Elasticsearch Data 的存储大小（Gi）。
`spec.config.components.elasticsearch.resources`	Elasticsearch Data 的资源请求/限制。
`spec.config.components.elasticsearch.tcpPort`	Elasticsearch 集群的内部传输端口，默认为 9300。
`spec.config.components.elasticsearch.type`	Elasticsearch 集群规模：single/normal/big。
`spec.config.components.kafka.address`	外部 Kafka 地址；留空以使用平台安装的 Kafka。
`spec.config.components.kafka.auth`	启用 Kafka 认证，默认为 true。
`spec.config.components.kafka.basicAuthSecretName`	外部 Kafka 认证的 Secret 名称；使用平台 Kafka 时留空。
`spec.config.components.kafka.exporterPort`	Kafka Exporter 端口，默认为 9308。
`spec.config.components.kafka.install`	是否通过平台安装 Kafka；使用外部 Kafka 时设置为 false。
`spec.config.components.kafka.k8sNodes`	使用 LocalVolume 时 Kafka 的节点 IP 列表。
`spec.config.components.kafka.port`	Kafka 暴露端口，默认为 9092。
`spec.config.components.kafka.storageSize`	Kafka 存储大小（Gi）。
`spec.config.components.kafka.tls`	为 Kafka 启用 TLS，默认为 true。
`spec.config.components.kafka.zkElectPort`	Zookeeper 选举端口，默认为 3888。
`spec.config.components.kafka.zkExporterPort`	Zookeeper Exporter 端口，默认为 9141。
`spec.config.components.kafka.zkLeaderPort`	Zookeeper leader/follower 通信端口，默认为 2888。
`spec.config.components.kafka.zkPort`	Zookeeper 客户端端口，默认为 2181。
`spec.config.components.kibana.install`	是否安装 Kibana；Kibana 已弃用，请设置为 false。
`spec.config.components.storageClassConfig.name`	对于 LocalVolume，通常为 `elasticsearch-local-log-sc`；对于 StorageClass，设置为存储类名称。
`spec.config.components.storageClassConfig.type`	存储类型：LocalVolume/StorageClass。
`spec.config.components.zookeeper.storageSize`	Zookeeper 存储大小（Gi）。
`spec.config.ttl.audit`	审计数据的保留天数。
`spec.config.ttl.event`	事件数据的保留天数。
`spec.config.ttl.logKubernetes`	Kubernetes 日志的保留天数。
`spec.config.ttl.logPlatform`	平台日志的保留天数。
`spec.config.ttl.logSystem`	系统日志的保留天数。
`spec.config.ttl.logWorkload`	工作负载日志的保留天数。
`spec.version`	指定要安装的插件版本，必须与 ModuleConfig 中的 `.spec.version` 匹配。
`spec.valuesOverride.ait/chart-alauda-log-center.global.nodeSelector`	可选。日志组件的 nodeSelector。使用此参数为日志组件选择节点。此参数主要用于基础设施节点。
`spec.valuesOverride.ait/chart-alauda-log-center.global.tolerations`	可选。日志组件的 tolerations。如果 nodeSelector 选择了带污点的节点，使用此参数指定污点容忍的 key、value 和 effect。此参数主要用于基础设施节点。

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

进入 应用商店管理 > 集群插件，并选择目标集群。
在插件页签中，单击 Alauda Container Platform Log Storage with Clickhouse 右侧的操作按钮 > 安装。

请参考以下说明配置相关参数。

参数	说明
组件安装设置	LocalVolume：本地存储，日志数据将存储在所选节点的本地存储路径中。此方法的优点是日志组件直接绑定到本地存储，无需通过网络访问存储，从而提供更好的存储性能。 StorageClass：使用存储类动态创建存储资源来存储日志数据。此方法的优点是灵活性更高；当整个集群定义了多个存储类时，管理员可以根据使用场景为日志组件选择相应的存储类，降低主机故障对存储的影响。但是，StorageClass 的性能可能受到网络带宽和延迟等因素的影响，并且依赖存储后端提供的冗余机制来实现存储高可用。
保留期限	日志、事件和审计数据在集群上可保留的最长时间。超过保留期限的数据将被自动清理。提示：您可以备份需要长期保留的数据。如需帮助，请联系技术支持人员。

参数

说明

组件安装设置

LocalVolume：本地存储，日志数据将存储在所选节点的本地存储路径中。此方法的优点是日志组件直接绑定到本地存储，无需通过网络访问存储，从而提供更好的存储性能。
StorageClass：使用存储类动态创建存储资源来存储日志数据。此方法的优点是灵活性更高；当整个集群定义了多个存储类时，管理员可以根据使用场景为日志组件选择相应的存储类，降低主机故障对存储的影响。但是，StorageClass 的性能可能受到网络带宽和延迟等因素的影响，并且依赖存储后端提供的冗余机制来实现存储高可用。

保留期限

日志、事件和审计数据在集群上可保留的最长时间。超过保留期限的数据将被自动清理。
提示：您可以备份需要长期保留的数据。如需帮助，请联系技术支持人员。

单击安装。

通过 YAML 安装 Alauda Container Platform Log Storage with Clickhouse

1. 检查可用版本

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


# 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 # On Alauda OS nodes: /var/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）：

字段路径	说明
`metadata.name`	ModuleInfo 名称。推荐格式：`<target-cluster>-logclickhouse`。
`metadata.labels.cpaas.io/cluster-name`	安装插件的目标集群。
`metadata.labels.cpaas.io/module-name`	必须为 `logclickhouse`。
`metadata.labels.cpaas.io/module-type`	必须为 `plugin`。
`spec.version`	要安装的插件版本。
`spec.config.components.storageClassConfig.type`	ClickHouse 数据的存储类型：`LocalVolume` 或 `StorageClass`。
`spec.config.components.storageClassConfig.name`	类型为 `StorageClass` 时的 StorageClass 名称；类型为 `LocalVolume` 时保持为空。
`spec.config.components.clickhouse.resources`	ClickHouse 的资源请求/限制。
`spec.config.components.clickhouse.k8sNodes`	使用 `LocalVolume` 时 ClickHouse 的节点 IP 列表。
`spec.config.components.clickhouse.hostpath`	使用 `LocalVolume` 时 ClickHouse 数据的本地路径。在 Alauda OS 节点上，请使用 `/var/cpaas` 下的路径，例如 `/var/cpaas/data/clickhouse`。
`spec.config.components.clickhouse.nodeReplicas`	使用 `StorageClass` 时的副本数量。
`spec.config.components.clickhouse.nodeStorageSize`	ClickHouse 数据的存储大小（Gi）。
`spec.config.components.clickhouse.type`	集群规模：`single`、`normal` 或 `big`。
`spec.config.components.razor.resources`	Razor 的资源请求/限制。
`spec.config.components.vector.resources`	Vector 的资源请求/限制。
`spec.config.ttl.audit`	审计数据的保留天数。
`spec.config.ttl.event`	事件数据的保留天数。
`spec.config.ttl.logKubernetes`	Kubernetes 日志的保留天数。
`spec.config.ttl.logPlatform`	平台日志的保留天数。
`spec.config.ttl.logSystem`	系统日志的保留天数。
`spec.config.ttl.logWorkload`	工作负载日志的保留天数。
`spec.version`	指定要安装的插件版本，必须与 ModuleConfig 中的 `.spec.version` 匹配。
`spec.valuesOverride.ait/chart-alauda-log-clickhouse.global.nodeSelector`	可选。日志组件的 nodeSelector。使用此参数为日志组件选择节点。此参数主要用于基础设施节点。
`spec.valuesOverride.ait/chart-alauda-log-clickhouse.global.tolerations`	可选。日志组件的 tolerations。如果 nodeSelector 选择了带污点的节点，使用此参数指定污点容忍的 key、value 和 effect。此参数主要用于基础设施节点。

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 插件

进入 应用商店管理 > 集群插件，并选择目标集群。
在插件页签中，单击 Alauda Container Platform Log Collector 右侧的操作按钮 > 安装。
选择 存储集群（已安装 Alauda Container Platform Log Storage 的集群），然后单击 选择/取消选择 日志类型，以设置集群中的日志采集范围。
单击安装。

通过 YAML 安装 Alauda Container Platform Log Collector 插件

1. 检查可用版本

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


# 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）：

字段路径	说明
`metadata.annotations.cpaas.io/display-name`	插件显示名称。
`metadata.annotations.cpaas.io/module-name`	插件 i18n 名称 JSON 字符串。
`metadata.labels.cpaas.io/cluster-name`	安装插件的目标集群。
`metadata.labels.cpaas.io/module-name`	必须为 `logagent`。
`metadata.labels.cpaas.io/module-type`	必须为 `plugin`。
`metadata.labels.cpaas.io/product`	产品标识，通常为 `Platform-Center`。
`metadata.labels.logcenter.plugins.cpaas.io/cluster`	日志推送到的存储集群名称。
`metadata.name`	临时 ModuleInfo 名称；平台将在创建后将其重命名。
`spec.config.crossClusterDependency.logcenter`	基于 Elasticsearch 的日志存储集群名称。
`spec.config.crossClusterDependency.logclickhouse`	使用 Elasticsearch 存储时设置为 `null`；否则设置为 ClickHouse 集群名称。
`spec.config.dataSource.audit`	采集审计日志。
`spec.config.dataSource.event`	采集事件日志。
`spec.config.dataSource.kubernetes`	采集 Kubernetes 日志。
`spec.config.dataSource.platform`	采集平台日志。
`spec.config.dataSource.system`	采集系统日志。
`spec.config.dataSource.workload`	采集工作负载日志。
`spec.config.storage.type`	`Elasticsearch` 或 `Clickhouse`。
`spec.version`	要安装的插件版本。
`spec.valuesOverride.ait/chart-alauda-log-agent.global.nodeSelector`	可选。日志组件的 nodeSelector。使用此参数为日志组件选择节点。此参数主要用于基础设施节点。
`spec.valuesOverride.ait/chart-alauda-log-agent.global.tolerations`	可选。日志组件的 tolerations。如果 nodeSelector 选择了带污点的节点，使用此参数指定污点容忍的 key、value 和 effect。此参数主要用于基础设施节点。

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

#安装

#目录

#安装规划

#Alauda OS 节点上的主机路径

#通过控制台安装 Alauda Container Platform Log Essentials

#通过 YAML 安装 Alauda Container Platform Log Essentials

#1. 检查可用版本

#2. 创建 ModuleInfo

#3. 验证安装

#通过控制台安装 Alauda Container Platform Log Storage with ElasticSearch

#通过 YAML 安装 Alauda Container Platform Log Storage with ElasticSearch

#1. 检查可用版本

#2. 创建 ModuleInfo

#3. 验证安装

#通过控制台安装 Alauda Container Platform Log Storage with Clickhouse

#通过 YAML 安装 Alauda Container Platform Log Storage with Clickhouse

#1. 检查可用版本

#2. 创建 ModuleInfo

#3. 验证安装

#安装 Alauda Container Platform Log Collector 插件

#通过 YAML 安装 Alauda Container Platform Log Collector 插件

#1. 检查可用版本

#2. 创建 ModuleInfo

#3. 验证安装

安装

目录

安装规划

Alauda OS 节点上的主机路径

通过控制台安装 Alauda Container Platform Log Essentials

通过 YAML 安装 Alauda Container Platform Log Essentials

1. 检查可用版本

2. 创建 ModuleInfo

3. 验证安装

通过控制台安装 Alauda Container Platform Log Storage with ElasticSearch

通过 YAML 安装 Alauda Container Platform Log Storage with ElasticSearch

1. 检查可用版本

2. 创建 ModuleInfo

3. 验证安装

通过控制台安装 Alauda Container Platform Log Storage with Clickhouse

通过 YAML 安装 Alauda Container Platform Log Storage with Clickhouse

1. 检查可用版本

2. 创建 ModuleInfo

3. 验证安装

安装 Alauda Container Platform Log Collector 插件

通过 YAML 安装 Alauda Container Platform Log Collector 插件

1. 检查可用版本

2. 创建 ModuleInfo

3. 验证安装