Skip to main content
RUM 查看器的查询由词项(terms)和操作符(operators)组成,可以组合出复杂的检索条件;不熟悉语法时也可以用自然语言查询。

AI 自然语言查询

不熟悉查询语法时,可以直接用自然语言(中英文均可)描述要找的数据,AI 会将其转换为标准查询语句(DQL),字段与语法与手动查询完全一致。点击查询框左侧的 AI 自然语言查询(魔法棒)图标进入,或在普通查询模式下按 ⌘ + Enter(Windows 和 Linux 为 Ctrl + Enter);进入后输入框边框会高亮。
1

描述查询意图

用自然语言描述您想查找的数据,按 Enter 生成预览。例如:
AI 会将其转换为:
您无需记住字段名,AI 会按当前事件类型选择可查询的字段。
2

查看变更预览

预览显示将要加入的 DQL 条件;当请求更适合其他事件类型(如提示「将切换事件类型为 错误」)或时间范围时,也会显示相应变更。结果不理想时,修改描述后再次回车即可重新生成。
3

应用或撤销

点击 应用、追加到查询 或 切换并应用 确认变更。应用后,提示消息中提供 撤销,可恢复应用前的查询、事件类型和时间范围。

追加而非替换

输入框中已有查询条件时,AI 生成的条件会追加到现有查询之后,不会覆盖,因此可以用自然语言逐步补充筛选条件;空查询时直接应用生成结果。
  • “最近 1 小时”“昨天”“过去 7 天”等时间表达会更新查看器的时间选择器,不会被写成 client_time 等 DQL 条件;性能时长条件仍属于 DQL,例如 view_loading_time:>2s。
  • 时间范围最长 14 天。请求的范围更长时,预览会提示已截取最近 14 天:相对时间范围改为过去 14 天,绝对时间范围保留请求的结束时间并向前取 14 天。
在 AI 输入框中用自然语言描述即可,直接输入查询语法(如 browser_name:Chrome)反而会降低转换准确率。需要精确控制条件时,请使用下方的查询语法。

查询基础

查询支持两种类型的词项:

布尔操作符

全文检索

全文检索仅部分字段支持,如未查询到结果,请转为字段查询。

转义特殊字符

检索包含特殊字符的字段值时,需要使用反斜杠 \ 转义或者双引号。
以下字符被视为特殊字符::, ", *, -, >, <, ,, (, ), [, ], \ 和空格

属性检索

使用 attribute:term 语法检索特定属性:

数值检索

对于数值类型的属性,可以使用比较操作符:

复杂检索示例

检索钱包页面中发生的 Warning 类型的错误:

微信小程序专属属性

针对微信小程序平台采集的 View 事件,除通用的 view_* 字段外,还支持以下可查询属性,便于排查小程序页面冷启动、setData 调用和生命周期阶段耗时: 例如,检索首屏渲染超过 2 秒的小程序页面:

会话属性检索

除上述示例中的字段外,会话(Session)还支持以下常用可查询属性,这些属性同样可用于列表列展示、CSV 导出和链接变量: 例如,检索由异常补采上传的会话:
异常补采的开关见应用管理中远程配置的 异常会话补采(sessionOnError)与 异常回放补采(sessionReplayOnError)。 其中 rc_version 对应应用管理中远程配置的发布版本,可按配置版本筛选会话,评估远程配置发布(rollout)的生效情况。

高级检索技巧

结合时间范围进行精确检索:
检索结账页面的用户点击行为:
检索移动设备上加载时间超过 3 秒的视图:
检索中国地区发生错误的会话:

最佳实践

  • 多词短语用双引号包围,确保精确匹配。
  • 谨慎使用通配符,避免条件过于宽泛。
  • 用 AND / OR 组合多个条件,构建精确查询。
  • 借助自动补全减少输入错误。
  • 保存常用检索条件,方便重复查询。

下一步

RUM 查看器概览

了解查看器核心功能

分布式追踪

了解分布式追踪最佳实践