Merge pull request #85 from flashcatcloud/rum-session-explorer@gyh

docs: explorer data query

Author: Fiona2016

flashduty/zh/2. RUM/6. 查看器/2. 数据查询.md

@@ -7,161 +7,139 @@ url: "https://docs.flashcat.cloud/zh/flashduty/rum/session-explorer-data-query"
 
 ## 概述
 
-Flashduty RUM 查看器提供了强大的搜索功能，允许您通过灵活的查询语法快速定位和分析 RUM 数据。查询由**词项**和**操作符**组成，支持复杂的搜索条件组合，帮助您从海量数据中精准找到所需信息。
-
-## 查询基础
-
-### 词项类型
+Flashduty RUM 查看器提供了强大的检索能力，允许您通过灵活的查询语法快速定位和分析 RUM 数据。查询由**词项** (terms) 和**操作符** (operators) 组成，支持复杂的搜索条件组合，帮助您从海量数据中精准找到所需信息。
 
 查询支持两种类型的词项：
 
-1. **单词项**：单个词汇，如 `test` 或 `hello`
-2. **短语**：用双引号包围的词汇组，如 `"hello dolly"`
-
-### 布尔操作符
+1. **单词项** (single term)：单个词汇，如 `test` 或 `hello`
+2. **短语** (sequence)：用双引号包围的词汇组，如 `"hello flashduty"`
 
 您可以使用以下布尔操作符组合多个词项构建复杂查询：
 
-| 操作符 | 描述                                             | 示例                |
-| ------ | ------------------------------------------------ | ------------------- |
-| `AND`  | 交集：两个词项都必须在选定的视图中（默认操作符） | `error AND timeout` |
-| `OR`   | 并集：任一词项包含在选定的视图中                 | `error OR warning`  |
-| `-`    | 排除：后面的词项不在视图中                       | `error -timeout`    |
-
-## 搜索功能
-
-### 自动补全
-
-使用搜索栏的自动补全功能，可以快速完成查询并选择现有值。当您开始输入时，系统会显示匹配的建议选项，提高搜索效率。
+| 操作符 | 描述                                                     | 示例                 |
+| ------ | -------------------------------------------------------- | -------------------- |
+| `AND`  | 交集：两个词项都必须在选定的视图中（默认操作符）         | `error AND timeout`  |
+| `OR`   | 并集：任一词项包含在选定的视图中，需要使用 `()` 包裹起来 | `(error OR warning)` |
+| `-`    | 排除：后面的词项不在视图中                               | `error -timeout`     |
 
-### 特殊字符转义
+## 全文检索
 
-搜索包含特殊字符的字段值时，需要使用转义或双引号。以下字符被视为特殊字符：`?`, `>`, `<`, `:`, `=`, `"`, `~`, `/`, `\`，需要用反斜杠 `\` 进行转义。
+:::highlight orange 💡 
+全文检索仅部分字段支持全文检索，如未查询到结果，请转为字段查询。
+:::
 
-对于视图字段名中的空格，也需要进行转义。例如，如果字段名为 `user.first name`，搜索时应转义空格：
+您可以通过全文检索来快速查询数据：
 
-```
-@user.first\ name:myvalue
-```
+| 查询语句      | 描述                            |
+| ------------- | ------------------------------- |
+| hello         | 精确匹配 `hello` 的字段         |
+| hello\*       | 匹配以 `hello` 开头的字段       |
+| \*hello       | 匹配以 `hello` 结尾的字段       |
+| \*hello\*     | 匹配含有 `hello` 的字段         |
+| "hello world" | 精确匹配 `"hello world"` 的字段 |
 
-### 通配符搜索
+## 转义特殊字符和空格
 
-使用 `*` 符号进行多字符通配符搜索。例如：
+检索包含特殊字符的字段值时，需要使用反斜杠 `\` 转义或者双引号。以下字符被视为特殊字符：`:`, `"`, `*`, `-`, `>`, `<`, `,`, `(`, `)`, `[`, `]`, `\` 和空格 (Space)。
 
-```
-@http.url:https:\/\/*
-```
+## 属性检索
 
-匹配所有以 `https://` 开头的 URL 视图。
+您可以使用 `attribute:term` 来检索特定属性：
 
-### 数值搜索
+| 查询语句                | 描述                             |
+| :---------------------- | -------------------------------- |
+| browser_name:Chrome     | 检索值为 `Chrome` 的浏览器       |
+| view_name:\*/detail     | 检索以 `/detail` 结尾的视图名称  |
+| -resource_status_code:0 | 检索状态码不为 `0` 的资源        |
+| os_name:"Mac OS X"      | 检索值为 `"Mac OS X"` 的系统名称 |
 
-使用比较操作符进行数值属性搜索：
+## 数值检索
 
-- `<`：小于
-- `>`：大于
-- `<=`：小于等于
-- `>=`：大于等于
+对于数值类型的属性，我们可以使用比较操作符 `>` `>=` `<` `<=` 检索：
 
-**示例**：检索错误数超过 5 的所有会话：
+| 查询语句                    | 描述                                   |
+| :-------------------------- | -------------------------------------- |
+| session_error_count:>5      | 检索错误数大于 `5` 的会话              |
+| view_time_spent:>=1.00min       | 检索停留时间大于 `1min` 的视图              |
+| session_view_count:[2 TO 8] | 检索视图访问量在 `2` 和 `8` 之间的会话 |
 
-```
-@session.error.count:>5
-```
-
-### 范围搜索
-
-使用方括号语法搜索数值属性的特定范围：
-
-```
-@session.error.count:[3 TO 10]
-```
-
-检索错误数在 3 到 10 之间的所有会话。
-
-## 搜索示例
-
-### 基础路径搜索
-
-```
-@view.url_path:"/department/sofas"
-```
+## 复杂检索
 
-搜索所有在 `@view.path` 属性中包含 `/department/sofas` 的视图。
+对于复杂的情况，我们可以任意组合条件进行检索。
 
-### 通配符路径搜索
+### 错误分析检索
 
 ```
-@view.url_path:\/department\/sofas\/*
+error_message:Warning\:* view_url_path:/wallet/*
 ```
 
-搜索所有在 `view.path` 属性中以 `/department/sofas/` 开头的视图。
+检索钱包页面中发生的 Warning 类型的错误。
 
-### 复合条件搜索
+### 性能分析检索
 
 ```
-@view.loading_time:[1s TO 3s] @view.url_path:\/department\/sofas\/*
+view_loading_time:>=5s view_url_path:/incident/detail/*
 ```
 
-搜索加载时间在 1 到 3 秒之间，且 URL 路径以 `/department/sofas/` 开头的所有视图。
+检索加载时间超过 5 秒，且 以 `/incident/detail/` 开头的视图。
 
-### 错误分析搜索
+### 错误请求分析
 
 ```
-@error.message:"TypeError" @view.url_path:/checkout/*
+-resource_status_code:200 resource_type:(fetch OR xhr)
 ```
 
-搜索结账页面中发生的 TypeError 错误。
+检索请求类型为 `fetch` 或者 `xhr`，且状态码不为 `200` 的资源。
 
-### 性能分析搜索
+### 页面行为分析
 
 ```
-@view.loading_time:>5s @view.url_path:/product/*
+view_url_path:/incident (view_action_count:>=2 OR view_error_count:>=3)
 ```
 
-搜索产品页面中加载时间超过 5 秒的视图。
+检索 URL 为 `/incident`，且操作数大于 `2` 或者错误数大于 `3` 的视图
 
-## 高级搜索技巧
+## 高级检索技巧
 
-### 1. 时间范围搜索
+### 1. 时间范围检索
 
-结合时间范围进行精确搜索：
+结合时间范围进行精确检索：
 
 ```
-@view.loading_time:>2s @timestamp:[2024-01-01 TO 2024-01-31]
+view_loading_time:>2s client_time:>1758253826081
 ```
 
-### 2. 用户行为搜索
+### 2. 用户行为检索
 
 ```
-@action.type:click @view.url_path:/checkout/*
+action_type:click view_url_path:/checkout/*
 ```
 
-搜索结账页面的用户点击行为。
+检索结账页面的用户点击行为。
 
-### 3. 设备类型搜索
+### 3. 设备类型检索
 
 ```
-@device.type:mobile @view.loading_time:>3s
+device_type:mobile view_loading_time:>3s
 ```
 
-搜索移动设备上加载时间超过 3 秒的视图。
+检索移动设备上加载时间超过 3 秒的视图。
 
-### 4. 地理位置搜索
+### 4. 地理位置检索
 
 ```
-@geo.country:CN @error.count:>0
+geo_country:China session_error_count:>0
 ```
 
-搜索中国地区发生错误的会话。
+检索中国地区发生错误的会话。
 
 ## 最佳实践
 
 1. **使用引号包围短语**：确保多词短语的精确匹配
-2. **合理使用通配符**：避免过于宽泛的搜索条件
+2. **合理使用通配符**：避免过于宽泛的检索条件
 3. **组合多个条件**：通过 AND/OR 操作符构建精确查询
-4. **保存常用搜索**：提高重复查询的效率
-5. **利用自动补全**：减少输入错误，提高搜索准确性
+4. **保存常用检索**：提高重复查询的效率
+5. **利用自动补全**：减少输入错误，提高检索准确性
 
 ## 下一步