《Agent Runtime 工程化》第九章 可观测与 Trace：9.5 本地 trace JSON

书名：《Agent Runtime 工程化：从工具调用循环到可恢复执行系统》

作者：陈堂会

章节：第九章 可观测与 Trace / 9.5 本地 trace JSON

电子版系列：查看完整目录

第九章 可观测与 Trace：9.5 本地 trace JSON

入门阶段可先用本地 JSONL：

type TraceWriter = {
  startSpan(name: string, attrs?: Record<string, unknown>): Span;
  addEvent(span: Span, name: string, attrs?: Record<string, unknown>): void;
  endSpan(span: Span, status: "ok" | "error"): void;
};

每个 run 写入：

.agent/traces/run_123.json

后续再接 OpenTelemetry、LangSmith 或自建 UI。先把语义记对，再追求漂亮 dashboard。

---

系列导航

前 5 篇

• 第九章 可观测与 Trace：9.4 trace 与隐私