小节五:把 Trace 持久化到 SQLite,保留重启后排查所需的证据

内存里的 Trace 一旦随着进程退出而消失,就没法复盘过去的 Run。下面这张图把 Recorder、存储层和 SQLite 的关系拆开了:先由存储层处理序列化和写入,再分别保留运行、步骤与事件。

图片[1]-小节五:把 Trace 持久化到 SQLite,保留重启后排查所需的证据-大赛人网

持久化之后才能跨重启检索、回放和审计。这里也要记住前文的安全要求:敏感信息应在落盘前脱敏或截断,大体量内容按需要改存 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 或遥测后端解决全局顺序。

© 版权声明
THE END
喜欢就支持一下吧
点赞13 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容