Trace 装配：事件→span 树→exporter 扇出

Trace 装配：事件→span 树→exporter 扇出 由 Archify 生成的数据流图。 01 / 事件源 02 / span 构建 03 / 导出接口 04 / 本地面 05 / 远端面 AgentEventPublisher · 12 类运行事件 · 01 / 事件源 AgentEventPublisher 12 类运行事件 AgentTraceListener · 事件→span 映射 · 02 / span 构建 AgentTraceListener 事件→span 映射 TraceSpan 树 · RUN>STEP>MODEL/TOOL · 03 / 导出接口 TraceSpan 树 RUN>STEP>MODEL/TOOL TraceExporter · SPI · Composite 扇出 · 04 / 本地面 TraceExporter SPI · Composite 扇出 本地导出 · Console/InMemory/Jsonl · 05 / 远端面 本地导出 Console/InMemory/Jsonl 远端导出 · Langfuse/OpenTelemetry · 05 / 远端面 远端导出 Langfuse/OpenTelemetry ① 事件订阅 AgentEvent ② 建 span TraceSpan ③ export(span) span ④ 本地 sink ⑤ 远端 sink 图例 主要数据 数据存储

span 谱系

  • • RUN 根 span > STEP > MODEL/TOOL，另有 HANDOFF 与 TEAM_TASK 两类协作 span
  • • 事件配对闭合 span：STEP_START↔STEP_END、TOOL_CALL↔TOOL_RESULT；TraceSpanStatus 记成败

导出实现谱系

  • • 本地：ConsoleTraceExporter 调试 · InMemoryTraceExporter 测试 · JsonlTraceExporter 落文件
  • • 远端：LangfuseTraceExporter · OpenTelemetryTraceExporter；CompositeTraceExporter 一扇多出

配置与脱敏

  • • TraceConfig 默认全量记录模型输入/输出与工具 args/output，无遮罩无截断
  • • TraceMasker 可脱敏；TracePricing/PricingResolver 按模型计价；TraceMetrics 汇总