bug:

该问题出现在 Langfuse Cloud 开启 V3 Preview(即 “Faster Langfuse experience” / 内部称 V4 Beta)后,通过 REST API /api/public/ingestion 写入的 trace 在右侧面板不显示 Latency pill 与

快速结论:该问题出现在 Langfuse Cloud 开启 V3 Preview(即 “Faster Langfuse experience” / 内部称 V4 Beta)后,通过 REST API /api/public/ingestion 写入的 trace 在右侧面板不显示 Latency pill 与 Tags。优先排查 Preview UI 开关状态,以及 payload 中 observation 的 endTime 是否已填充。

适用环境:Langfuse Cloud(自托管版本未填写),Ingest 方式为 REST API POST /api/public/ingestion;Issue 未提供 SDK、Python、CUDA 或显卡等信息。

最快修复方案:在 Tags 恢复前,关闭 “Faster Langfuse experience”(切回 Stable UI)作为临时规避;这是 Issue 讨论中明确给出的 workaround,并非根治。

注意事项:Tags 缺失是 V3 Preview 的事件适配层已知限制,且不只影响 REST API 摄入的 trace;Latency 缺失还与 observation 的 endTime 是否为空相关,需自行核对 payload,Issue 中未确认用户数据是否满足该条件。

问题场景

用户通过 REST API POST /api/public/ingestion 提交自定义 JSON 批量 payload 来补录历史 trace(用于 ElevenLabs 等 webhook 的“时间回溯”场景),在 trace-create 请求体中包含 startTime、endTime 和 tags 数组。开启 Preview UI 后,trace 详情右侧面板缺失 Latency 灰色 pill 与 Tags;中间 trace tree 中仍能看到总耗时。关闭 Preview UI 切回 Stable 后,两者均正常显示。

报错原文

bug: [UI Bug] V3 Preview "Faster Experience" drops Latency pill and Tags for traces ingested via REST API (Works perfectly in Stable)

原因分析

V4 Beta / Fast 模式与 Stable UI 的数据来源不同:Fast 模式从 events 表合成 trace,而 Stable 查询独立的 traces 表,两者复用同一套前端组件。

  • Tags 缺失:讨论中确认 eventsToTraceAdapter.ts 对所有 trace 硬编码了 tags: [],与摄入方式无关,因此该限制也影响通过 OTel SDK 摄入的 trace。
  • Latency 缺失:可能原因是对应 trace 的 observation 的 endTime 全部为 null,导致 latency 计算无法得到结果。该逻辑在适配层中存在,取决于 endTime 是否被正确写入。

环境排查

  • 确认使用的是 Langfuse Cloud,并记录 Preview(Faster Langfuse experience)开关状态。
  • 检查 /api/public/ingestion payload 中 trace-create 是否包含 startTime、endTime 与 tags。
  • 检查 trace 下各个 observation 是否带有非空的 endTime。
  • 对比同一 trace 在 Preview 开启与关闭两种状态下的右侧面板展示结果。

解决步骤

  1. 在 UI 中关闭 “Faster Langfuse experience”,切回 Stable UI,确认 Latency pill 与 Tags 是否恢复显示。
  2. 若 Latency 仍需在 Preview 下显示,可优先尝试核对并补齐 ingestion payload 中 observation 的 endTime 字段,因为 Issue 中 latency 计算依赖该值。
  3. Tags 在 Fast 模式下的支持需要等待 events-to-trace 适配层实现,Issue 中未给出可自行修复的配置项,不建议通过修改 payload 绕过。
  4. 持续关注该 Issue 后续状态,跟踪 Tags 支持是否落地。

验证方法

分别开启和关闭 “Faster Langfuse experience”,打开同一条通过 REST API 摄入的 trace:Stable 下 Latency pill 与 Tags 正常显示即说明问题由 Preview 模式引起;补齐 observation 的 endTime 后,若 Preview 下 Latency pill 出现,则说明 latency 缺失与 endTime 为空有关。Tags 在 Preview 下能否显示,则以适配层是否支持为准。

参考来源

langfuse/langfuse #12736

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 32346

发表回复

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