Couchbase Fluent Bit 镜像技术文档

镜像概述和主要用途

Couchbase Fluent Bit 镜像是由 Couchbase 提供的基于 Fluent Bit 的日志处理器镜像（镜像名称：couchbase/fluent-bit）。该镜像专为与 Couchbase Autonomous Operator 配合使用而设计，作为 sidecar 容器部署在每个 Couchbase Pod 中，用于读取 Couchbase 节点日志文件并将其转发到标准控制台输出，从而实现集群日志的集中收集与转发。

核心功能和特性

核心功能

• Sidecar 容器部署：可作为 sidecar 容器与 Couchbase Pod 协同部署，无需独立集群资源。
• 日志读取与转发：实时读取 Couchbase 节点的日志文件，并将日志内容转发至标准控制台输出（stdout），便于后续集成日志收集工具（如 Kubernetes 日志收集器）。

特性

• 轻量级设计：基于 Fluent Bit 构建，具备高效、低资源消耗的日志处理能力。
• 与 Autonomous Operator 集成：与 Couchbase Autonomous Operator 无缝配合，无需额外复杂配置即可启用日志转发功能。

使用场景和适用范围

使用场景

适用于在 Kubernetes 环境中部署 Couchbase 集群时，需集中收集、转发 Couchbase 节点日志的场景。典型场景包括：

• 集群日志集中监控与分析；
• 日志审计与合规性检查；
• 与第三方日志管理平台（如 ELK Stack、Grafana Loki 等）集成。

适用范围

• 软件依赖：仅可与 Couchbase Autonomous Operator Enterprise Edition 配合使用。
• 环境要求：Kubernetes 集群环境，且已部署 Couchbase Autonomous Operator。

使用方法和配置说明

前置条件

使用前需确保满足以下条件：

• 已部署 Couchbase Autonomous Operator Enterprise Edition；
• 参考文档获取系统要求及详细配置步骤：Couchbase 日志转发文档。

部署方式

该镜像需作为 sidecar 容器与 Couchbase Pod 协同部署，由 Couchbase Autonomous Operator 自动管理。典型部署流程如下：

1. 在 Couchbase 集群自定义资源（CR）中启用日志转发配置；
2. Operator 自动在每个 Couchbase Pod 中注入 couchbase/fluent-bit 容器作为 sidecar；
3. Sidecar 容器读取指定路径的 Couchbase 日志文件，并转发至标准输出。

配置说明

详细配置参数（如日志文件路径、转发格式等）需参考***文档。配置通常通过 Couchbase 集群 CR 的 spec.logForwarding 字段定义，或通过环境变量/配置文件传递给 Fluent Bit 容器（具体取决于 Operator 版本）。

许可信息

• 使用限制：couchbase/fluent-bit 镜像仅可与 Couchbase Autonomous Operator Enterprise Edition 一起使用。
• 许可详情：请参见 Couchbase ***协议页面 中的“License Agreement”。
• 使用权益：该镜像可免费用于无限预生产开发和测试，支持仅通过 Couchbase 论坛提供。