Fluent Bit 中 Docker 日志收集在 cgroup v2 与 cgroupfs 驱动下的兼容性问题分析

问题背景

Fluent Bit 作为一款流行的日志收集工具，其 Docker 输入插件在特定环境下会出现无法收集容器日志的问题。当系统使用 cgroup v2 版本且 Docker 配置为 cgroupfs 驱动时，Fluent Bit 无法正常输出容器日志数据。而当切换为 systemd 驱动后，日志收集功能恢复正常。

技术细节分析

cgroup 驱动与版本的关系

现代 Linux 系统主要使用两种 cgroup 版本：

1. cgroup v1：传统版本，功能分散在多个子系统中
2. cgroup v2：统一层级结构，提供更一致的管理方式

Docker 支持两种 cgroup 驱动：

• systemd：与系统初始化系统集成
• cgroupfs：直接与 cgroup 文件系统交互

问题根源

通过分析 Fluent Bit 源代码发现，其 Docker 输入插件在处理容器指标时，对于 cgroup v2 和 cgroupfs 驱动的组合情况没有正确处理路径查找逻辑。具体表现为：

1. 在 cgroup v2 环境下，插件预期查找特定格式的路径结构
2. 当使用 cgroupfs 驱动时，实际路径结构与预期不符
3. 导致无法定位容器的资源使用统计文件
4. 最终结果是无法收集到容器的 CPU、内存等指标数据

解决方案

目前可行的临时解决方案是将 Docker 的 cgroup 驱动切换为 systemd：

1. 修改 Docker 配置文件
2. 重启 Docker 服务
3. 确认驱动变更生效

这种配置下，Fluent Bit 能够正确识别容器指标路径并收集日志数据。

深入技术探讨

cgroup 路径查找机制

Fluent Bit 通过以下方式查找容器指标：

1. 对于 cgroup v1 + systemd 驱动：查找特定 systemd 单元路径
2. 对于 cgroup v2 + systemd 驱动：查找统一层级路径
3. 对于 cgroupfs 驱动：直接访问 cgroup 文件系统

问题出在 cgroup v2 + cgroupfs 组合下，插件没有正确实现路径查找逻辑。

影响范围

该问题影响：

1. 使用较新 Linux 发行版的系统（默认启用 cgroup v2）
2. 显式配置使用 cgroupfs 驱动的 Docker 环境
3. Fluent Bit 3.x 版本

最佳实践建议

对于生产环境：

1. 推荐使用 systemd 作为 Docker 的 cgroup 驱动
2. 保持系统组件版本兼容性
3. 在部署前验证日志收集功能

对于开发者：

1. 关注 Fluent Bit 的版本更新
2. 考虑为 cgroup v2 + cgroupfs 组合提交补丁
3. 在容器编排环境中测试不同配置

总结

Fluent Bit 在 Docker 日志收集方面存在与 cgroup 配置相关的兼容性问题。理解底层机制有助于快速定位和解决问题。目前建议采用 systemd 驱动作为临时解决方案，同时期待官方在未来版本中完善对多种 cgroup 组合的支持。