bug: Dashboard > Unique session/user IDs count shows Trace count
快速结论：在 Langfuse Dashboard 中，当创建新 Widget 并选择“Unique Session Ids”或“Unique User Ids”作为指标时，图表显示的计数错误地等同于 Trace 总数，而非去重后的 Session/User ID 数量。该问题源于查询构建器中的聚合逻辑错误，官方已确认为已知 Bug 并正在修复。
问题场景
用户在 Langfuse Cloud 或自托管版本的 Dashboard 中，创建新 Widget 并配置“Metric”为“Unique Session Ids”或“Unique User Ids”且操作类型为“Count”时，图表显示的数据与 Trace 总数一致，未能正确计算唯一 Session 或 User 的数量。预期行为是显示去重后的 Session ID 或 User ID 计数。
报错原文
Dashboard > Unique session/user IDs count shows Trace count.原因分析
该问题是一个已知的 Bug，已在 Issue #10405 中追踪。根源在于 web/src/features/query/server/queryBuilder.ts 文件中的查询构建逻辑。具体来说，代码在聚合 Unique Session ID 和 Unique User ID 时，错误地使用了 count(${metric.alias})，而不是直接使用 uniq(traces.user_id) 或 uniq(traces.session_id)，导致实际上计算的是所有 Trace 的总数，而非去重后的唯一值。官方维护团队已承认此问题，并正在开发补丁。
环境排查
- 确认 Langfuse 实例版本：该 Bug 在社区中被追踪，影响多个版本。建议升级到最新版本，查看是否已包含修复。如果使用 Langfuse Cloud，则无需自行排查环境版本，等待云平台自动更新。
- 对于自托管用户，需检查当前的 Langfuse 部署版本号。
- 确认 Dashboard 中创建 Widget 时的详细配置，“Metric”选择为“Unique Session Ids”或“Unique User Ids”，且操作类型为“Count”。
解决步骤
- 等待官方补丁：该 Bug 已被官方维护团队确认并标记为“known bug”。最佳方案是关注 Issue #12273 和关联的 Issue #10405，等待官方发布修复版本。
- 如果不属于自托管且急需修复（可优先尝试）：如果因特殊原因需要自行修补，可定位到
web/src/features/query/server/queryBuilder.ts文件，查找包含count(${metric.alias})的代码段，将其逻辑修改为类似uniq(traces.user_id)或uniq(traces.session_id)以进行正确的去重计数。此操作需要了解 Langfuse 的本地构建流程，且修改后应进行全面测试。请注意，此方案仅为推测，需谨慎评估。 - 临时规避方案：在官方修复前，对于需要统计 Unique 值的需求，可以考虑通过其他方式（如导出数据后自行计算）暂时替代，或等待 Dashboard 功能恢复正常。
验证方法
在 Dashboard 中创建一个新的 Widget，选择“Metric”为“Unique Session Ids”或“Unique User Ids”并设置操作为“Count”。如果图表显示的数字小于或等于该时间段内 Trace 的总数，并且你确认数据中包含重复的 Session ID 或 User ID，那么正确的计数应小于 Trace 总数。当图表显示的数量与 Trace 总数（即选择“Count”当 Metric 时的数量）不再完全一致时，即可确认问题已解决。
