过滤搜索栏(Filter Search Bar)
过滤搜索栏让你能够通过输入单行文本,而非在侧边栏中组装过滤器,来过滤和搜索 Observations 和 Traces 表格。它将你的查询解析为与侧边栏产生的相同的过滤器,在你输入时自动补全字段和值,并将完整查询序列化到 URL 中,以便你可以用链接分享精确的视图。
level:ERROR type:TOOL environment:production latency:>2 name:*checkout*
过滤搜索栏运行在 Langfuse v4 数据模型上。在 Langfuse Cloud 上,在 Observations 或 Traces 表格上开启 Fast 以使用它。在自托管部署上,它在升级到 Langfuse v4后可用。
该栏运行在现有过滤侧边栏和时间范围选择器旁边。由于该栏和侧边栏是同一过滤状态上的两个编辑器,你输入的任何内容都会显示为侧边栏过滤器,反之亦然。输入字段名,自动补全会建议运算符和观察到的值;按 Enter 应用。
一旦你将表格缩小到你想要的行,你可以对同一查询绘图,而无需离开页面。
查询语法
查询是一个 field:value 过滤器列表,以隐式 AND 组合。
字段和值
level:ERROR、environment:production、user:alice。输入字段名,该栏会建议它为该字段观察到的值,因此你不必记住它们。
运算符
latency:>2、cost:>=0.01、startTime:>2026-06-01——>、>=、< 和 <= 适用于数值和日期时间字段。
通配符和精确匹配
在文本字段上,使用 * 作为通配符:
name:*checkout*——包含name:checkout*——以...开头name:*checkout——以...结尾name:checkout——裸词,默认为包含name:=checkout——精确匹配
否定
在过滤器前加 - 以排除:-environment:production。
任一匹配与全部匹配
level:(ERROR OR WARNING)——匹配一个字段的任一值tags:(billing AND urgent)——匹配所有值(数组字段)
元数据和分数
对嵌套字段使用点路径:
metadata.region:euscores.accuracy:>0.8scores.is_hallucination:falsescores.helpfulness:positive
scores.* 按名称匹配分数,无论其级别如何,因此单个命名空间涵盖 observation、trace、session 和实验级分数。分数过滤器支持数值、分类和布尔值。
对前缀后包含空格或特殊字符的键加引号:scores."Answer Relevance":>=0.9、metadata."my key":eu。
空值检查
has:endTime 匹配字段已设置的行;-has:endTime 匹配字段为空的行。
全文搜索
裸词或短语跨 id、名称、输入和输出搜索:
refund failed
用 input: 或 output: 将其限定到单个负载(例如 output:"refund failed")。匹配不区分大小写且基于词:一个词匹配整个词——error 匹配 error 但不匹配 errors——而多词词组作为连续短语匹配。该栏使用与全文搜索中记录的相同的 v4 ClickHouse 全文搜索。
字段别名
大多数字段接受短别名,以便你少打字。规范字段名也始终有效。
| 别名 | 字段 |
|---|---|
env |
environment |
user |
user id |
session |
session id |
model |
model name |
prompt |
prompt name |
cost |
total cost |
tokens |
total tokens |
tags |
trace tags |
status |
status message |
ttft |
time to first token |
tps |
tokens per second |
dataset |
experiment dataset |
experiment |
experiment name |
Ask AI
如果你还不知道项目的字段名,点击 Ask AI,用自然语言描述你想要的过滤器,该栏会为你构建查询,作为可编辑的标签。
Ask AI 处于测试阶段,仅在 Langfuse Cloud 上可用。它默认关闭;组织所有者或管理员在 Organization Settings → General → AI Features 中启用它。它运行在 AWS Bedrock 托管的模型上,零数据保留。参见数据隐私与安全。
Ask AI 是项目感知的:请求携带表格中已加载的列、值和元数据键的紧凑客户端快照,因此自然语言映射到你项目的真实 schema,而非通用猜测。例如,"membership-support 队列中的企业客户"会解析为你的 traces 实际使用的 metadata.* 键。
- 它是该栏旁边的一个按钮,始终可用。
- 栏为空时,它从头构建查询;有现有过滤器时,它根据你的请求细化它们(添加、更改或移除)。
- 它只能发出语法支持的过滤器,它发明的任何列都会在应用查询前被丢弃。
- 结果通过与侧边栏相同的路径应用,因此是无损的,你可以用浏览器后退按钮撤销。
分享和保存查询
完整查询被序列化到 URL 中,因此将链接发送给某人会重现精确的过滤视图。由于该栏编译为与侧边栏相同的过滤表示,你现有的 Saved Views 保持不变地继续工作。
保留 token
某些类运算符的 token 尚不支持,会被标记而非当作文本处理:!,以及小写词 and、or 和 not。使用 -field:value 排除,使用 field:(A OR B) 匹配一个字段的多个值。要将保留词作为字面文本搜索,请加引号("or")。
不完整的过滤器
没有值的裸字段名,例如单独的 type、level 或 env,尚不是完整表达式。该栏将其标记为无效,在你完成之前不会将其应用于查询,例如 type:TOOL。要将这些词之一作为字面文本搜索,请加引号("type")。