4. 混沌工程基线核验接口总体架构：系统分层、组件交互、数据流、接口分类

本章从平台工程视角出发，将混沌工程基线核验接口体系拆解为四层架构。每一层承载明确的职责边界，通过标准化的接口契约完成组件间交互，最终形成从配置下发到报告归档的完整数据闭环。理解这一架构是后续设计具体接口规范的前提。

4.1 系统分层架构

基线核验接口体系自上而下分为四层：编排层、执行层、观测层和存储层。每层内部包含若干核心组件，层与层之间通过 RESTful API 或 gRPC 进行解耦通信。

4.2 组件交互与数据流

一次完整的基线核验流程包含六个关键步骤，数据在四层组件之间按顺序流转。理解数据流有助于定位接口调用的时序依赖关系。

1. 配置下发：编排层从基线配置中心读取基线参数，通过配置类接口下发至执行层。
2. 环境准备：执行层沙箱管理器创建隔离环境，探针控制器部署观测探针。
3. 故障注入：故障注入代理根据实验场景执行注入操作，同时向观测层注册事件。
4. 数据采集：观测层指标采集器按预设频率拉取系统状态，日志聚合器收集运行时日志。
5. 基线比对：观测层将实时数据与基线配置中的预期阈值进行比对，生成偏差标记。
6. 报告归档：存储层接收比对结果，时序数据库保存指标快照，报告生成器产出核验报告。

4.3 接口分类体系

根据职责边界，基线核验接口划分为四大类：配置类、执行类、观测类、报告类。每一类接口对应架构中的特定层次，并遵循统一的命名与版本规范。

4.4 接口分类与架构映射总结

将四类接口映射回四层架构，可以清晰看到每一层对外暴露的接口集合。编排层是唯一同时调用配置类与执行类接口的层次；观测层作为数据枢纽，同时接收执行层的事件推送并向存储层写入报告数据。

• 编排层 — 对外暴露配置类接口（供平台前端/CLI 调用），对内调用执行类接口。
• 执行层 — 对外暴露执行类接口（供编排层调用），对内调用观测类接口完成数据采集。
• 观测层 — 对外暴露观测类接口（供执行层调用），对内调用报告类接口完成数据持久化。
• 存储层 — 对外暴露报告类接口（供观测层及外部审计系统调用）。