跳转至

更新日志

2026/08/28

RUM SDK 后续版本新增及优化：

  1. 支持在浏览器提供 User-Agent Client Hints 时，通过 platformVersion 区分 Windows 10 与 Windows 11，并确保首批 RUM 数据使用同一份系统版本信息； 不支持该能力、拒绝返回高熵值或查询超时时继续使用传统 User-Agent。 RUM 数据结构

2026/08/26

RUM SDK 3.3.11 新增及优化：

  1. 修复无界（Wujie）等微前端中 Session Replay 对跨 iframe JavaScript realm 元素的识别：由 iframe realm 创建并挂载到当前页面 open ShadowRoot 的原生 表单输入、DOM 变化和已开启的 Canvas 录制现在可以正常进入回放；表单元素的 value、checked、selectedIndex 属性赋值也可被记录。Canvas 命令采集模式 下，跨 realm Canvas 自动使用位图快照兜底。该能力不包含 iframe 内部文档或 closed Shadow DOM。 Session Replay 接入说明

RUM SDK 3.3.10 新增及优化：

  1. 自动 Action 支持开放 Shadow DOM 内的点击元素，包括由 iframe 的 JavaScript realm 创建后挂载到 ShadowRoot 的元素（例如无界微前端）。SDK 会按实际点击目标生成名称及带 Shadow 边界的定位信息，并避免将表格行、 卡片等容器的聚合文本误作 Action 名称；Closed Shadow DOM 仍受浏览器封装边界限制。 用户操作 Action

2026/08/25

RUM SDK 3.3.9 新增及优化：

  1. SPA route_change View 支持 Chrome Soft Navigation API。在浏览器原生支持时， 路由切换可新增 FCP、LCP、LCP 元素选择器以及 view_navigation_type；不支持 原生 API 时继续通过 Navigation API、History API 或 Hash 路由兼容逻辑创建 Route View，并保留 push、replace、traverse 导航类型，但不补充该次路由的 FCP/LCP。RUM 数据结构
  2. 修复页面持续更新期间 View 数据可能迟迟不上报的问题，确保待发送 View 被更新时 仍沿用原批次的上报截止时间，并按既有发送间隔上报最新数据。

2026/08/20

RUM SDK 3.3.8 新增及优化：

  1. WebSocket Resource 新增分段结束页面路径字段 resource_websocket_end_view_path；分段开始路径复用标准字段 view_path， 可在 Resource 查看器中按连接开始或结束页面筛选。 WebSocket 长连接采集

2026/08/11

RUM SDK 3.3.7 新增及优化：

  1. 新增可选的 WebGL/WebGL2 Session Replay 插件，支持 NPM 与 CDN 接入， 通过绘制驱动、受预算约束的像素快照记录游戏及可视化画面。WebGL 实现与 RUM 主包拆分，未使用 WebGL 的应用无需引入插件。 Canvas 录制使用手册
  2. 新增 allowTraceHeaderWithoutSession 配置。开启后，即使当前 RUM Session 未命中采样，仍可为命中 allowedTracingUrls 的 XHR 和 Fetch 请求注入 Trace Header；不会因此创建或强制启用 Session，也不会上报该未采样 Session 的 RUM 数据。Web 应用接入
  3. 优化 Canvas 2D 自动录制与 command capture，补充更多绘制 API 和状态； 修复局部或透明度变化漏采、异步帧乱序、缩放快照覆盖不完整及 reset 与 bitmap 分开发送造成的闪烁。多 Canvas 使用公平调度、变化探测和有界并发， 兼顾动态画面连贯度与页面性能。 Canvas 录制使用手册
  4. 优化大 DOM、动态 Shadow DOM 与样式表回放，大快照和突发 DOM 变更采用 分片、原子提交及基线恢复，减少节点移动被拆成“先删除后添加”引发的页面 抖动，以及大元素或 CSS 样式缺失。 Session Replay 接入说明
  5. 增强压缩上传和 Session Replay 传输可靠性：压缩 Worker 异常时自动回退为 未压缩上传，避免 View、Action、Error、Resource 等 RUM 数据丢失；同时在 编码背压、网络重试和页面退出时保持 Replay 基线与后续分段顺序，减少不完整 或缺失的回放。
  6. 修复 Hash Router View URL 的查询参数解析，#/path?key=value 中的参数现在 会正确写入 View URL Query。 RUM 数据结构

升级提示：WebGL Replay 从 SDK 3.3.7 起提供，要求 RUM 主包版本 >= 3.3.7，并建议插件与主包使用同一 SDK 发布版本。插件仅在 Canvas auto 模式下工作，必须在 init() 时注册并早于 WebGL 引擎初始化；它不提供 GL 命令重放、逐帧视频或 OffscreenCanvas 录制。

Canvas 2D 未使用命名质量预设时，自动采集 interval/cooldown 的默认值由 1000/1000 ms 调整为 250/250 ms；low、medium、high 预设也采用 更快的 Canvas 2D 调度。动态画面会更连贯，但可能增加 CPU、编码和上传开销。 WebGL 未显式配置 interval/cooldown 时仍保留更保守的 GPU 读回节奏。

replayCanvasSampling 的正数用于选择 snapshot 路径，不代表采集频率；频率由 interval、cooldown 和 backoff 控制。replayCanvasQuality 的字符串预设会同时 调整质量、sampling 和调度预算，数值则只调整编码质量。

2026/07/29

RUM SDK 3.3.6 新增：

  1. React、Vue、Angular、Next.js 和 Nuxt 框架插件，支持基于路由模板采集 View， 并提供对应的框架错误入口。接入说明
  2. Next.js App Router、Pages Router 和 Nuxt 3/4 的客户端集成。 SSR 接入说明
  3. 实验性的原生 WebSocket 长连接采集，将连接统计汇总为 RUM Resource。 WebSocket 长连接采集
  4. startView() 支持通过 url 指定 View URL，供手动 View 与框架 Router 集成使用。自定义 View
  5. 新增 startSession()，支持立即结束当前 Session、重新执行会话采样，并可在 运行时覆盖 sessionSampleRate。采样与运行时 Session 控制

2026/06/30

RUM SDK 3.3.3 新增：

  1. 新增精简版 RUM SDK，支持 NPM 和 CDN 接入，保留 View、Resource、Long Task、 Error、Action、Context、自定义事件和链路追踪等常规 RUM 能力，不包含 Session Replay、Canvas 录制及 compressIntakeRequests 上报压缩。 精简版 RUM SDK 接入说明

2026/04/17

新增 Canvas SessionReplay录制。可参考 新增 Resource Hook 功能。可参考

2025/04/23

新增 remoteConfiguration，支持远程动态修改数据采集配置。

2025/04/13

  1. 新增 shouldMaskNode 配置，自定义屏蔽 session replay 节点效果
  2. 新增 sessionOnErrorSampleRate配置, 实现仅采集错误会话事件。可参考
  3. 新增 sessionReplayOnErrorSampleRate 配置。实现仅采集错误相关的 Session Replay 数据 可参考

2022/9/29

初始化参数新增 isIntakeUrl 配置，用于根据请求资源 URL 判断是否需要采集对应资源数据，默认都采集。

2022/3/10

  1. 新增 traceType 配置链路追踪工具类型，如果不配置，默认为ddtrace。目前支持 6 种数据类型：ddtrace、zipkin、skywalking_v3、jaeger、zipkin_single_header、w3c_traceparent。

  2. 新增 allowedTracingOrigins 允许注入 Trace 采集器所需 header 头部的所有请求列表。可以是请求的 origin，也可以是正则。

  3. 原配置项 allowedDDTracingOrigins 与新增配置项 allowedTracingOrigins 属于同一个功能配置。两者可以任取其一配置，如果两者都配置，则 allowedTracingOrigins 的权重高于allowedDDTracingOrigins。

2021/5/20

  1. 配合 V2 版本指标数据变更，需要升级 DataKit 1.1.7-rc0 之后的版本。更多详情，可参考 DataKit 配置。

  2. SDK 升级 V2 版本，CDN 地址变更为 https://static.guance.com/browser-sdk/v2/dataflux-rum.js。

  3. 删除 rum_web_page_performance、rum_web_resource_performance、js_error、page 指标数据收集，新增 view, action, long_task, error 指标数据采集。

  4. 初始化新增 trackInteractions 配置，用于开启 Action（用户行为数据）采集，默认为关闭状态。

文档评价

文档内容是否对您有帮助？