> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashduty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Web RUM 分析

> 本文档详细介绍 Flashduty RUM 分析看板的功能和使用方法

## 概述

Web RUM 分析看板按用户会话、性能、资源和错误汇总应用的真实用户数据，开箱即用。

分析看板主要包含以下四个分析维度：

> [card] 概览
>
> 关键指标一目了然

> [card] 性能分析
>
> 全面掌控应用体验

> [card] 异常分析
>
> 快速定位与诊断错误

> [card] 资源分析
>
> 精细化资源优化

除这四个内置分析维度外，分析看板页签栏里还可以放**自定义看板**：把查看器的聚合分析问题固化成自己的看板，见[自定义看板](https://docs.flashduty.com/zh/rum/analytics/custom-dashboards.md)。

## 概览

![RUM 分析看板概览](https://docs-cdn.flashcat.cloud/images/png/644c1920abde554209568685cda0ea78.png)

RUM 分析看板 - 概览

概览模块聚焦于应用多维度的核心指标：

| 指标类型 | 说明 |
| - | - |
| **流量指标** | 监控 PV（页面浏览量）、UV（独立访客数）、会话数，把握整体访问趋势 |
| **用户分布** | 结合地理位置、设备类型等信息，洞察用户来源与活跃区域 |
| **健康与性能指标** | 显示核心 Web 指标：LCP（最大内容绘制）、INP（交互到下一次绘制）、CLS（累积布局偏移） |
| **异常与错误** | 统计各类型错误率，快速发现潜在风险点 |

## 性能分析

![RUM 性能分析](https://docs-cdn.flashcat.cloud/images/png/4a996a5bf76addc6776ffb3865832a35.png)

RUM 分析看板 - 性能分析

性能分析模块专注于应用加载与交互体验的全链路监控：

* **页面性能**：监控 FCP、LCP、INP、CLS 等页面指标的趋势与样本分布
* **长任务**：主线程上执行超过 50 毫秒的任务。展示发生长任务的页面占比和长任务耗时（P75）
* **XHR 和 Fetch 请求**：分析接口的加载性能，定位慢接口
* **静态资源**：分析静态资源的加载耗时，定位应用加载时的性能瓶颈

> [!TIP]
>
> 有关显示数据的更多信息，请参阅 [数据收集](https://docs.flashduty.com/zh/rum/others/data-collection.md)。

## 异常分析

![RUM 异常分析](https://docs-cdn.flashcat.cloud/images/png/0f684c005cecff6e87d84aceb4ceb1ef.png)

RUM 分析看板 - 异常分析

异常分析模块提供全方位的错误监控与诊断能力：

* **页面错误率**：发生错误最多的页面，帮助您定位优先需要关注的页面
* **热门 Issue**：影响用户最多的 Issue 排行，详见 [异常聚合](https://docs.flashduty.com/zh/rum/error-tracking/error-aggregation.md)
* **代码错误**：分类展示错误类型，详见 [异常追踪](https://docs.flashduty.com/zh/rum/error-tracking/overview.md)
* **接口和资源错误**：监控哪些接口和静态资源产生的错误最多

## 资源分析

![RUM 资源分析](https://docs-cdn.flashcat.cloud/images/png/5b0bfbf8b4aec4418e26d0e158b8d80c.png)

RUM 分析看板 - 资源分析

资源分析模块帮助您识别对应用影响最大的资源：

* **资源排行**：监控加载最多与最重的资源，识别优化重点
* **资源加载时序**：监控资源耗时趋势（DNS 解析、TCP 连接、加载耗时等）
* **XHR 和 Fetch 请求**：区分不同请求类型、方法和错误状态码的分布趋势
* **第三方资源**：资源地址（host）与当前页面地址（host）不匹配的资源被识别为第三方资源

### 流量分布

流量分布模块帮助您分析自有资源与第三方资源的请求情况，识别外部依赖对应用性能的影响。

该模块包含以下三个部分：

| 部分 | 说明 |
| - | - |
| **资源列表** | 按域名（Host）聚合展示资源的请求数量、P90/P50 耗时、请求成功率和资源提供商类别（自有资源或第三方）。支持按域名正则筛选和按资源提供商类别筛选 |
| **耗时趋势** | 以折线图展示自有资源与第三方资源的 P90 耗时对比趋势，帮助您判断第三方资源是否拖慢了整体加载速度 |
| **流量占比** | 以饼图展示各第三方域名的请求量占比，直观了解流量在第三方服务间的分布情况 |

> [!TIP]
>
> 您可以在资源列表中点击全屏按钮查看更详细的数据，并通过排序功能快速定位耗时最长或请求量最大的域名。

## 常见问题

> [accordion] 为什么部分资源的大小或时序数据为 0？
>
> 可能有以下原因：
>
> 1. **连接复用 (Keep-Alive)**：当资源请求采用 keep-alive 方式保持连接时，DNS 查询和 TCP 连接过程只会在首次请求时发生，后续请求复用同一连接
>
> 2. **跨域加载资源**：如果资源以跨域方式加载且未配置相关头部信息，浏览器无法采集完整的性能数据（主要原因）
>
> 3. **浏览器兼容性**：极少数情况下，某些浏览器可能不支持 Performance API

> [accordion] 为什么部分资源的 resource\_status 为 0？
>
> 1. **跨域加载资源**：如果资源以跨域方式加载且未设置跨域访问权限，浏览器将无法获取资源状态信息
>
> 2. **浏览器兼容性**：某些浏览器可能不支持 Performance API（极少见）

> [accordion] 如何解决跨域资源的数据缺失？
>
> **1. 采集跨域资源的时序数据**
>
> 在跨域资源的 HTTP 响应头中添加：
>
> ```
> Timing-Allow-Origin: *
> ```
>
> 详见 MDN 文档 [Resource Timing API](https://developer.mozilla.org/zh-CN/docs/Web/API/Performance_API/Resource_timing#cross-origin_timing_information)。
>
> **2. 采集跨域资源的状态码**
>
> 在跨域资源的 HTTP 响应头中添加：
>
> ```
> Access-Control-Allow-Origin: *
> ```
>
> 在引用资源的 HTML 标签中添加 `crossorigin="anonymous"`：
>
> ```html theme={null}
> <img src="https://static.example.com/logo.png" crossorigin="anonymous" />
> ```
>
> 详见 MDN 文档 [Access-Control-Allow-Origin](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Headers/Access-Control-Allow-Origin) 和 [crossorigin 属性](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Reference/Attributes/crossorigin)。

> [accordion] 如何采集用户信息？
>
> **登录态用户识别**
>
> 对于需要用户登录的应用（如 SaaS 产品、会员系统、电商平台等），参考 [用户会话](https://docs.flashduty.com/zh/rum/sdk/web/advanced-config.md#用户会话)。
>
> **设备指纹识别**
>
> 对于无登录态的应用（如企业官网、营销页面等），使用您自己系统分配的访客 ID 上报用户标识。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.