KubeSphere 日志系统

    有关更多信息，请参见日志查询。

    当您在 Linux 上安装 KubeSphere 时，首先需要创建一个配置文件，该文件列出了所有 KubeSphere 组件。

    1. 基于 的教程，您需要创建一个默认文件 。通过执行以下命令修改该文件：

      备注

      • 如果您采用 All-in-one 安装，则不需要创建 config-sample.yaml 文件，因为可以直接创建集群。一般来说，All-in-one 模式是为那些刚接触 KubeSphere 并希望熟悉系统的用户而准备的。如果您想在这个模式下启用日志系统（比如用于测试），请参考，查看如何在安装后启用日志系统。

      • 如果您采用多节点安装，并且使用符号链接作为 Docker 根目录，请确保所有节点遵循完全相同的符号链接。日志代理在守护进程集中部署到节点上。容器日志路径的任何差异都可能导致该节点的收集失败。

    2. 在该文件中，搜寻到 logging，并将 enabled 的 false 改为 true。完成后保存文件。

      1. logging:
      2.   enabled: true # 将“false”更改为“true”。
      3.   containerruntime: docker

      信息

      若使用 containerd 作为容器运行时，请将 containerruntime 字段的值更改为 containerd。如果您从低版本升级至 KubeSphere 3.2.0，则启用 KubeSphere 日志系统时必须在 logging 字段下手动添加 containerruntime 字段。

      备注

      默认情况下，如果启用了日志系统，KubeKey 将安装内置 Elasticsearch。对于生产环境，如果您想启用日志系统，强烈建议在 config-sample.yaml 中设置以下值，尤其是 externalElasticsearchUrl 和 externalElasticsearchPort。在安装前提供以下信息后，KubeKey 将直接对接您的外部 Elasticsearch，不再安装内置 Elasticsearch。

      1. es:  # Storage backend for logging, tracing, events and auditing.
      2.   elasticsearchMasterReplicas: 1   # The total number of master nodes. Even numbers are not allowed.
      3.   elasticsearchDataReplicas: 1     # The total number of data nodes.
      4.   elasticsearchMasterVolumeSize: 4Gi   # The volume size of Elasticsearch master nodes.
      5.   elasticsearchDataVolumeSize: 20Gi    # The volume size of Elasticsearch data nodes.
      6.   logMaxAge: 7                     # Log retention day in built-in Elasticsearch. It is 7 days by default.
      7.   externalElasticsearchUrl: # The URL of external Elasticsearch.
      8.   externalElasticsearchPort: # The port of external Elasticsearch.

    在 Kubernetes 上安装

    在 Kubernetes 上安装 KubeSphere 的教程中说明了在 Kubernetes 上安装 KubeSphere 的流程，不过，需要事先在 文件中启用日志系统（可选系统组件）。

    1. 下载 cluster-configuration.yaml 文件，然后打开并开始编辑。

    2. 在该本地 cluster-configuration.yaml 文件中，搜寻到 logging，并将 enabled 的 false 改为 true，以启用日志系统。完成后保存文件。

      1. logging:
      2.   enabled: true # 将“false”更改为“true”。
      3.   containerruntime: docker

      信息

      若使用 containerd 作为容器运行时，请将 .logging.containerruntime 字段的值更改为 containerd。如果您从低版本升级至 KubeSphere 3.2.0，则启用 KubeSphere 日志系统时必须在 logging 字段下手动添加 containerruntime 字段。

      备注

      默认情况下，如果启用了日志系统，ks-installer 将安装内置 Elasticsearch。对于生产环境，如果您想启用日志系统，强烈建议在 cluster-configuration.yaml 中设置以下值，尤其是 externalElasticsearchUrl 和 externalElasticsearchPort。在安装前提供以下信息后，ks-installer 将直接对接您的外部 Elasticsearch，不再安装内置 Elasticsearch。

      1. es:  # Storage backend for logging, tracing, events and auditing.
      2.   elasticsearchMasterReplicas: 1   # The total number of master nodes. Even numbers are not allowed.
      3.   elasticsearchDataReplicas: 1     # The total number of data nodes.
      4.   elasticsearchMasterVolumeSize: 4Gi   # The volume size of Elasticsearch master nodes.
      5.   elasticsearchDataVolumeSize: 20Gi    # The volume size of Elasticsearch data nodes.
      6.   logMaxAge: 7                     # Log retention day in built-in Elasticsearch. It is 7 days by default.
      7.   elkPrefix: logstash              # The string making up index names. The index name will be formatted as ks-<elk_prefix>-log.
      8.   externalElasticsearchUrl: # The URL of external Elasticsearch.
      9.   externalElasticsearchPort: # The port of external Elasticsearch.

    1. 以 admin 身份登录控制台。点击左上角的平台管理，选择集群管理。

    2. 点击 CRD，在搜索栏中输入 clusterconfiguration。点击结果查看其详细页面。

      信息

    3. 在自定义资源中，点击 ks-installer 右侧的 ，选择编辑 YAML。

    4. 在该 YAML 文件中，搜寻到 logging，将 enabled 的 false 改为 true。完成后，点击右下角的确定，保存配置。

      信息

      若使用 containerd 作为容器运行时，请将 .logging.containerruntime 字段的值更改为 containerd。如果您从低版本升级至 KubeSphere 3.2.0，则启用 KubeSphere 日志系统时必须在 logging 字段下手动添加 containerruntime 字段。

      备注

      默认情况下，如果启用了日志系统，将会安装内置 Elasticsearch。对于生产环境，如果您想启用日志系统，强烈建议在该 YAML 文件中设置以下值，尤其是 externalElasticsearchUrl 和 externalElasticsearchPort。在文件中提供以下信息后，KubeSphere 将直接对接您的外部 Elasticsearch，不再安装内置 Elasticsearch。

      1. es:  # Storage backend for logging, tracing, events and auditing.
      2.   elasticsearchMasterReplicas: 1   # The total number of master nodes. Even numbers are not allowed.
      3.   elasticsearchDataReplicas: 1     # The total number of data nodes.
      4.   elasticsearchMasterVolumeSize: 4Gi   # The volume size of Elasticsearch master nodes.
      5.   elasticsearchDataVolumeSize: 20Gi    # The volume size of Elasticsearch data nodes.
      6.   logMaxAge: 7                     # Log retention day in built-in Elasticsearch. It is 7 days by default.
      7.   elkPrefix: logstash              # The string making up index names. The index name will be formatted as ks-<elk_prefix>-log.
      8.   externalElasticsearchUrl: # The URL of external Elasticsearch.
      9.   externalElasticsearchPort: # The port of external Elasticsearch.

    5. 您可以使用 Web Kubectl 工具执行以下命令来检查安装过程：

      备注

      您可以通过点击控制台右下角的 KubeSphere 日志系统 - 图2 找到 Web Kubectl 工具。

    进入系统组件，检查日志标签页中的所有组件都处于健康状态。

    执行以下命令来检查容器组的状态：