bug: Fast UI missing trace input/output and do not show trace id explicitly

该报错通常出现在 Langfuse Fast UI 查看旧 Trace 时,表现为输入/输出/元数据缺失,且顶部只显示 observation id 而非 trace id。优先排查是否使用了旧版 Python SDK(v3),并升级到最新 SDK 版本。

快速结论:该报错通常出现在 Langfuse Fast UI 查看旧 Trace 时,表现为输入/输出/元数据缺失,且顶部只显示 observation id 而非 trace id。优先排查是否使用了旧版 Python SDK(v3),并升级到最新 SDK 版本。

适用环境:Langfuse Cloud;Python SDK v3.10.5(Issue 中确认的版本);Fast UI(新版界面)。

最快修复方案:升级到最新版 SDK(建议迁移到 Python SDK v4)。官方在 Issue 中回复“This should now be fixed”,并提示获取 root observation 的输入输出需使用最新 SDK 版本。

注意事项:该修复方案来自官方维护者的回复,属于已确认的修复方向;但 Issue 关闭原因是“stale”(长期无活动),升级后如果问题仍然存在,需要新建 Issue 反馈。

问题场景

用户在使用 Langfuse 的 Fast UI(新版快速界面)查看 Trace 详情时发现两个问题:一是较早创建的 Trace 丢失了输入(input)、输出(output)和元数据(metadata);二是详情页顶部显示的 ID 实际上是打开该 Trace 时所用的 observation id,而非 trace id,导致用户查找特定 Trace 时需要额外点击“copy trace id button”才能获取真正的 Trace ID。用户进一步指出,当天创建的新 Trace 在 Fast UI 中能正确显示输入/输出(虽然被脱敏),但显示在一个孤立的根 span(root span)中,猜测这与仍在使用 Python SDK v3 有关。

报错原文

bug: Fast UI missing trace input/output and do not show trace id explicitly
- traces that were created a while back are missing the trace's input, output, and metadata.
- it only shows the observation id at the top, which appears to be the observation used to open the trace.
- recent traces ... show the correct input/output (obfuscated here) but within a lonely root span.
- Python SDK v3: 3.10.5

原因分析

可能原因有两个层面:

1. SDK 版本过旧:用户使用的是 Python SDK v3(3.10.5),官方在后续版本(v4)中对 root observation 的输入/输出数据记录方式进行了调整。旧版 SDK 可能没有正确上报根观测(root observation)的 IO 数据,导致 Fast UI 读取不到历史 Trace 的输入输出和元数据。

2. Fast UI 的 ID 展示逻辑:Fast UI 顶部展示的是当前打开面板所对应的 observation id,而不是 trace id,这是界面交互设计上的一个信息展示问题,官方在后续修复中可能调整了展示逻辑。

环境排查

  • 确认 Langfuse 环境:Langfuse Cloud(自托管需另查版本)。
  • 确认 Python SDK 版本是否为 v3.10.5 或更早的 v3.x。
  • 检查是否使用了最新版 SDK(v4 或更高),可查看 Langfuse v4 更新日志 确认版本要求。
  • 确认 Fast UI 开关是否启用(对比 Normal UI 和 Fast UI 的差异)。

解决步骤

  1. 升级 Python SDK:将现有 Python SDK v3(3.10.5)升级到最新版本。官方建议迁移到 v4,可优先尝试升级到 v4 并重新上报一条新 Trace 验证。
  2. 检查新上报的 Trace:升级后创建一条新 Trace,在 Fast UI 中确认输入/output 是否正常显示在根 span 上。
  3. 查看历史 Trace:如果升级后旧 Trace 仍然缺失输入/输出,可能需要重新导入或重新上报这些历史数据(旧数据本身可能缺少 root observation 的 IO 记录)。
  4. 确认 Trace ID 显示:如果 Fast UI 顶部仍显示 observation id,建议通过“copy trace id button”复制确认完整 Trace ID,同时关注后续 UI 更新是否修复该展示逻辑。

验证方法

升级 SDK 后,打开一条当天新建的 Trace,在 Fast UI 中确认:

  • 输入(input)、输出(output)和元数据(metadata)是否完整显示,而非空白。
  • 根 span 不再是“孤立”状态,能够显示完整的 IO 信息。
  • 顶部 ID 显示是否已改为 trace id,或至少能通过明确标识区分 observation id 和 trace id。

参考来源

langfuse/langfuse #12658

Langfuse v4 更新日志

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 21358

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注