数据查询语法指南

Flashduty RUM 查看器提供了强大的检索能力，允许您通过灵活的查询语法快速定位和分析 RUM 数据。查询由词项（terms）和操作符（operators）组成，支持复杂的搜索条件组合。

查询基础

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

类型	说明	示例
单词项	单个词汇	`test`、`hello`
短语	用双引号包围的词汇组	`"hello flashduty"`

布尔操作符

操作符	描述	示例
`AND`	交集：两个词项都必须在选定的视图中（默认操作符）	`error AND timeout`
`OR`	并集：任一词项包含在选定的视图中，需要使用 `()` 包裹起来	`(error OR warning)`
`-`	排除：后面的词项不在视图中	`error -timeout`

AI 自然语言查询

如果你不想手写 DQL，可以让 AI 将自然语言请求转换为查询条件。在 RUM 查看器的查询框左侧点击 AI 自然语言查询 图标；也可以在普通查询模式下按 ⌘ + Enter（Windows 和 Linux 为 Ctrl + Enter）。

输入查询意图

用自然语言描述你想查看的数据，例如“Chrome 浏览器上的报错”“耗时超过 2 秒的资源请求”或“过去 24 小时的 checkout 页面”。按 Enter 生成预览。

查看变更预览

预览会显示将要加入的 DQL 条件；当请求更适合其他事件类型或时间范围时，也会显示事件类型或时间范围的变更。

应用或撤销

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

“最近 1 小时”“昨天”“过去 7 天”等时间表达会更新查看器的时间选择器，不会被写成 client_time 等 DQL 条件。性能时长条件仍然属于 DQL，例如 view_loading_time:>2s。

AI 自然语言查询的时间范围最长为 14 天。如果请求的范围更长，预览会提示已截取最近 14 天；应用后时间选择器会使用截取后的范围。相对时间范围会改为过去 14 天，绝对时间范围会保留请求的结束时间，并向前取 14 天。

全文检索

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

查询语句	描述
`hello`	精确匹配 `hello` 的字段
`hello*`	匹配以 `hello` 开头的字段
`*hello`	匹配以 `hello` 结尾的字段
`hello`	匹配含有 `hello` 的字段
`"hello world"`	精确匹配 `"hello world"` 的字段

转义特殊字符

检索包含特殊字符的字段值时，需要使用反斜杠 \ 转义或者双引号。

以下字符被视为特殊字符：:, ", *, -, >, <, ,, (, ), [, ], \ 和空格

属性检索

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

查询语句	描述
`browser_name:Chrome`	检索值为 `Chrome` 的浏览器
`view_name:*/detail`	检索以 `/detail` 结尾的视图名称
`-resource_status_code:0`	检索状态码不为 `0` 的资源
`os_name:"Mac OS X"`	检索值为 `"Mac OS X"` 的系统名称

数值检索

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

查询语句	描述
`session_error_count:>5`	检索错误数大于 `5` 的会话
`view_time_spent:>=1.00min`	检索停留时间大于 `1min` 的视图
`session_view_count:[2 TO 8]`	检索视图访问量在 `2` 和 `8` 之间的会话

复杂检索示例

错误分析
性能分析
错误请求
页面行为

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

error_message:Warning\:* view_url_path:/wallet/*

检索加载时间超过 5 秒，且以 /incident/detail/ 开头的视图：

view_loading_time:>=5s view_url_path:/incident/detail/*

检索请求类型为 fetch 或者 xhr，且状态码不为 200 的资源：

-resource_status_code:200 resource_type:(fetch OR xhr)

检索 URL 为 /incident，且操作数大于 2 或者错误数大于 3 的视图：

view_url_path:/incident (view_action_count:>=2 OR view_error_count:>=3)

微信小程序专属属性

针对微信小程序平台采集的 View 事件，除通用的 view_* 字段外，还支持以下可查询属性，便于排查小程序页面冷启动、setData 调用和生命周期阶段耗时：

属性	说明
`view_first_render`	首屏渲染耗时
`view_app_launch`	小程序启动耗时
`view_loading_time`	页面加载耗时
`view_setdata_count`	页面 `setData` 调用次数
`view_setdata_duration`	页面 `setData` 累计耗时
`view_onload_to_onshow`	`onLoad` 到 `onShow` 之间的耗时
`view_onshow_to_onready`	`onShow` 到 `onReady` 之间的耗时

例如，检索首屏渲染超过 2 秒的小程序页面：

source:miniprogram view_first_render:>2s

高级检索技巧

时间范围检索

结合时间范围进行精确检索：

view_loading_time:>2s client_time:>1758253826081

用户行为检索

检索结账页面的用户点击行为：

action_type:click view_url_path:/checkout/*

设备类型检索

检索移动设备上加载时间超过 3 秒的视图：

device_type:mobile view_loading_time:>3s

地理位置检索

检索中国地区发生错误的会话：

geo_country:China session_error_count:>0

最佳实践

使用引号包围短语

确保多词短语的精确匹配

合理使用通配符

避免过于宽泛的检索条件

组合多个条件

通过 AND/OR 操作符构建精确查询

利用自动补全

减少输入错误，提高检索准确性

保存常用检索条件，提高重复查询的效率。

下一步

RUM 查看器概览

了解查看器核心功能

分布式追踪

了解分布式追踪最佳实践

快速开始

分析看板

SDK 接入

性能监控

异常追踪

查看器

会话重放

最佳实践

其他

查询基础

布尔操作符

AI 自然语言查询

全文检索

转义特殊字符

属性检索

数值检索

复杂检索示例

微信小程序专属属性

高级检索技巧

最佳实践

使用引号包围短语

合理使用通配符

组合多个条件

利用自动补全

下一步

RUM 查看器概览

分布式追踪

​查询基础

​布尔操作符

​AI 自然语言查询

​全文检索

​转义特殊字符

​属性检索

​数值检索

​复杂检索示例

​微信小程序专属属性

​高级检索技巧

​最佳实践

使用引号包围短语

合理使用通配符

组合多个条件

利用自动补全

​下一步

RUM 查看器概览

分布式追踪

查询基础

布尔操作符

AI 自然语言查询

全文检索

转义特殊字符

属性检索

数值检索

复杂检索示例

微信小程序专属属性

高级检索技巧

最佳实践

下一步