feat: init

Author: Fiona2016

flashduty/zh/2. RUM/6. 查看器/1. 概览.md

@@ -0,0 +1,56 @@
+---
+title: "RUM 查看器功能概览"
+description: "掌握 Flashduty RUM 查看器的强大功能，通过可视化界面深入分析用户数据、性能指标和应用行为。"
+date: "2024-05-09T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/zh/flashduty/rum/rum-explorer"
+---
+
+## 概述
+
+Flashduty RUM **查看器**（RUM Explorer）是一款强大的数据分析工具，旨在帮助开发者深入检查从应用程序收集的数据，并获取关于 RUM 事件的详细信息。通过直观的可视化界面，您可以全面了解用户行为、应用性能和系统健康状况。
+
+## 核心功能
+
+1. **用户会话导航**：浏览和分析用户的完整会话路径，了解用户在应用中的行为模式。
+2. **性能问题调查**：深入分析影响页面视图、资源加载或用户操作的性能问题。
+3. **应用错误排查**：快速定位和诊断应用程序错误以及长时间运行的任务。
+4. **数据搜索过滤**：通过搜索栏和可视化类型选择，对 RUM 事件进行精确过滤和筛选。
+
+## 价值与优势
+
+1. **数据驱动决策**：基于真实用户数据做出产品优化和性能改进决策。
+2. **问题快速定位**：通过可视化界面快速识别性能瓶颈和用户体验问题。
+3. **用户行为洞察**：深入了解用户如何与您的应用交互，发现改进机会。
+4. **全面监控覆盖**：从页面加载到用户操作的全链路监控和分析。
+
+## 使用场景
+
+1. **性能优化**：分析页面加载时间、资源加载效率，识别性能瓶颈。
+2. **用户体验改进**：了解用户操作路径，发现交互设计中的问题。
+3. **错误排查**：快速定位应用错误发生的具体场景和上下文。
+4. **业务分析**：分析用户行为模式，为产品功能优化提供数据支持。
+
+## 主要功能详解
+
+### 1. 按应用查看
+
+使用顶部导航栏的应用选择器，可以选择特定应用程序并查看其所有 RUM 数据。通过应用选择器，您可以快速切换不同应用的数据视图，专注于特定应用的性能和用户行为分析。
+
+### 2. 搜索与过滤
+
+在 RUM 查看器中，您可以通过在搜索栏输入查询条件并选择可视化类型来搜索和过滤 RUM 事件。
+![2025-09-09-15-44-29](https://docs-cdn.flashcat.cloud/imges/png/bbe48a6dbfeb660ec86ba1e56d580ced.png)
+
+### 3. 查看详情
+
+点击数据项可查看数据详情，可将 RUM 事件以各种角度展示，帮助您发现关键信息。
+例如，您可以：
+
+- 查看数据关系，进行数据下钻或者查看数据父节点详情
+  ![2025-09-09-15-45-43](https://docs-cdn.flashcat.cloud/imges/png/4e22a5803c1fb290de7093c9ffab7dc6.png)
+- 通过查看资源的 trace，和已有的监控系统进行 trace 关联
+
+## 下一步
+
+- [数据查询指南](https://docs.flashcat.cloud/zh/flashduty/rum/xx)
+- [分布式追踪最佳实践](https://docs.flashcat.cloud/zh/flashduty/rum/xx)

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

@@ -0,0 +1,170 @@
+---
+title: "RUM 数据查询语法指南"
+description: "掌握 Flashduty RUM 查看器的搜索语法，通过灵活的查询条件快速定位和分析用户数据。"
+date: "2024-05-09T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/zh/flashduty/rum/session-explorer-data-query"
+---
+
+## 概述
+
+Flashduty RUM 查看器提供了强大的搜索功能，允许您通过灵活的查询语法快速定位和分析 RUM 数据。查询由**词项**和**操作符**组成，支持复杂的搜索条件组合，帮助您从海量数据中精准找到所需信息。
+
+## 查询基础
+
+### 词项类型
+
+查询支持两种类型的词项：
+
+1. **单词项**：单个词汇，如 `test` 或 `hello`
+2. **短语**：用双引号包围的词汇组，如 `"hello dolly"`
+
+### 布尔操作符
+
+您可以使用以下布尔操作符组合多个词项构建复杂查询：
+
+| 操作符 | 描述                                             | 示例                |
+| ------ | ------------------------------------------------ | ------------------- |
+| `AND`  | 交集：两个词项都必须在选定的视图中（默认操作符） | `error AND timeout` |
+| `OR`   | 并集：任一词项包含在选定的视图中                 | `error OR warning`  |
+| `-`    | 排除：后面的词项不在视图中                       | `error -timeout`    |
+
+## 搜索功能
+
+### 自动补全
+
+使用搜索栏的自动补全功能，可以快速完成查询并选择现有值。当您开始输入时，系统会显示匹配的建议选项，提高搜索效率。
+
+### 特殊字符转义
+
+搜索包含特殊字符的字段值时，需要使用转义或双引号。以下字符被视为特殊字符：`?`, `>`, `<`, `:`, `=`, `"`, `~`, `/`, `\`，需要用反斜杠 `\` 进行转义。
+
+对于视图字段名中的空格，也需要进行转义。例如，如果字段名为 `user.first name`，搜索时应转义空格：
+
+```
+@user.first\ name:myvalue
+```
+
+### 通配符搜索
+
+使用 `*` 符号进行多字符通配符搜索。例如：
+
+```
+@http.url:https:\/\/*
+```
+
+匹配所有以 `https://` 开头的 URL 视图。
+
+### 数值搜索
+
+使用比较操作符进行数值属性搜索：
+
+- `<`：小于
+- `>`：大于
+- `<=`：小于等于
+- `>=`：大于等于
+
+**示例**：检索错误数超过 5 的所有会话：
+
+```
+@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\/*
+```
+
+搜索所有在 `view.path` 属性中以 `/department/sofas/` 开头的视图。
+
+### 复合条件搜索
+
+```
+@view.loading_time:[1s TO 3s] @view.url_path:\/department\/sofas\/*
+```
+
+搜索加载时间在 1 到 3 秒之间，且 URL 路径以 `/department/sofas/` 开头的所有视图。
+
+### 错误分析搜索
+
+```
+@error.message:"TypeError" @view.url_path:/checkout/*
+```
+
+搜索结账页面中发生的 TypeError 错误。
+
+### 性能分析搜索
+
+```
+@view.loading_time:>5s @view.url_path:/product/*
+```
+
+搜索产品页面中加载时间超过 5 秒的视图。
+
+## 高级搜索技巧
+
+### 1. 时间范围搜索
+
+结合时间范围进行精确搜索：
+
+```
+@view.loading_time:>2s @timestamp:[2024-01-01 TO 2024-01-31]
+```
+
+### 2. 用户行为搜索
+
+```
+@action.type:click @view.url_path:/checkout/*
+```
+
+搜索结账页面的用户点击行为。
+
+### 3. 设备类型搜索
+
+```
+@device.type:mobile @view.loading_time:>3s
+```
+
+搜索移动设备上加载时间超过 3 秒的视图。
+
+### 4. 地理位置搜索
+
+```
+@geo.country:CN @error.count:>0
+```
+
+搜索中国地区发生错误的会话。
+
+## 最佳实践
+
+1. **使用引号包围短语**：确保多词短语的精确匹配
+2. **合理使用通配符**：避免过于宽泛的搜索条件
+3. **组合多个条件**：通过 AND/OR 操作符构建精确查询
+4. **保存常用搜索**：提高重复查询的效率
+5. **利用自动补全**：减少输入错误，提高搜索准确性
+
+## 下一步
+
+- [RUM 查看器概览](https://docs.flashcat.cloud/zh/flashduty/rum/rum-explorer)
+- [分布式追踪最佳实践](https://docs.flashcat.cloud/zh/flashduty/rum/distributed-tracing)
+- [性能监控分析](https://docs.flashcat.cloud/zh/flashduty/rum/performance-monitoring)