91 lines
2.4 KiB
Markdown
91 lines
2.4 KiB
Markdown
|
## MinimalTimerExporter 增量导出框架重构计划
|
|||
|
|
|
|||
|
|
### 目标
|
|||
|
|
将 `BuildEventTreeForFrame()` 改造为**流式增量处理模式**，支持大区间安全扫描，避免内存溢出。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 步骤 1: 重构 IEventWriter 接口
|
|||
|
|
|
|||
|
|
**目标**：增加分段感知能力
|
|||
|
|
|
|||
|
|
**变更**：
|
|||
|
|
```cpp
|
|||
|
|
// IEventWriter 新增方法
|
|||
|
|
virtual void BeginLogicalChunk(int32 ChunkIndex) = 0;
|
|||
|
|
virtual void EndLogicalChunk(int32 ChunkIndex) = 0;
|
|||
|
|
virtual void Flush() = 0;
|
|||
|
|
virtual bool WantsStructuredPath() const { return false; }
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**新增**：
|
|||
|
|
- `FStructuredEventData` 结构体，用于传递树形事件数据
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 步骤 2: 重构 BuildEventTreeForFrame
|
|||
|
|
|
|||
|
|
**目标**：增量流式处理，内部判断 flush 时机
|
|||
|
|
|
|||
|
|
**核心逻辑**：
|
|||
|
|
```cpp
|
|||
|
|
void BuildEventTreeForFrame(
|
|||
|
|
const Trace::ITimingProfilerProvider::Timeline& Timeline,
|
|||
|
|
const Trace::ITimingProfilerTimerReader* TimerReader,
|
|||
|
|
double StartTime,
|
|||
|
|
double EndTime,
|
|||
|
|
IEventWriter& Writer, // 改为接口依赖
|
|||
|
|
int32 EventsPerChunk = 10000) // 可配置的 flush 阈值
|
|||
|
|
{
|
|||
|
|
// 1. Writer.BeginLogicalChunk(0)
|
|||
|
|
// 2. 迭代 EnumerateEvents
|
|||
|
|
// 3. 内部维护 Stack 构建树
|
|||
|
|
// 4. 当处理事件数 >= EventsPerChunk 时：
|
|||
|
|
// - Writer.EndLogicalChunk(chunkIndex)
|
|||
|
|
// - Writer.Flush()
|
|||
|
|
// - 清空 Stack，chunkIndex++
|
|||
|
|
// - Writer.BeginLogicalChunk(chunkIndex)
|
|||
|
|
// 5. 结束时 Writer.EndLogicalChunk()
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 步骤 3: 重构 FJsonEventWriter
|
|||
|
|
|
|||
|
|
**适配新的 Writer 接口**：
|
|||
|
|
- 实现 `BeginLogicalChunk()` / `EndLogicalChunk()`
|
|||
|
|
- 支持 JSON 数组内的分段标记
|
|||
|
|
- 确保每个 chunk 都是自洽的 JSON
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 步骤 4: 保持 FCsvEventWriter 兼容
|
|||
|
|
|
|||
|
|
- 实现新的接口方法（空实现或基本转发）
|
|||
|
|
- 保持原有 CSV 格式兼容
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 步骤 5: 重构 RunExport
|
|||
|
|
|
|||
|
|
**目标**：统一调度入口
|
|||
|
|
|
|||
|
|
**变更**：
|
|||
|
|
- 引入 `ExportCoordinator` 类（如果需要）
|
|||
|
|
- 或者增强现有 `RunExport()` 函数
|
|||
|
|
- 支持传入 `WantsStructuredPath()` 判断
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 步骤 6: 清理与重构
|
|||
|
|
|
|||
|
|
**重命名建议**：
|
|||
|
|
- `BuildEventTreeForFrame` → `StreamEventsWithTreeBuilding`（更准确描述行为）
|
|||
|
|
- `FCsvEventWriter` → `CsvEventWriter`（去掉无意义的 F 前缀）
|
|||
|
|
- `FJsonEventWriter` → `JsonEventWriter`
|
|||
|
|
- `FExportChunker` → `ChunkingFileWriter`
|
|||
|
|
|
|||
|
|
**清理**：
|
|||
|
|
- 移除未使用的 `ExportMetadataToCSV`（功能重复）
|
|||
|
|
- 统一导出入口点
|