rancher-logging Helm Chart 选项

启用/禁用 Windows 节点 Logging

要启用或禁用 Windows 节点 Logging，你可以在 values.yaml 中将 global.cattle.windows.enabled 设置为 true 或 false。

默认情况下，如果使用 Cluster Dashboard UI 在 Windows 集群上安装了 Logging 应用程序，Windows 节点的 Logging 就会启用。

在这种情况下，将 global.cattle.windows.enabled 设置为 false 会禁用集群上的 Windows 节点 Logging。 禁用后，仍会从 Windows 集群中的 Linux 节点收集日志。

rancher-logging Helm Chart 选项 - 图1备注

目前存在一个问题，在 Windows 集群中禁用 Windows Logging 后执行 helm upgrade 时不会删除 Windows nodeAgent。在这种情况下，如果已安装 Windows nodeAgents，用户可能需要手动卸载它们。

使用自定义 Docker 根目录

如果使用了自定义 Docker 根目录，你可以在 values.yaml 中设置 global.dockerRootDirectory。

这将确保创建的 Logging CR 使用你指定的路径，而不是使用默认的 Docker data-root 位置。

请注意，这只影响 Linux 节点。

如果集群中有任何 Windows 节点，则更改将不适用于这些节点。

为自定义污点添加 NodeSelector 设置和容忍度

你可以添加 nodeSelector 设置，并通过编辑 Logging Helm Chart 值来添加其他容忍度。有关详细信息，请参阅此页面。

启用 Logging 应用程序以使用 SELinux

rancher-logging Helm Chart 选项 - 图2要求：

Logging v2 已在 RHEL/CentOS 7 和 8 上使用 SELinux 进行了测试。

安全增强型 Linux (SELinux) 是对 Linux 的安全增强。被政府机构使用之后，SELinux 已成为行业标准，并在 CentOS 7 和 8 上默认启用。

要配合使用 Logging V2 与 SELinux，我们建议你根据此页面的安装说明安装 rancher-selinux RPM。

然后，在安装 Logging 应用程序时，在 values.yaml 中将 global.seLinux.enabled 更改为 true，使 Chart 支持 SELinux。

其他日志来源

默认情况下，Rancher 会收集所有类型集群的 controlplane 组件和节点组件的日志。

在某些情况下，Rancher 也能收集其他的日志。

下表总结了每种节点类型可以收集的其他日志来源：

日志来源Linux 节点（包括在 Windows 集群中）Windows 节点
RKE✓✓
RKE2✓
K3s✓
AKS✓
EKS✓
GKE✓

要将托管 Kubernetes 的提供商作为额外的日志来源，在安装或升级 Logging Helm Chart 时，请启用 Enable enhanced cloud provider logging 选项。

启用后，Rancher 会收集提供商开放可用的所有其他节点和 controlplane 日志，不同提供商可能有所不同。

如果你已经使用了云提供商的日志解决方案，例如 AWS CloudWatch 或 Google Cloud Operations Suite（以前称为 Stackdriver），由于原生解决方案可以不受限制地访问所有日志，因此你无需启用此选项。

Systemd 配置

在 Rancher Logging 中，你必须为 K3s 和 RKE2 Kubernetes 发行版配置 SystemdLogPath。

K3s 和 RKE2 Kubernetes 发行版将日志写入到 journald，它是 systemd 的子系统，用于日志记录。要收集这些日志，你需要定义 systemdLogPath。默认路径是 run/log/journal，但某些 Linux 发行版不默认使用该路径。例如，Ubuntu 默认使用 var/log/journal。要确定你的 systemdLogPath 配置，请参阅以下步骤。

Systemd 配置步骤：

  • 在其中一个节点上运行 cat /etc/systemd/journald.conf | grep -E ^\#?Storage | cut -d"=" -f2。
  • 如果返回 persistent，则你的 systemdLogPath 是 /var/log/journal。
  • 如果返回 volatile，则你的 systemdLogPath 是 /run/log/journal。
  • 如果返回 auto，则检查 /var/log/journal 是否存在。
    • 如果 /var/log/journal 存在，则使用 /var/log/journal。
    • 如果 /var/log/journal 不存在，则使用 /run/log/journal。

rancher-logging Helm Chart 选项 - 图3注意事项：

如果返回的值不包括在上述描述中，Rancher Logging 将无法收集 controlplane 日志。要解决此问题，你需要在每个 controlplane 节点上执行以下操作。

  • 在 journald.conf 中设置 Storage=volatile。
  • 重启主机。
  • 将 systemdLogPath 设置为 /run/log/journal。