数据查询语法指南

掌握 Flashduty RUM 查看器的搜索语法，通过灵活的查询条件快速定位和分析用户数据。

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

​

查询基础

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

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

​

布尔操作符

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

​

全文检索

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

查询语句	描述
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 查看器概览

了解查看器核心功能

分布式追踪

了解分布式追踪最佳实践