3. Fluent Bit 架构解析：Input、Parser、Filter、Output 插件链，版本漂移对插件兼容性的影响

Fluent Bit 采用轻量级的事件驱动架构，其核心数据处理流程由一条有序的插件链（Plugin Pipeline）构成。理解这条链上每个环节的职责与数据契约，是分析版本漂移对插件兼容性影响的前提。

3.1 插件链核心组件与数据流

一条标准的 Fluent Bit 管道包含四个关键阶段：Input（输入） → Parser（解析器） → Filter（过滤器） → Output（输出）。数据以 record（事件记录）的形式在插件间传递，每个阶段都可能对 record 进行创建、转换或丢弃。

3.2 各阶段插件职责与数据契约

每个插件阶段对数据有不同的操作方式和契约要求。下表总结了各阶段的核心职责、数据操作类型以及版本漂移的典型影响。

3.3 版本漂移对插件兼容性的具体影响

版本漂移（Version Drift）指 Fluent Bit 核心库与各插件版本不一致，或同一集群中不同节点运行不同版本。这种不一致会破坏插件链的隐式契约，具体表现为以下三类问题：

1. Record Schema 不兼容：新版本 Input 插件可能输出额外的元数据字段（如 @metadata），而旧版本 Filter 插件无法识别，导致字段被意外丢弃或引发类型断言错误。
2. API/ABI 变更：Fluent Bit 插件 SDK 的 C 接口函数签名或回调参数发生变化。例如，cb_process() 函数在 v1.9 中新增了 flb_time * 参数，旧版编译的插件加载后会导致段错误（Segfault）。
3. 配置语义漂移：同一配置项在不同版本中含义不同。例如，storage.type 在 v2.0 中默认值从 memory 变为 filesystem，导致 Output 插件的批量刷新行为发生改变。

3.4 插件链兼容性测试要点

针对版本漂移的准入控制测试，应围绕以下三个维度设计测试用例：

• 接口契约测试：验证不同版本插件之间传递的 Record 结构是否符合预期。使用 flb_event_loop 模拟数据流，检查字段类型、数量、嵌套层级。
• 加载兼容性测试：将旧版本编译的 .so 插件文件加载到新版本 Fluent Bit 进程中，验证 flb_plugin_load() 是否返回成功，并检查日志中是否有 ABI 版本不匹配的警告。
• 配置回退测试：使用旧版本配置文件启动新版本 Fluent Bit，验证配置项是否被正确解析或优雅降级。重点关注 parser、filter 和 output 段落的配置。

3.5 插件链版本兼容性矩阵

以下矩阵展示了不同 Fluent Bit 版本组合下，插件链的典型兼容性状态。该矩阵可作为准入控制测试用例设计的参考依据。