@blueking/open-telemetry 0.0.15 → 0.0.16

package/README.md

@@ -1,42 +1,68 @@
 # @blueking/open-telemetry
 
-蓝鲸 Web RUM SDK。采集 View、Fetch/XHR、静态资源、错误、Web Vitals、用户操作、白屏、Long Task、WebSocket、CSP、设备和 Session，并通过 OTLP HTTP 上报。
+面向浏览器真实用户监控（RUM）的 OpenTelemetry SDK。它把 Session、View、Fetch/XHR、静态资源、错误、Web Vitals、用户操作、白屏、Long Task、WebSocket、CSP 和设备信息统一为 Trace、Metric、Log，并通过 OTLP HTTP 上报。
 
-## 安装
+## 快速接入
 
 ```bash
 npm install @blueking/open-telemetry
 ```
 
-## 最小接入
-
-```javascript
+```ts
 import { BkOpenTelemetry } from '@blueking/open-telemetry';
 
-const bkOT = new BkOpenTelemetry({
+export const bkOT = new BkOpenTelemetry({
   application: {
     name: 'order-center',
     environment: 'production',
     version: '1.2.0',
   },
   transport: {
-    endpoint: 'https://your-otlp-collector',
-    token: 'your-report-token',
+    endpoint: 'https://rum-collector.example.com',
+    token: 'report-token',
+  },
+  session: {
+    sampleRate: 0.2,
+  },
+  tracking: {
+    view: {
+      getPathGroup: url => new URL(url, location.href).pathname.replace(/\/orders\/[^/]+/, '/orders/:id'),
+    },
   },
 });
 ```
 
-`application.name` 和 `transport` 必填。使用根 `transport.endpoint` 时，SDK 自动生成：
+`application.name` 与 `transport` 必填。根 `transport.endpoint` 会生成三个上报地址：
+
+| 信号 | 默认地址 | 主要用途 |
+| --- | --- | --- |
+| Trace | `<endpoint>/v1/rum` | View、请求、资源、错误、性能、Action |
+| Metric | `<endpoint>/v1/metrics` | Web Vitals、View Loading、白屏、Long Task、WebSocket 聚合 |
+| Log | `<endpoint>/v1/logs` | Session 生命周期、View Snapshot、请求 Body、WebSocket 事件 |
+
+也可以为 `transport.signals.traces|metrics|logs.endpoint` 分别提供完整 URL，或把不需要的信号设为 `false`。至少要启用一种信号。
+
+## 默认能力
+
+只提供最小配置时，SDK 会自动启动并建立 Session 与 View。
 
-- traces：`/v1/rum`
-- metrics：`/v1/metrics`
-- logs：`/v1/logs`
+| 能力 | 默认 | 产出 |
+| --- | --- | --- |
+| Session / View | 开启且不可关闭 | `session.*` Log、`browser.view` Span/Log/Metric、运行时关联字段 |
+| Fetch / XHR | 开启 | `browser.resource` CLIENT Span，可选 `traceparent` 与 Body Log |
+| 静态资源 | 开启 | `browser.resource` Span、网络阶段属性 |
+| Error | 开启 | JS、Promise、资源加载错误 Span |
+| Web Vitals | 开启 | CLS/FCP/INP/LCP/TTFB Span 与 Metric |
+| Action | 开启 | 点击活动、耗时、关联计数和挫败信号 Span |
+| Blank Screen | 开启 | 白屏 Span 与 Counter |
+| Device | 开启 | 浏览器、OS、屏幕、网络运行时属性 |
+| Long Task / WebSocket / CSP | 关闭 | 按需通过 `tracking` 开启 |
 
-默认开启 Session、View、Fetch/XHR、静态资源、错误、Web Vitals、Action、白屏和设备采集。Long Task、WebSocket、CSP 默认关闭。
+完整的浏览器 API、默认值、配置入口和遥测产出见[能力矩阵](./wikis/capabilities.md)。
 
-## 推荐配置
+## 生产配置基线
 
-```javascript
+```ts
 const bkOT = new BkOpenTelemetry({
   application: {
     name: 'order-center',
@@ -44,205 +70,56 @@ const bkOT = new BkOpenTelemetry({
     version: '1.2.0',
   },
   transport: {
-    endpoint: 'https://your-otlp-collector',
-    token: 'your-report-token',
+    endpoint: 'https://rum-collector.example.com',
+    token: 'report-token',
     signals: {
       traces: {
         processor: 'batch',
-        batch: {
-          maxQueueSize: 2048,
-          maxExportBatchSize: 512,
-        },
-      },
-      metrics: {
-        intervalMillis: 60_000,
+        batch: { maxQueueSize: 2048, maxExportBatchSize: 512 },
       },
+      metrics: { intervalMillis: 60_000 },
     },
   },
-  session: {
-    sampleRate: 0.2,
-  },
+  session: { sampleRate: 0.2 },
   tracking: {
     view: {
-      getPathGroup: url => new URL(url, location.href).pathname.replace(/\/orders\/\d+/, '/orders/:id'),
-      excludedActivityUrls: [/\/events\/stream$/],
+      getPathGroup: url => new URL(url, location.href).pathname.replace(/\/orders\/[^/]+/, '/orders/:id'),
+      excludedActivityUrls: [/\/events\/stream(?:\?|$)/],
     },
     request: {
-      allowedTracingUrls: ['https://api.example.com'],
+      allowedTracingUrls: [url => new URL(url).origin === 'https://api.example.com'],
       excludedUrls: [/\/health(?:\?|$)/],
     },
-    longTask: { threshold: 50 },
-    websocket: true,
+    blankScreen: { rootSelector: '#app' },
   },
   context: {
     user: { id: window.USER_ID },
     attributes: {
       page: () => ({ 'biz.module': 'order' }),
-      custom: () => ({ 'biz.team': 'checkout' }),
-    },
-  },
-  privacy: {
-    redactAttributes: attributes => attributes,
-  },
-});
-```
-
-## 入口字段
-
-| 字段 | 作用 |
-| --- | --- |
-| `application` | 应用名、环境和版本；`name` 必填 |
-| `transport` | OTLP endpoint、鉴权头及每类 signal 配置；根 `endpoint` 与单信号 endpoint 至少提供一种 |
-| `session` | Session storage key 和确定性 `sampleRate` |
-| `tracking` | 内置采集能力、View 分组、请求过滤和全局 `beforeSend` |
-| `context` | 用户及 page/metric/error/custom 公共属性 |
-| `privacy` | Consent、URL 和属性脱敏 |
-| `extensions` | 自定义插件与原生 OpenTelemetry instrumentation |
-
-旧入口 `app`、`sampling`、`route`、`view`、`plugins`、`instrumentations`、`attributes`、`spanBatch` 不再支持。
-
-## 三类信号独立开关
-
-`traces`、`metrics`、`logs` 默认全部开启。设为 `false` 会关闭对应导出链路；关闭的信号不会创建 exporter、processor 或 metric reader。
-
-```javascript
-new BkOpenTelemetry({
-  application: { name: 'trace-only-app' },
-  transport: {
-    signals: {
-      traces: { endpoint: 'https://trace.example.com/v1/rum' },
-      metrics: false,
-      logs: false,
-    },
-  },
-});
-```
-
-根 `transport.endpoint` 可省略，但每个开启的信号必须配置独立 endpoint；三类信号不能全部关闭。关闭 Trace 后不会创建 Span，也不会注入 `traceparent`。
-
-## View 与 SPA
-
-自动模式会为初始加载、pathname/hash 路由、BFCache 和 Session 续期创建独立 View。query-only 和页内锚点变化不会创建新 View。
-
-```javascript
-const bkOT = new BkOpenTelemetry({
-  application: { name: 'manual-view-app' },
-  transport: { endpoint: 'https://your-otlp-collector' },
-  tracking: {
-    view: { tracking: 'manual' },
-  },
-});
-
-bkOT.startView({ name: '订单详情', url: location.href });
-bkOT.setViewName('订单详情-只读');
-bkOT.setViewLoadingTime();
-```
-
-每个 View 有一个覆盖生命周期的 `browser.view` span，并产生 create/update/final Snapshot log。初始 View 记录 TTFB、DOM Interactive、DOMContentLoaded、DOM Complete、Load Event；SPA View 独立计算 CLS session window 和 INP p98。
-
-## Metric 如何关联 View
-
-Metric datapoint 只携带低基数 `view.url_path_group`，不携带唯一 `view.id`，避免时序基数随 PV 无限增长。
-
-精确关联放在 View Snapshot、span 和 log：这些事件会携带 `session.id + view.id`，用户操作期间还会携带 `action.id`。需要从单个指标下钻到具体 View 时，应在后端使用 exemplar，或从原始事件派生聚合指标。
-
-## 请求与资源
-
-Fetch/XHR 由一套请求生命周期统一采集，不会重复 patch 或重复计数。Trace Header 只对 `allowedTracingUrls` 命中的 URL 注入，包括同源请求。
-
-```javascript
-new BkOpenTelemetry({
-  application: { name: 'request-demo' },
-  transport: { endpoint: 'https://your-otlp-collector' },
-  tracking: {
-    request: {
-      allowedTracingUrls: ['https://api.example.com'],
-      excludedUrls: [/\/health(?:\?|$)/],
-      beforeSend: (event, context) => {
-        event.attributes['request.transport'] = context.type;
-        return event.resource.statusCode !== 404;
-      },
-      body: {
-        capture: 'errors',
-        maxSize: 10 * 1024,
-        redact: ({ body }) => body.replace(/("(?:password|token)"\s*:\s*)"[^"]*"/g, '$1"***"'),
-      },
+      metric: () => ({ 'biz.app': 'order-center' }),
     },
   },
-});
-```
-
-静态资源与请求共用一个 Resource PerformanceObserver。静态资源生成独立 span；Fetch/XHR timing 会匹配回对应请求 span。SDK 自身 OTLP 请求始终排除。
-
-## 隐私与 Consent
-
-默认 URL 脱敏会移除用户名、密码、query 和 hash。Action 默认只读取显式属性及可访问名称，不读取任意 DOM 文本；设备 ID 默认不持久化。
-
-```javascript
-const bkOT = new BkOpenTelemetry({
-  application: { name: 'privacy-demo' },
-  transport: { endpoint: 'https://your-otlp-collector' },
   privacy: {
-    trackingConsent: 'not-granted',
-    redactUrl: url => new URL(url, location.href).origin,
-    redactAttributes: attributes => ({ ...attributes, token: undefined }),
-  },
-});
-
-await bkOT.setTrackingConsent('granted');
-await bkOT.setTrackingConsent('not-granted');
-```
-
-未授权时不创建 Session、不安装采集 patch。运行期可授权、撤回和再次授权。
-
-## 全局 beforeSend
-
-`tracking.beforeSend` 在 span/log 进入 exporter 前执行，可修改属性或返回 `false` 丢弃事件。
-
-```javascript
-new BkOpenTelemetry({
-  application: { name: 'filter-demo' },
-  transport: { endpoint: 'https://your-otlp-collector' },
-  tracking: {
-    beforeSend(event) {
-      delete event.attributes['debug.payload'];
-      return event.name !== 'custom.ignore-me';
+    redactAttributes(attributes) {
+      const next = { ...attributes };
+      delete next['biz.secret'];
+      return next;
     },
   },
 });
 ```
 
-请求专属 `tracking.request.beforeSend` 额外提供原始 Request/Response 或 XMLHttpRequest 上下文。
-
-## Session 与采样
+生产接入至少确认以下事项：
 
-`session.sampleRate` 范围为 `0 - 1`，默认 `1`。采样决定由 `application.name + session.id` 确定性计算，不写入额外 storage；同一 Session 内始终一致。
+1. `getPathGroup` 已把动态 ID 转成低基数路由模板。
+2. 跨域 Trace Header 白名单足够精确，服务端 CORS 已放行 `traceparent`。
+3. `user.id`、URL、错误和业务属性满足隐私要求；HTTP Body 默认保持关闭。
+4. SPA 的 `blankScreen.rootSelector` 指向真实挂载节点。
+5. 同一页面只运行一个实例，避免重复 patch Fetch/XHR/WebSocket。
 
-Session 固定为 15 分钟无活动过期、4 小时最长生命周期。storage key 默认按应用名和 endpoint 隔离。
+## 手动事件与 View
 
-## Action、设备和安全默认值
-
-```javascript
-new BkOpenTelemetry({
-  application: { name: 'interaction-demo' },
-  transport: { endpoint: 'https://your-otlp-collector' },
-  tracking: {
-    action: {
-      actionNameAttribute: 'data-bk-action-name',
-      nameCollection: 'explicit',
-    },
-    device: { persistentId: false },
-    blankScreen: { rootSelector: '#app' },
-    cspViolation: true,
-  },
-});
-```
-
-只有明确接受 DOM 文本采集风险时，才设置 `action.nameCollection: 'text'`。只有需要跨 Session 设备关联时，才设置 `device.persistentId: true`。
-
-## 手动事件
-
-```javascript
+```ts
 bkOT.setUser({ id: 'user-001' });
 
 bkOT.reportAction({
@@ -256,71 +133,33 @@ bkOT.reportCustomEvent({
 });
 ```
 
-## 扩展
-
-```javascript
-import { BkOpenTelemetry, createPlugin } from '@blueking/open-telemetry';
-
-const plugin = createPlugin({
-  name: 'demo-plugin',
-  init(context) {
-    const span = context.startSpan('demo.plugin_ready');
-    span.end();
-  },
-});
+手动 View 最稳妥的接入方式是在 SDK 启动并建立 Session 后创建：
 
+```ts
 const bkOT = new BkOpenTelemetry({
-  application: { name: 'extension-demo' },
+  application: { name: 'manual-view-app' },
   autoStart: false,
-  transport: { endpoint: 'https://your-otlp-collector' },
-  extensions: {
-    plugins: [plugin],
-    instrumentations: [],
-  },
+  transport: { endpoint: 'https://rum-collector.example.com' },
+  tracking: { view: { tracking: 'manual' } },
 });
 
 await bkOT.start();
-await bkOT.flush();
-await bkOT.shutdown();
+bkOT.startView({ name: '订单详情', url: location.href });
 ```
 
-也可在 `start()` 前调用 `use(plugin)` 或 `useInstrumentation(instrumentation)`。退出上报使用 OpenTelemetry 浏览器 exporter 的 `fetch keepalive`，并在 pagehide/hidden 时 flush。
+`reportAction()`、`reportCustomEvent()` 和 View 控制方法均受 Session 采样/有效状态约束。调试时先使用 `session.sampleRate: 1`。
 
-## 完整配置骨架
+## 文档导航
 
-```javascript
-new BkOpenTelemetry({
-  application: { name: 'demo-app', environment: 'production', version: '1.0.0' },
-  transport: {
-    endpoint: 'https://your-otlp-collector',
-    token: 'token',
-    headers: {},
-    signals: {
-      traces: { endpoint: 'https://trace.example.com/v1/rum', processor: 'batch', batch: {}, timeoutMillis: 10_000 },
-      metrics: { endpoint: 'https://metric.example.com/v1/metrics', intervalMillis: 60_000 }, // 或 false
-      logs: { endpoint: 'https://log.example.com/v1/logs' }, // 或 false
-    },
-  },
-  session: { sampleRate: 1, storageKey: 'optional-session-key' },
-  tracking: {
-    view: { tracking: 'auto', loadingTime: true, getPathGroup: url => new URL(url, location.href).pathname },
-    request: {},
-    resource: true,
-    error: true,
-    webVitals: true,
-    blankScreen: true,
-    device: true,
-    action: true,
-    longTask: false,
-    cspViolation: false,
-    websocket: false,
-    beforeSend: event => true,
-  },
-  context: { user: { id: 'user-001' }, attributes: {} },
-  privacy: { trackingConsent: 'granted' },
-  extensions: { plugins: [], instrumentations: [] },
-  autoStart: true,
-  enabled: true,
-  debug: false,
-});
-```
+| 目标 | 文档 |
+| --- | --- |
+| 首次接入 | [快速上手](./wikis/getting-started.md) |
+| 判断能采什么、默认是否开启、产出哪类信号 | [能力矩阵](./wikis/capabilities.md) |
+| 理解初始化、插件顺序、上下文、过滤和上报数据流 | [架构与数据流](./wikis/architecture.md) |
+| 查完整配置、默认值和约束 | [配置参考](./wikis/configuration.md) |
+| 查公开方法与导出符号 | [API 参考](./wikis/api.md) |
+| 查精确 Span / Metric / Log 名和字段 | [遥测参考](./wikis/telemetry-reference.md) |
+| 隐私、Consent 和低基数字段 | [隐私与公共属性](./wikis/privacy-attributes.md) |
+| 没有数据或数据异常 | [调试与排障](./wikis/troubleshooting.md) |
+
+完整 Wiki 入口见 [`wikis/`](./wikis/README.md)。文档以当前 `src/` 和 `src/index.ts` 公开导出为事实来源，不承诺历史配置兼容。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/open-telemetry",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "OpenTelemetry browser SDK for BK RUM",
   "author": "TencentCloud Real User Monitoring",
   "main": "dist/index.js",

package/skills/bk-rum-otele/SKILL.md

@@ -22,8 +22,11 @@ description: 帮助业务方在前端应用里接入、使用和配置蓝鲸 RUM
 | 用户想做的事                                                                                | 读取                                  |
 | ------------------------------------------------------------------------------------------- | ------------------------------------- |
 | 第一次接入、安装、最小示例、CDN、生产推荐配置                                               | `references/getting-started.md`       |
+| 评估 SDK 能力边界、默认开关、浏览器 API、信号产出和降级行为                               | `references/capabilities.md`          |
+| 理解源码模块、初始化顺序、运行时上下文、过滤链路和 Hook 时机                              | `references/architecture.md`          |
 | 搞懂三类信号、Instrumentation vs Plugin、采样、数据归一、运行时上下文                       | `references/concepts.md`              |
-| 查配置项、默认值、transport/endpoint、采样、批量上报、traceparent 透传                      | `references/configuration.md`         |
+| 查配置项、默认值、Endpoint、插件参数和 Hook                                                | `references/configuration.md`         |
+| 查 Transport、单信号开关、批量上报、Session 采样和 traceparent 透传                       | `references/transport-sampling.md`    |
 | 开关某个采集能力、看请求配置和各插件参数（request/error/blankScreen/longTask/websocket 等） | `references/plugins.md`               |
 | 写自定义插件、接入第三方 OpenTelemetry instrumentation                                      | `references/custom-plugin.md`         |
 | 查公开 API（start/flush/shutdown/setUser/setView/reportAction/reportCustomEvent 等）        | `references/api.md`                   |
@@ -47,12 +50,12 @@ description: 帮助业务方在前端应用里接入、使用和配置蓝鲸 RUM
 
 SDK 把能力拆成两类：
 
-- **内置采集**：统一放在 `tracking`，包括 View、请求、资源、错误、Web Vitals、Action 等；其中 Fetch/XHR 由单一请求生命周期实现。
+- **内置采集**：统一放在 `tracking`，包括 View、请求、资源、错误、Web Vitals、Action 等；其中 Fetch/XHR 由 SDK 自有的单一请求生命周期直接 patch，统一创建 `browser.resource` CLIENT Span。
 - **扩展**：接入方的 RUM 插件放在 `extensions.plugins`，标准 OpenTelemetry instrumentation 放在 `extensions.instrumentations`。它们都使用 SDK 私有 provider，并遵循 Consent 生命周期。
 
 ### 会话级确定性采样
 
-`session.sampleRate`（0–1，默认 1）是**会话级确定性采样**，不是 trace 级。决定由 `application.name + session.id` 的稳定 hash 得出，同一 Session 的 span/log/metric 决定一致。未命中时数据不会导出，`reportAction()`、`reportCustomEvent()` 会被静默丢弃。调试时临时设 `sampleRate: 1` 和 `debug: true`。
+`session.sampleRate`（0–1，默认 1）是**会话级确定性采样**，不是 trace 级。决定由 `application.name + session.id` 的稳定 hash 得出，同一 Session 的 span/log/metric 决定一致。插件仍维护必要的浏览器生命周期，但未命中时数据不会导出，`reportAction()`、`reportCustomEvent()` 会被静默丢弃。调试时临时设 `sampleRate: 1` 和 `debug: true`。
 
 ### 运行时上下文
 
@@ -107,3 +110,5 @@ View Loading Time 默认开启；默认关闭、按需打开：`longTask`、`csp
 - **Consent**：未授权初始化时配置 `privacy.trackingConsent: 'not-granted'`，用户授权后调用 `setTrackingConsent('granted')`；撤销授权会停止采集并解除 patch。
 - **信号开关**：`transport.signals.traces/metrics/logs` 设为 `false` 可关闭对应导出链路；关闭 Trace 后不会注入 `traceparent`。只开 Metric 时没有精确 View 下钻。
 - **低基数路由**：用 `tracking.view.getPathGroup` 把 `/user/123` 归类成 `/user/:id`，避免高基数 URL 污染指标维度。
+- **手动 View 的时机**：使用 `autoStart: false`，先 `await start()` 建立 Session，再调用 `startView()`；启动前调用会因没有有效采样 Session 而被忽略。
+- **Action 命名隐私**：默认 `nameCollection: 'explicit'` 只读取 `data-bk-action-name`，否则退回标签名；只有显式设为 `text` 才读取可访问名称和 DOM 文本。

package/skills/bk-rum-otele/evals/evals.json

@@ -5,7 +5,7 @@
       "id": 0,
       "name": "vue3-integration",
       "prompt": "我们是一个 Vue3 + vue-router 的后台管理系统，想接入蓝鲸 RUM 做前端监控。collector 地址是 https://rum.example.com，token 放在 window.__RUM_TOKEN__。帮我写接入代码：要能追踪 SPA 路由切换、检测白屏（挂载点 #app），生产环境按 20% 采样，并且把 URL 里的 token 参数脱敏。",
-      "expected_output": "给出使用 @blueking/open-telemetry 的 BkOpenTelemetry 接入代码：app/transport(endpoint+token)、sampling.rate=0.2、blankScreen.rootSelector='#app'、privacy.redactUrl 脱敏 token、通过 route.getPathGroup 或 vue-router afterEach + setView 追踪 SPA 路由。API/配置项名称需与 SDK 实际一致。",
+      "expected_output": "给出使用 @blueking/open-telemetry 的 BkOpenTelemetry 接入代码：application/transport(endpoint+token)、session.sampleRate=0.2、tracking.blankScreen.rootSelector='#app'、privacy.redactUrl 脱敏 token、通过 tracking.view.getPathGroup 自动追踪或 manual + await start() + startView() 对接 vue-router。API/配置项名称需与 SDK 实际一致。",
       "files": [],
       "assertions": []
     },
@@ -13,7 +13,7 @@
       "id": 1,
       "name": "local-no-data-troubleshoot",
       "prompt": "我按文档接了 bk-rum，本地起了 collector 在 4318，但 Network 里没看到 /rum 请求，reportCustomEvent 也没上报，debug 我也开了。可能是什么问题？怎么排查？",
-      "expected_output": "排障应覆盖：sampling.rate 是会话级 sticky 采样、未命中时插件不启动且手动事件静默丢弃(建议调试设 rate:1)；enabled 是否为 false；建议 spanProcessor:'simple' 便于本地看数据；检查 collector 是否监听 4318、endpoint 是否正确。",
+      "expected_output": "排障应覆盖：session.sampleRate 是会话级确定性采样，未命中时手动事件静默丢弃（建议调试设 sampleRate:1）；enabled/Consent/有效 View 是否正常；建议 transport.signals.traces.processor:'simple'；检查 collector、endpoint 与 Network 中 /v1/rum、/v1/metrics、/v1/logs。",
       "files": [],
       "assertions": []
     },
@@ -21,7 +21,7 @@
       "id": 2,
       "name": "instrumentation-vs-plugin-httpbody",
       "prompt": "配置里有 instrumentations 和 plugins 两块，fetch、error 这些好像两边都能配？它们到底有什么区别？另外我想采集接口报错时的请求/响应 body 来排查问题，该怎么配、要注意什么？",
-      "expected_output": "正确区分 Instrumentation(官方探针，patch 原生 API，不受采样影响)与 Plugin(自研 RUM 数据，受会话级采样影响)；指出 request 内部使用官方 fetch/xhr instrumentation、error 属 plugins；说明请求统一为 resource span，通过 excludedUrls 过滤、allowedTracingUrls 控制 traceparent、beforeSend 增补或丢弃；HTTP body 默认关闭，显式配置 request.body 后默认只采集错误请求，必须配置 redact，并限制 Content-Type 和大小。",
+      "expected_output": "正确区分内置 tracking、RUM Plugin 与额外 OTel Instrumentation；指出当前 request 是 SDK 自有 Fetch/XHR patch，生成 browser.resource CLIENT Span，不使用官方 Fetch/XHR instrumentation；说明 excludedUrls、allowedTracingUrls、request.beforeSend；HTTP body 默认关闭，显式配置 tracking.request.body 后默认只采集错误请求，必须配置 redact，并限制 Content-Type 和大小。",
       "files": [],
       "assertions": []
     }