@blueking/open-telemetry 0.0.32 → 0.0.33

package/README.md

@@ -47,7 +47,7 @@ ESM 构建把 OpenTelemetry 依赖保留为外部 package dependencies，由应
 无构建流程的页面可以用全局包，依赖已打进 bundle：
 
 ```html
-<script src="https://unpkg.com/@blueking/open-telemetry@0.0.29/dist/bk-rum.global.js"></script>
+<script src="https://unpkg.com/@blueking/open-telemetry@0.0.32/dist/bk-rum.global.js"></script>
 <script>
   window.rum = new window.BkOpenTelemetry({
     application: { name: 'legacy-portal', environment: 'production' },
@@ -64,19 +64,19 @@ CDN 入口只暴露 `window.BkOpenTelemetry` 这一个构造函数，不提供 `
 
 | 能力 | 默认 | 浏览器来源 | 主要产出 |
 | --- | --- | --- | --- |
-| Session | 基础能力 | localStorage、用户活动、visibility | `browser.session` start/rotate/end |
-| View / Router | auto | Navigation Timing、History、hash、BFCache | `browser.view` start/update/end |
+| Session | 基础能力 | localStorage、用户活动、visibility | `session.start` / `session.rotate` / `session.end` |
+| View / Router | auto | Navigation Timing、History、hash、BFCache | `<view.name>` start/update/end |
 | View Loading Time | 开 | 请求、DOM、资源、`window.open` activity | `view.loading_time` |
-| Fetch/XHR | 开 | fetch、XMLHttpRequest、Resource Timing | `browser.resource` CLIENT |
-| 静态资源 | 开 | Resource PerformanceObserver | `browser.resource` CLIENT |
+| Fetch/XHR | 开 | fetch、XMLHttpRequest、Resource Timing | `<METHOD> <url.template>` CLIENT |
+| 静态资源 | 开 | Resource PerformanceObserver | `GET <url.template>` CLIENT |
 | Error | 开 | error、unhandledrejection、资源加载错误 | 三类 Error Span + exception event |
 | Web Vitals | 开 | web-vitals / PerformanceObserver | CLS/FCP/INP/LCP/TTFB Span |
-| Action | 开 | 主键 click 与 activity | `action.click`、挫败信号 |
-| Blank Screen | 开 | 页面稳定 + DOM 九点采样 | `browser.blank_screen` |
+| Action | 开 | 主键 click 与 activity | `action.name`、挫败信号 |
+| Blank Screen | 开 | 页面稳定 + DOM 九点采样 | `blank_screen.<reason>` |
 | Device | 开 | UA/UA-CH、Screen、Network Information | Resource 与运行时属性 |
-| Long Task | 关 | Long Animation Frame / Long Tasks | `browser.long_task` |
-| WebSocket | 关 | WebSocket 生命周期 | connect/open/error/close Span |
-| CSP | 关 | securitypolicyviolation | `csp.violation` |
+| Long Task | 关 | Long Animation Frame / Long Tasks | `long_task.entry_type` |
+| WebSocket | 关 | WebSocket 生命周期 | `websocket.<phase>` |
+| CSP | 关 | securitypolicyviolation | `csp.<effective_directive>` |
 
 Session 和 View 是普通 Span 的必要关联边界，不能通过一个 `tracking.session: false` 关闭。精确默认值、降级行为和成本见[能力矩阵](./wikis/capabilities.md)。
 
@@ -183,7 +183,7 @@ session: {
 - 同一 Session 的决定一致，轮换后重新计算；
 - 未采样时 `startSpan()` 返回 non-recording Span，手动事件不导出；
 - 普通 Span 还必须有有效 `session.id` 与 `view.id`；
-- `browser.session` 是允许没有 View 的例外；
+- `span_type=session` 是允许没有 View 的例外；
 - SDK 自身 `/v1/rum` 请求、显式 discard 和 beforeSend 返回 false 的 Span 会被过滤。
 
 ## 手动事件
@@ -205,7 +205,7 @@ rum.reportCustomEvent({
 });
 ```
 
-- `reportAction()` 立即创建并结束 `action.<name>`（上例为 `action.submit-order`，`action.type=custom`），不是持续关联后续请求的自动 Action；
+- `reportAction()` 立即创建并结束 `<action.name>`（上例为 `submit-order`，`action.type=custom`），不是持续关联后续请求的自动 Action；
 - `reportCustomEvent()` 创建 `custom.<name>`；带 Error 时记录 exception 和 ERROR status；
 - name 是检索维度，必须有限枚举，不能拼用户/订单/随机 ID；
 - 两者都受当前 Session 采样约束。
@@ -313,14 +313,14 @@ OTLP 字段分五层：
 
 | Span | 领域字段 |
 | --- | --- |
-| `browser.session` | `session.phase`、`session.id`、`session.type`、`session.has_replay` |
-| `browser.view` | `view.phase`、`view.version`、`view.url` / `url_template` / `previous*`、`loading_type`、`loading_time` / `loading_time_source`、初始导航 timing、`view.end_reason` |
-| `browser.resource` | `url.full` / `url.template`、`http.request.method` / `response.status_code`、`resource.type` / `size` / `protocol` / `cache.hit`、DNS/TCP/TLS/首字节/下载阶段 |
+| `session.<phase>` | `session.phase`、`session.id`、`session.type`、`session.has_replay` |
+| `<view.name>` | `view.phase`、`view.version`、`view.url` / `url_template` / `previous*`、`loading_type`、`loading_time` / `loading_time_source`、初始导航 timing、`view.end_reason` |
+| `<method> <url.template>` | `url.full` / `url.template`、`http.request.method` / `response.status_code`、`resource.type` / `size` / `protocol` / `cache.hit`、DNS/TCP/TLS/首字节/下载阶段 |
 | Error Span | `error.message` / `source` / `handled`、`code.filepath` / `lineno` / `column`、`exception` Event |
-| `browser.web_vital` | `vital.metric` / `value` / `id`，以及 LCP/INP/TTFB 的部分 attribution |
-| `action.click` | `action.id` / `type` / `target.name` / `target.tag` / `frustration.type` |
-| `browser.blank_screen` | `blank_screen.reason` / `empty_ratio` / `empty_sample_count` |
-| `browser.long_task` | `long_task.id` / `entry_type` / `name`，LoAF 的 `blocking_duration` 等，加 script/attribution Event |
+| `<VITAL_METRIC>` | `vital.metric` / `value` / `id`，以及 LCP/INP/TTFB 的部分 attribution |
+| `click <target>` | `action.id` / `name` / `type` / `target.name` / `target.tag` / `frustration.type` |
+| `blank_screen.<reason>` | `blank_screen.reason` / `empty_ratio` / `empty_sample_count` |
+| `<long_task.entry_type>` | `long_task.id` / `entry_type` / `name`，LoAF 的 `blocking_duration` 等，加 script/attribution Event |
 
 持续时间统一用 Span 起止时间表达，没有 `action.loading_time`、`long_task.duration` 这类耗时 Attribute。完整层级见[RUM 数据模型](./wikis/concepts/data-model.md)，逐字段定义和「当前不会出现的字段」清单见[遥测字段字典](./wikis/reference/telemetry.md)。
 
@@ -358,6 +358,7 @@ await rum.flush();
 | 任务 | 文档 |
 | --- | --- |
 | 首次安装和验证 | [快速上手](./wikis/getting-started.md) |
+| 用 AI 安装 Skill 并生成配置 | [用 AI 接入](./wikis/ai-setup.md) |
 | 上线检查和容量/隐私/CORS | [生产接入指南](./wikis/production.md) |
 | 判断支持范围、默认开关和降级 | [能力矩阵](./wikis/capabilities.md) |
 | Vue/React/Router/SSR/微前端 | [框架与路由集成](./wikis/framework-integration.md) |