Pulse

Pulse 是 Observations 表格上方的一条紧凑图表带,用于快速发现事件量、花费或延迟方面的异常尖峰。选择某个尖峰即可将列表过滤到对应的时间窗口。

Pulse 依赖 Langfuse v4,仅显示在通用 observations 列表上方(不会在限定到某个用户或 session 时出现)。自托管实例需要先完成 v3 到 v4 的升级。

每根柱子代表什么

每根柱子代表一个时间桶(time bucket);柱高表达该桶内事件的单一汇总值。高柱标记着高流量、高花费或慢速窗口。柱子覆盖所选时间区间,无事件的桶显示为基线间隙。

纵轴采用平方根刻度,在保持正常负载可读的同时让异常值依然醒目。桶粒度根据时间跨度和显示宽度自动调整,最细 60 秒,最粗 7 天。悬停可查看桶的时间范围、指标值和事件数。如果记录缺少所选指标值,则显示为浅色刻度线而非完整柱子。

指标模式

左侧菜单可选择绘制的度量:

• Count(默认)——事件数量
• Cost——总花费
• Latency——速度,默认 p95,可从二级菜单切换为 p50

应用会记住你选择的指标和聚合设置。

导航到异常值

单击单根柱子可将列表限定到该桶。按住拖过多根柱子可创建自定义时间范围。可通过浏览器后退按钮恢复之前的区间。无事件的桶不触发导航。触摸屏会先显示预览浮层和"探索此窗口"操作,再执行范围变更。

应用的过滤条件

Pulse 反映列表当前的活动查询,继承时间区间、侧边栏 facet 和搜索控件。某些查询约束与基于时间的聚合不兼容;存在时 Pulse 带会被禁用。这些包括:

• 针对速度、花费或 token 数量的数值过滤器
• 基于评分、自定义元数据或备注的过滤器
• 文本搜索(通用或绑定到 input:、output: 等字段)
• 存在性操作符如 has: 和 -has:

下方列表仍会应用这些约束。

Pulse 与表格绘图的区别

Pulse 用于快速发现并跳转到异常活动。为任意表格绘图(Chart any table)则是将列表视图切换为同一查询的可配置可视化,支持图表类型、指标、聚合和分组选项;保存的视图可放到仪表盘上。