@blueking/open-telemetry 0.0.30 → 0.0.32

package/skills/bk-rum-otele/references/session-context.md

@@ -39,7 +39,13 @@ SDK 使用以下固定规则：
 
 ## 跨 Tab 行为
 
-默认 storage key 根据 `application.name` 与解析后 Endpoint host 计算，多个同源 Tab 因而共享 Session Record。
+默认 storage key 按 `application.name` 与 **解析后 Endpoint 的 host** 计算：
+
+```text
+bk_ot_session__${hash36(application.name + "\0" + endpointHost)}
+```
+
+`hash36` 是 djb2 风格非密码学 hash，转成 36 进制。同一浏览器 origin 下，不同 `application.name` 或不同 Collector host 不会共用 Session。多个同源 Tab 默认共享同一 key 下的 Session Record。
 
 - 其他 Tab 只延长当前相同 Session 时，本 Tab 会更新自己的过期 Timer。
 - 其他 Tab 使 Session 过期或替换 ID 时，本 Tab 会停用自己的 Session。
@@ -75,22 +81,21 @@ new BkOpenTelemetry({
 
 Span 名固定为 `browser.session`：
 
-| `session.phase` | 使用时机 | 常见 reason |
+| `session.phase` | 使用时机 | 内部 lifecycle reason（不上报为 Attribute） |
 | --- | --- | --- |
 | `start` | 首次创建 | `init` |
 | `rotate` | 旧 Session 过期后新建 | `inactivity`、`maxLifetime` |
 | `end` | 当前 Session 失效 | `inactivity`、`maxLifetime`、`external` |
 
-关键字段：
+实际上报字段只有：
 
 - `session.id`
-- `session.start_time`
 - `session.type=user`
 - `session.has_replay=false`
-- `session.lifecycle.reason`
-- `session.previous_id`，仅存在前一个 ID 时出现
 - `session.phase`
 
+过期原因通过 `onSessionLifecycle` 通知插件，**不会**写成 `session.lifecycle.reason` 或 `session.start_time`。完整字段见[遥测字段字典](./telemetry-reference.md#session-字段)。
+
 生命周期 Span 是瞬时事件，持续时间由服务端根据时间戳推导。
 
 ## User 上下文
@@ -121,10 +126,9 @@ SDK 只维护 `user.id`，并原样透传：不 hash、不截断、不验证、
 | `user_agent.name` | UA 简单识别：Edge/Chrome/Firefox/Safari/Other | 否 |
 | `user_agent.version` | UA 主版本 | 未识别版本时 |
 | `user_agent.os.name` | UA / UA-CH platform | 否，无法识别为 `Other` |
-| `device.type` | UA-CH mobile 或移动 UA | 否 |
-| `device.memory_gib` | `navigator.deviceMemory` | 浏览器未实现时 |
+| `device.type` | UA-CH mobile 或移动 UA 特征 | 否，仅为 `mobile` 或 `desktop` |
 
-关闭 `tracking.device` 时，这些 Device Resource 字段不写入。
+关闭 `tracking.device` 时，这些 Device Resource 字段不写入。当前不读取 `navigator.deviceMemory`，因此没有 `device.memory_gib`。
 
 ## Device 运行时属性