内存里的 Trace 一旦随着进程退出而消失,就没法复盘过去的 Run。下面这张图把 Recorder、存储层和 SQLite 的关系拆开了:先由存储层处理序列化和写入,再分别保留运行、步骤与事件。
![图片[1]-小节五:把 Trace 持久化到 SQLite,保留重启后排查所需的证据-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1752.png)
持久化之后才能跨重启检索、回放和审计。这里也要记住前文的安全要求:敏感信息应在落盘前脱敏或截断,大体量内容按需要改存 Artifact 引用。
第 22 节我们已经有 SQLite。
现在 Trace 很自然应该持久化。
可以扩展:
steps
表。
例如:
CREATE TABLE IF NOT EXISTS trace_steps (
id INTEGER PRIMARY KEY AUTOINCREMENT,
event_id TEXT NOT NULL UNIQUE,
run_id TEXT NOT NULL,
step_no INTEGER NOT NULL,
sequence INTEGER NOT NULL,
event_type TEXT NOT NULL,
llm_call_id TEXT,
tool_call_id TEXT,
parent_event_id TEXT,
prompt_json TEXT,
llm_response_json TEXT,
tool_name TEXT,
tool_arguments_json TEXT,
tool_result_json TEXT,
latency_ms REAL NOT NULL,
input_tokens INTEGER NOT NULL,
output_tokens INTEGER NOT NULL,
status TEXT NOT NULL,
error TEXT,
created_at TEXT NOT NULL,
UNIQUE(run_id, sequence)
);
这里不能再写 UNIQUE(run_id, step_no):同一步可能有多个事件。event_id 负责全局唯一,run_id + sequence 负责稳定排序,调用 ID 和父事件 ID 负责关联。常用查询还应为 (run_id, sequence)、(run_id, llm_call_id) 和 (run_id, tool_call_id) 建索引。
为什么 JSON 放 TEXT?
教学阶段 SQLite 最简单。
用:
json.dumps(...)
存。
用:
json.loads(...)
读。
未来 PostgreSQL 可以升级:
JSONB
SQLite TraceStore 示例
这样服务重启以后:
Trace 还在。
这才是完整复盘基础。
审计事件不要用 INSERT OR REPLACE。重复 event_id 更可能意味着发送方重放或代码 Bug,应该通过唯一约束显式暴露;直接 Replace 会把旧证据覆盖掉。若采集链路需要幂等,可以按相同 event_id 返回“已接收”,但必须确认 payload digest 一致,不一致时要报警。
配套 SQLiteStore 使用版本化 Migration 为旧数据库增加 event ID、事件类型、sequence 和调用关联列,历史 payload 保持不丢失。新的 PersistentTraceRecorder 重启后会从数据库最后 sequence 接着写。当前实现仍是单机 SQLite 教学版;多 Worker 同时写一个 Run 时,还需要数据库序列、集中 Collector 或遥测后端解决全局顺序。
















请登录后查看评论内容