@blueking/open-telemetry 0.0.31 → 0.0.33

package/skills/bk-rum-otele/references/views-routing.md

@@ -13,7 +13,7 @@ View 表示一次可独立分析的页面体验。初始文档加载、SPA 路
 | `bf_cache` | 从 Back/Forward Cache 恢复 | `view` |
 | `session_renewal` | Session 过期后新 Session 接管当前页面 | `view` |
 
-每个 View 都生成新的 `view.id`。View 的 URL、路由模板和自定义属性作为运行时上下文挂到其间发生的普通 Span；名称只在业务显式命名后才带上。
+每个 View 都生成新的 `view.id`。View 的 URL、路由模板、名称和自定义属性作为运行时上下文挂到其间发生的普通 Span。
 
 ## 自动路由模式
 
@@ -56,7 +56,7 @@ bkOT.startView({
 
 默认 `view.url_template` 取 URL pathname 并把数字 ID、UUID、长十六进制段折叠为 `:id`。请求和静态资源 Span 的 `url.template` 复用同一套折叠规则，但走独立的 `tracking.request.getUrlTemplate`。静态资源先通过 `redactUrl` 脱敏，再生成模板。
 
-`view.name` 与 `view.url_template` 是两个不同维度：前者是业务给出的可读标签（「订单详情」），后者是路由模板（`/orders/:id`）。**只有显式调用 `startView({ name })` 或 `setViewName()` 时才会上报 `view.name`**，未命名的 View 不带该字段，后端展示时用 `view.name ?? view.url_template` 兜底即可。这样 `view.name` 的存在本身就表示"业务命名过"，也不会在每条 Span 上重复一份模板字符串。
+`view.name` 是视图名称，`view.url_template` 是路由模板（如 `/orders/:id`）。SDK 优先使用 `startView({ name })` 或 `setViewName()` 设置的名称；未显式设置时，`view.name` 默认取 `view.url_template`。
 
 ```ts
 tracking: {
@@ -78,7 +78,7 @@ tracking: {
 bkOT.setViewName('订单详情-只读');
 ```
 
-名称变化不会创建新 View，但会更新运行时上下文并发送 `browser.view` update。传入与当前相同名称时不发送更新。首次调用会让此后的 Span 开始带上 `view.name`。
+名称变化不会创建新 View，但会更新运行时上下文并发送 View update Span。传入与当前相同名称时不发送更新，此后的 Span 使用新名称。
 
 ## URL 与前序页面
 
@@ -92,7 +92,7 @@ bkOT.setViewName('订单详情-只读');
 
 ## View 生命周期 Span
 
-Span 名固定为 `browser.view`：
+Span 名使用 `view.name`：
 
 | phase | 触发 |
 | --- | --- |
@@ -144,6 +144,7 @@ Span 名固定为 `browser.view`：
 - 初始加载：只要能取得 `loadEventEnd`，即使前 100ms 没有其他活动，也可生成 Loading Time；最终取 `loadEventEnd` 与页面活动结束耗时的较大值。
 - SPA/BFCache/Session Renewal：只有观察到页面活动时才生成自动 Loading Time，取 View 开始到页面活动结束的耗时。
 - 页面在计算期间变为 hidden：取消自动计算，不上报不可靠结果。
+- **创建 View 时页面已经是 hidden：完全不启动自动计算**，之后回到前台也不会补算。后台标签页预加载、`target=_blank` 打开的页面因此常常没有 `view.loading_time`；这类场景需要 `setViewLoadingTime()` 手动确认。
 
 `view.loading_time_source=auto` 表示自动计算。