自定义仪表盘(Custom Dashboards)
用 Langfuse 自定义仪表盘将你的 LLM 应用数据转化为可操作的洞察。 创建个性化视图,追踪对你团队最重要的指标——从延迟和成本优化到质量监控和用户行为分析。
自定义仪表盘提供灵活的自助分析解决方案,构建在强大的查询引擎之上,支持跨你的追踪数据的多级聚合。 无论你是在监控生产性能、分析用户反馈趋势,还是将成本与质量指标相关联,仪表盘都为你提供做出数据驱动决策的可视化工具。
在 Langfuse v4 上,某些仪表盘行为略有更新。完整参考参见 Langfuse v4 中的仪表盘变更。
关键能力
- 灵活的查询引擎:构建在 Langfuse 数据模型之上,支持跨 traces、observations、用户、sessions 和分数的复杂聚合
- 丰富的可视化选项:多种图表类型,包括折线图、柱状图和时间序列,带可自定义布局
- 高级过滤:按元数据、时间戳、用户属性、模型参数等过滤
- 多级聚合:在 trace、用户或 session 级别聚合数据,以回答复杂的分析问题
- 实时更新:仪表盘反映来自你 LLM 应用的实时数据
- 团队协作:在你的项目中共享仪表盘,实现统一的监控和洞察
- Langfuse 精选仪表盘:一组预构建的仪表盘,专注于延迟、成本和 Langfuse 用量,以便快速上手
快速开始
用两个简单步骤开始使用自定义仪表盘,或直接使用 Langfuse 的精选仪表盘。
利用精选仪表盘
用专注于常见 LLM 应用监控需求的 Langfuse 精选仪表盘快速启动你的分析:
- 延迟仪表盘:监控跨模型和用户细分的响应时间
- 成本仪表盘:随时间追踪 token 用量和相关成本
- 用量仪表盘:了解你的 Langfuse 平台利用率
这些预构建的仪表盘可以原样使用,或自由编辑。Langfuse 管理的仪表盘和小部件保留其所有编辑控件(拖动、调整大小、删除、添加和编辑)。你做的第一次更改会打开一个对话框,将仪表盘复制到你的项目并将你的更改应用于副本,因此你可以在不触碰原始版本的情况下自定义托管仪表盘。
主页仪表盘
你的项目 Home 页面是一个仪表盘。开箱即用时,它从 Langfuse 精选的默认值渲染:经典总览(traces、模型成本、延迟百分位、分数和模型用量),现在由常规小部件构建。每个项目选择在 Home 上显示哪个仪表盘:
- 在 Home 上,打开头部的仪表盘选择器,选择任意仪表盘以在那里预览它。该选择反映在 URL 中,因此你可以分享精确的视图。
- 点击 Set as default 使其成为项目的 Home。这会为项目中的每个人更改该页面,因此你在应用前确认。
由于 Home 是一个普通仪表盘,每个磁贴都是常规小部件。你可以将经典 Home 小部件(随时间的 traces、模型用量、延迟百分位、分数分析)放到任意自定义仪表盘上,或从头构建你自己的 Home。
管理和共享小部件
每个小部件都有一个 ⋯ 菜单,无论在仪表盘磁贴上还是在小部件库的其行上。从中你可以:
- Copy to clipboard 复制小部件,以便你可以将它粘贴到另一个仪表盘上。
- Paste to the right 从你的剪贴板将小部件插入到当前磁贴旁边。此项目在仪表盘可编辑时显示在仪表盘磁贴上,并且除非剪贴板持有 Langfuse 小部件,否则禁用。
- Duplicate 在当前项目中创建小部件的副本。
- Download as JSON 将小部件导出为可移植文件。
- Download data as CSV 导出小部件当前的查询结果。此项目显示在仪表盘磁贴上,并在小部件加载其数据后变为可用。
小部件库行菜单提供相同的 Copy to clipboard、Duplicate 和 Download as JSON 操作,外加 Delete。
复制和粘贴小部件
复制一个小部件,然后用 ⌘/Ctrl+V 将它粘贴到任意仪表盘上。该小部件被添加到仪表盘并滚动到视图中。仅当剪贴板持有 Langfuse 小部件时粘贴才有效:其他剪贴板内容保持不变,且粘贴需要对目标仪表盘的编辑权限。由于复制的小部件携带其完整配置,你可以跨仪表盘、项目和实例粘贴它。在目标视图中不适用的过滤器会被丢弃,Langfuse 会在发生时告诉你。
以 JSON 导入和导出
小部件和仪表盘使用版本化的 JSON 格式。小部件导出为 ,仪表盘导出为匹配的 信封,其中每个被引用小部件的配置内联,因此它不携带数据库 ID。这使小部件和仪表盘可跨项目和实例移植。
- 从小部件的 ⋯ 菜单用 Download as JSON 导出小部件。
- 通过将 Langfuse 小部件或仪表盘 JSON 文件拖到仪表盘上来导入。Langfuse 校验文件并在你的项目中重建小部件。仪表盘文件还会恢复其小部件布局。非 Langfuse 小部件或仪表盘导出的文件会被拒绝。
环境过滤器优先级
小部件可以携带自己的环境过滤器。当它携带时,该过滤器会覆盖仪表盘的环境选择器对该小部件的作用,且仅针对该环境。没有自己环境过滤器的小部件像往常一样遵循仪表盘的环境选择器,以及仪表盘过滤栏的其余部分。这使限定到特定环境的小部件即使当仪表盘选择器设置为不同的环境时也显示数据。
高级功能
高级过滤和分组
使用 Langfuse 强大的过滤能力创建精确的数据视图:
- 元数据过滤器:按附加到 traces 和 observations 的自定义元数据过滤
- 基于时间的过滤器:分析特定时间段或对比时间范围
- 用户属性:按用户特征和行为模式细分
- 模型参数:按特定模型配置或版本过滤
- 标签和标记:使用 trace 标签进行分类过滤
- 分数阈值:按质量分数范围或反馈评分过滤
图表类型和可视化
为你的数据选择合适的可视化:
- 折线图:非常适合随时间追踪趋势(延迟、成本、用量)
- 柱状图:跨类别对比值(模型、用户、功能)
- 时间序列:以时间粒度监控实时指标
- 饼图:显示分类数据的比例(例如反馈评分)
动态布局和响应性
- 拖放界面:轻松重新排列小部件以创建逻辑分组
- 响应式设计:仪表盘适应不同的屏幕尺寸和设备
- 小部件调整大小:用更大的可视化强调重要指标
- 网格系统:自动保持干净、有组织的布局
数据导出和集成
导出你的仪表盘数据以进行进一步分析或与外部工具集成。全面的导出选项(包括以下内容)参见导出数据指南:
- 仪表盘数据的 CSV 导出
- 与外部分析工具集成
- 通过 Metrics API 编程访问
通过 API、CLI 和 MCP 管理仪表盘
除了 UI 中的仪表盘编辑器,你还可以以编程方式创建和管理仪表盘、其磁贴布局和可复用的小部件:
- Public API:
/api/public/unstable下的端点涵盖仪表盘、布局和小部件。参见 dashboards 和 dashboard widgets API 参考。 - Langfuse CLI:CLI 自动识别这些端点,因此你可以将仪表盘定义保存在版本控制中,并跨项目和环境应用它们。
- MCP server:Langfuse MCP server 将相同的操作作为工具暴露,让 AI agent 在人工参与批准变更的情况下构建和编辑仪表盘。相同的工具为 UI 中的 Langfuse Assistant 提供支持。
这些端点和 MCP 工具不稳定,在仪表盘和小部件契约最终确定期间可能会变化。
用例和示例
生产监控仪表盘
实时监控你的 LLM 应用的健康和性能:
- 错误率追踪:监控失败的请求和错误模式
- 延迟分析:追踪跨不同端点的 P95 和 P99 响应时间
- 吞吐量监控:可视化请求量和容量利用率
- 模型性能:跨模型版本对比准确性和质量指标
- 工具用量与延迟:追踪每个外部工具(例如 API 调用、数据库查询)被调用的频率及其延迟
成本优化仪表盘
理解和优化你的 LLM 使用成本:
- Token 用量趋势:随时间追踪输入/输出 token 消耗
- 每用户成本:识别高用量用户并优化定价策略
- 模型成本对比:跨不同 LLM 提供商和模型对比成本
- 功能成本分析:理解哪些应用功能驱动了最高成本
质量和用户体验仪表盘
监控你的 LLM 应用的质量和用户满意度:
- 用户反馈趋势:追踪点赞/点踩评分和详细反馈
- 分数分布:随时间可视化质量分数的分布
- 用户行为分析:理解用户如何与不同功能交互
- A/B 测试结果:对比不同模型版本或提示词之间的质量指标