@blueking/open-telemetry 0.0.22-beta.1 → 0.0.23

package/skills/bk-rum-otele/references/getting-started.md

@@ -1,135 +1,251 @@
 <!-- 本文件由 packages/open-telemetry/scripts/gen-skill-references.mjs 从 wikis 自动生成，请勿手改。 -->
 
-# 简介
-
-`@blueking/open-telemetry` 是面向浏览器真实用户监控（RUM）的 OpenTelemetry 封装 SDK。它将页面访问、资源加载、接口请求、JavaScript 错误、Web Vitals、空白屏、会话和用户动作等浏览器事件统一转成原始 RUM Span，通过单一 OTLP HTTP 通道上报。
+# 快速上手
 
-## 适合解决什么问题
+本页用最少步骤完成安装、上报验证和第一个生产前配置。开始前需要一个接受 OTLP/HTTP JSON Trace 的 Collector 根地址；SDK 会固定请求 `<endpoint>/v1/rum`。
 
-- 统一采集前端页面性能、错误、接口请求、资源加载和用户行为。
-- 使用 OpenTelemetry 标准协议接入已有 Collector 或蓝鲸 RUM 后端。
-- 将浏览器事件与后端 trace 关联，定位一次访问中的慢请求、资源异常和前端错误。
-- 通过插件逐步打开高级采集能力，控制数据量、隐私和性能成本。
+## 1. 安装
 
-## SDK 能力分层
+```bash
+pnpm add @blueking/open-telemetry
+```
 
-1. `core`：负责配置解析、provider/exporter 初始化、采样、插件生命周期和运行时上下文。
-2. `plugins`：负责浏览器 RUM 事件采集，包括页面、资源、错误、性能、会话、动作等能力。
-3. `schema`：负责 RUM 字段、span 类型、结果、耗时分桶等归一化模型。
-4. `browser` / `index`：分别提供 CDN 全局入口（`https://unpkg.com/@blueking/open-telemetry/dist/bk-rum.global.js`）和 ESM 模块入口（`@blueking/open-telemetry`）。
+也可以使用 npm 或 yarn。SDK 的 ESM 构建把 OpenTelemetry 依赖视为 package dependencies，由应用构建工具解析。
 
-完整能力、默认开关与信号产出见[能力矩阵](./capabilities.md)，初始化顺序、上下文和导出过滤见[架构与数据流](./architecture.md)。
+## 2. 最小初始化
 
-## 最小示例
+在前端应用唯一入口创建一个实例：
 
 ```ts
+// rum.ts
 import { BkOpenTelemetry } from '@blueking/open-telemetry';
 
-new BkOpenTelemetry({
+export const rum = new BkOpenTelemetry({
   application: {
-    name: 'bk-rum-demo',
-    environment: 'production',
-    version: '1.0.0',
+    name: 'order-center',
   },
   transport: {
     endpoint: 'https://rum-collector.example.com',
-    token: 'report-token',
   },
 });
 ```
 
-默认情况下，SDK 会自动启动，建立 Session 和 View，并开启 request（内部组合 Fetch/XHR）、action、resource、error、webVitals、blankScreen、device 等基础采集能力。
+只有两个必填字段：
 
-# 快速上手
+- `application.name`：稳定、低基数的应用名；
+- `transport.endpoint`：上报根地址，不能为空。
 
-## 安装与初始化
+构造后默认自动启动。最终请求：
 
-```bash
-pnpm add @blueking/open-telemetry
+```text
+POST https://rum-collector.example.com/v1/rum
+Content-Type: application/json
 ```
 
+不要把 `/v1/rum` 写进 endpoint，否则会重复追加。
+
+## 3. 验证接入
+
+打开浏览器 DevTools：
+
+1. Network 过滤 `v1/rum`；
+2. 等待默认 batch 调度，或执行 `await rum.flush()`；
+3. 确认 POST 返回 2xx；
+4. 确认请求体顶层包含 `resourceSpans`；
+5. 确认 Span attributes 有 `service.name`、`session.id` 和 `view.id`。
+
+联调阶段可以显式启动并打开调试：
+
 ```ts
-import { BkOpenTelemetry } from '@blueking/open-telemetry';
+export const rum = new BkOpenTelemetry({
+  application: { name: 'order-center' },
+  transport: {
+    endpoint: 'https://rum-collector.example.com',
+    processor: 'simple',
+  },
+  session: { sampleRate: 1 },
+  debug: true,
+  autoStart: false,
+});
 
-export const bkOT = new BkOpenTelemetry({
+await rum.start();
+```
+
+控制台会在 exporter 前打印 `[bk-ot][rum]` Span。验证完成后生产环境应恢复 `processor: 'batch'`。
+
+## 4. 添加应用版本和鉴权
+
+```ts
+export const rum = new BkOpenTelemetry({
   application: {
-    name: 'bk-monitor-web',
+    name: 'order-center',
     environment: 'production',
-    version: '1.4.2',
+    version: '2026.07.21',
   },
   transport: {
     endpoint: 'https://rum-collector.example.com',
-    token: window.__BK_RUM_TOKEN__,
-  },
-  session: {
-    sampleRate: 0.2,
+    token: window.__RUM_WRITE_TOKEN__,
   },
-  tracking: {
-    view: {
-      getPathGroup: url => new URL(url).pathname.replace(/\/\d+/g, '/:id'),
+});
+```
+
+`token` 会生成：
+
+```text
+Authorization: Bearer <token>
+```
+
+浏览器凭证对页面用户可见，必须是仅允许 RUM 写入的受限 token。自定义 header、重试、CORS 和 batch 规则见[上报协议、批处理与采样](./transport-sampling.md)。
+
+## 5. 配置 Session 采样
+
+```ts
+session: {
+  sampleRate: 0.2,
+}
+```
+
+这是 Session 级稳定采样：同一 Session 要么全部采集，要么全部不导出，而不是每个 Span 随机抽样。默认值为 `1`。
+
+测试手动事件时先保持 `1`；生产采样率根据访问量、每会话事件数和 Collector 容量评估。
+
+## 6. 治理动态路由
+
+默认 `view.url_path_group` 是 pathname，因此 `/orders/1001` 与 `/orders/1002` 仍是两个分组。生产环境应模板化动态段：
+
+```ts
+tracking: {
+  view: {
+    getPathGroup(rawUrl) {
+      const path = new URL(rawUrl, location.href).pathname;
+      return path
+        .replace(/\/orders\/[^/]+/g, '/orders/:id')
+        .replace(/\/users\/[^/]+/g, '/users/:id');
     },
   },
-  context: {
-    user: { id: window.__BK_USER__?.id },
-  },
-});
+}
 ```
 
-`application.name` 与 `transport` 必填。通常提供根 `transport.endpoint`；如果所有已开启信号都有独立 endpoint，则可省略根地址。SDK 默认自动启动。
+这只治理聚合基数，不会清洗 `view.url`。URL 隐私需要另外配置 `privacy.redactUrl`。
 
-## 手动启动与扩展
+## 7. 关联登录用户
 
 ```ts
-const bkOT = new BkOpenTelemetry({
-  application: { name: 'bk-rum-demo' },
-  autoStart: false,
-  transport: { endpoint: 'https://rum-collector.example.com' },
-  extensions: { plugins: [bizReadyPlugin] },
-});
+rum.setUser({ id: 'internal-stable-id' });
+
+// 登出
+rum.setUser({ id: undefined });
+```
 
-await bkOT.start();
+也可以在构造时设置：
+
+```ts
+context: {
+  user: { id: window.__USER__?.rumId },
+}
 ```
 
-`use()`、`useInstrumentation()` 和 `extensions` 注册都必须发生在 `start()` 前。
+SDK 原样透传 `user.id`，不会 hash。不要直接发送手机号、邮箱或可枚举的敏感账号标识。
 
-手动 View 也应在 `await start()` 建立 Session 后创建：
+## 8. 手动上报业务事件
+
+手动 Action：
 
 ```ts
-const bkOT = new BkOpenTelemetry({
-  application: { name: 'manual-view-demo' },
-  autoStart: false,
-  transport: { endpoint: 'https://rum-collector.example.com' },
-  tracking: { view: { tracking: 'manual' } },
+rum.reportAction({
+  name: 'submit-order',
+  attributes: {
+    'biz.order.channel': 'web',
+  },
 });
+```
 
-await bkOT.start();
-bkOT.startView({ name: '订单详情', url: location.href });
+自定义事件：
+
+```ts
+rum.reportCustomEvent({
+  name: 'checkout_completed',
+  attributes: {
+    'biz.payment.method': 'card',
+  },
+});
 ```
 
-## CDN
+带错误：
+
+```ts
+rum.reportCustomEvent({
+  name: 'checkout_failed',
+  error: new Error('payment rejected'),
+});
+```
+
+名称必须低基数，不要拼 ID 或用户输入。未命中 Session 采样时这些调用被静默丢弃。
+
+手动事件不会在 SDK 启动期间排队。若首个事件的交付时序重要，请使用 `autoStart: false` 并在 `await rum.start()` 完成后调用；manual View 还必须先 `startView()`。默认异步 autoStart 更适合不依赖“构造后立即上报”的自动采集场景。
+
+## 9. CDN 接入
 
 ```html
 <script src="https://unpkg.com/@blueking/open-telemetry/dist/bk-rum.global.js"></script>
 <script>
-  window.bkOT = new window.BkOpenTelemetry({
-    application: { name: 'legacy-web', environment: 'production' },
-    transport: { endpoint: 'https://rum-collector.example.com', token: 'report-token' },
+  window.rum = new window.BkOpenTelemetry({
+    application: {
+      name: 'legacy-portal',
+      environment: 'production',
+    },
+    transport: {
+      endpoint: 'https://rum-collector.example.com',
+      token: window.__RUM_WRITE_TOKEN__,
+    },
   });
 </script>
 ```
 
-## 手动事件
+生产 CDN 地址应固定 npm package 版本并使用你们认可的 CDN/SRI 策略，不要长期跟随 latest。全局 bundle 包含所需依赖，公开类名是 `window.BkOpenTelemetry`。
+
+## 默认会采集什么
+
+最小配置默认开启：
+
+- Session 与 View 生命周期；
+- Fetch/XHR 和静态资源；
+- JS、Promise、资源加载错误；
+- CLS、FCP、INP、LCP、TTFB；
+- 点击 Action 与挫败信号；
+- 白屏检测；
+- 设备、浏览器、屏幕和可用网络信息。
+
+默认关闭 Long Task、WebSocket 和 CSP。所有数据都是原始 RUM Span，不会创建 Metric/Log Provider。精确默认值见[能力矩阵](./capabilities.md)。
+
+## 自动 View 与手动 View
+
+默认 auto 会监听 History API、pathname 和 hash。只有 Router 无法被正确识别，或业务需要完全控制边界时才用 manual：
 
 ```ts
-bkOT.reportAction({
-  name: '提交订单',
-  attributes: { 'biz.order_id': '202607160001' },
+const rum = new BkOpenTelemetry({
+  application: { name: 'manual-view-app' },
+  transport: { endpoint: 'https://rum-collector.example.com' },
+  autoStart: false,
+  tracking: {
+    view: { tracking: 'manual' },
+  },
 });
 
-bkOT.reportCustomEvent({
-  name: 'checkout_success',
-  attributes: { 'biz.amount': 99.9 },
+await rum.start();
+rum.startView({
+  name: 'order-detail',
+  url: location.href,
 });
 ```
 
-未命中 `session.sampleRate` 时，手动事件静默丢弃。
+必须先建立采样 Session，再调用 `startView()`。不要同时保留 auto 路由追踪和 Router `afterEach` 手动创建，否则会重复 View。
+
+## 接入后下一步
+
+- 上线前逐项评审：[生产接入指南](./production.md)
+- Vue、React、微前端：[框架与路由集成](./framework-integration.md)
+- 查所有开关：[配置参考](./configuration.md)
+- 理解服务端收到什么：[RUM 数据模型](./data-model.md)
+- 查精确字段：[遥测字段字典](./telemetry-reference.md)
+- 没有数据：[调试与排障](./troubleshooting.md)

package/skills/bk-rum-otele/references/network.md

@@ -0,0 +1,258 @@
+<!-- 本文件由 packages/open-telemetry/scripts/gen-skill-references.mjs 从 wikis 自动生成，请勿手改。 -->
+
+# 请求、资源与 WebSocket
+
+网络能力覆盖 Fetch、XMLHttpRequest、静态资源和 WebSocket。Fetch/XHR 由 SDK 自有单层 Patch 负责 Span、Trace Header、Resource Timing 和页面活动；静态资源由 PerformanceObserver 采集；WebSocket 只记录连接生命周期。
+
+## 默认状态
+
+| 能力      | 配置                 | 默认 |
+| --------- | -------------------- | ---- |
+| Fetch/XHR | `tracking.request`   | 开启 |
+| 静态资源  | `tracking.resource`  | 开启 |
+| WebSocket | `tracking.websocket` | 关闭 |
+
+SDK 不采集任何请求 Body、响应 Body、WebSocket 消息内容、消息数量或消息字节数。
+
+## Fetch/XHR Patch
+
+`tracking.request=false` 时完全不 Patch Fetch/XHR。开启时，同一层实现负责：
+
+1. 把 URL 转成绝对 URL。
+2. 排除 SDK 自身上报和 `excludedUrls`。
+3. 创建 `browser.resource` CLIENT Span。
+4. 按白名单决定是否注入 `traceparent`。
+5. 把请求开始/结束通知给 View/Action 页面活动。
+6. 根据 Response 或终止原因生成结构化 outcome，并补充结果、异常和 Resource Timing。
+7. 执行请求级 `beforeSend`。
+8. 结束 Span，并进入全局过滤链路。
+
+Patch 在插件 shutdown 时仅在全局方法仍是 SDK 安装版本的情况下恢复，避免覆盖 SDK 之后由业务安装的其他 Patch。
+
+## 请求 Span
+
+Fetch 和 XHR 都生成 `browser.resource`：
+
+| 字段                        | Fetch                                          | XHR                         |
+| --------------------------- | ---------------------------------------------- | --------------------------- |
+| `resource.type`             | `fetch`                                        | `xhr`                       |
+| `http.request.method`       | `init.method`、Request method 或 `GET`，转大写 | `open()` method，转大写     |
+| `url.full`                  | 绝对 URL，经脱敏                               | 同左                        |
+| `http.response.status_code` | 获得真实 Response status 时                    | `load` 且 `xhr.status>0` 时 |
+| Span Kind                   | CLIENT                                         | CLIENT                      |
+
+Span 开始时间使用请求开始时间，结束时间优先使用匹配到的 `PerformanceResourceTiming.responseEnd`；没有匹配时使用 Fetch resolve/reject 或 XHR `load/abort/timeout/error` 的完成时间。`http.response.status_code` 只表示真实 HTTP Response，不会上报 XHR 的本地占位值 `0`。
+
+## Outcome 与 Status
+
+| 条件                               | `outcome.type` | `outcome.reason`  | OTel Status                 |
+| ---------------------------------- | -------------- | ----------------- | --------------------------- |
+| `408` / `504`                      | `timeout`      | `network_timeout` | ERROR                       |
+| 其他 `4xx`                         | `error`        | `http_4xx`        | ERROR                       |
+| `5xx`                              | `error`        | `http_5xx`        | ERROR                       |
+| Fetch AbortError / XHR `abort`     | `abort`        | 不写              | UNSET，不记录 exception     |
+| Fetch TimeoutError / XHR `timeout` | `timeout`      | `network_timeout` | ERROR，Fetch 记录 exception |
+| Fetch 其他 reject / XHR `error`    | `error`        | `network`         | ERROR，Fetch 记录 exception |
+| XHR `load` 但无法取得有效状态      | `error`        | `network`         | ERROR                       |
+| 其余                               | `success`      | 不写              | UNSET                       |
+
+SDK 不根据业务响应 JSON 中的 code 判断成功或失败；需要业务口径时使用 `request.beforeSend` 增加属性，或上报自定义事件。
+
+## URL 排除
+
+```ts
+tracking: {
+  request: {
+    excludedUrls: [
+      '/health',
+      /\/polling\/(?:[^?]+)(?:\?|$)/,
+      url => new URL(url).hostname === 'analytics.example.com',
+    ],
+  },
+}
+```
+
+Matcher 规则：
+
+- 字符串：`absoluteUrl.includes(matcher)`，不是精确路径匹配。
+- 正则：匹配前重置 `lastIndex=0`，可安全复用带 `g` 的正则。
+- 函数：收到绝对 URL，返回 boolean。
+
+命中 `excludedUrls` 后不创建 Span、不注入 Header、也不参与 View/Action 活动。SDK 自身 `/v1/rum` 请求始终排除，比较时忽略 query、fragment 和末尾斜杠。
+
+## W3C Trace Context
+
+默认不向任何请求注入 Trace Header，包括同源请求。只有 `allowedTracingUrls` 显式命中时才使用 `W3CTraceContextPropagator` 注入 `traceparent`：
+
+```ts
+tracking: {
+  request: {
+    allowedTracingUrls: [
+      url => new URL(url).origin === 'https://api.example.com',
+    ],
+  },
+}
+```
+
+Fetch 会合并 `init.headers` 或输入 Request 的 Headers；XHR 使用 `setRequestHeader()`。白名单应使用 URL-aware 函数或有边界的正则，不要用过宽字符串。
+
+当前请求 Span 命中 Session 采样后，注入值采用 W3C Trace Context v00：
+
+```text
+traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
+             │  └──────────── trace-id：32 位小写十六进制 ────────────┘
+             └ version=00                       parent-id：16 位 ─────┘  sampled=01
+```
+
+这里的 `parent-id` 是本次 Fetch/XHR CLIENT Span 的 `spanId`。请求 Patch 只在当前 Session 已采样时创建并注入记录型 Span，因此当前实现发出的 flags 为 `01`。如果活动父上下文带有 `traceState`，传播器还会写 `tracestate`；SDK 自身不创建 `tracestate`。
+
+已有 Header 的处理取决于浏览器 API：
+
+- Fetch 使用 `Headers.set()`，会覆盖 Headers 中已有的 `traceparent` / `tracestate`；
+- XHR 在 `send()` 前调用 `setRequestHeader()`，浏览器可能把业务先设置的同名值追加合并，形成无效 Trace Context；不要由业务再手工设置同名 Header；
+- SDK 不先解析入站 Header 再决定是否保留，`allowedTracingUrls` 命中即按当前活动 SpanContext 注入。
+
+跨域注入会触发 CORS 预检，服务端至少需要允许：
+
+```http
+Access-Control-Allow-Origin: https://your-web.example.com
+Access-Control-Allow-Headers: traceparent, tracestate
+```
+
+若你的链路从不携带 `tracestate`，可以只允许 `traceparent`；如业务还有自定义 Header，应一并加入允许列表。
+
+## 请求级 beforeSend
+
+```ts
+tracking: {
+  request: {
+    beforeSend(event, context) {
+      event.attributes['biz.api_group'] = classifyApi(event.resource.url);
+      if (
+        event.resource.outcome.type === 'response' &&
+        event.resource.outcome.statusCode === 404 &&
+        event.resource.url?.includes('/optional/')
+      ) {
+        return false;
+      }
+    },
+  },
+}
+```
+
+`event.type` 固定为 `resource`；`event.resource` 包含 `transport`、`url`、`method` 和结构化 `outcome`：
+
+```ts
+type BkOTRequestOutcome =
+  | { type: 'response'; statusCode?: number }
+  | { type: 'abort' }
+  | { type: 'timeout'; error?: unknown }
+  | { type: 'network_error'; error?: unknown };
+```
+
+第二个参数保留原始浏览器上下文：
+
+- Fetch：`request`、可选 `response`、可选 `error`。
+- XHR：原始 `XMLHttpRequest` 实例。
+
+Hook 可原地修改 `event.attributes`；返回 `false` 时给 Span 写入内部丢弃标记，Span 正常结束但不会进入 Exporter。Hook 抛错时默认继续发送，`debug=true` 输出 warning。
+
+之后仍会执行 `privacy.redactAttributes` 和全局 `tracking.beforeSend`。
+
+## Resource Timing 匹配
+
+Fetch resolve/reject 和 XHR 终止事件往往早于 Resource Timing Observer 回调。SDK 在请求完成后最多等待 200ms：
+
+- 以去掉 fragment 后的绝对 URL 匹配；
+- 同 URL 并发请求选择开始时间最接近的 Entry；
+- 允许 Performance Entry 比 JavaScript 请求开始早最多 50ms；
+- 待匹配队列最多 100 条，超出时释放最旧请求。
+
+匹配成功后，请求 Span 使用 Resource Timing 的结束时间，并增加 DNS、连接、TLS、TTFB、下载、Body Size 等字段。匹配失败不影响基础请求 Span。
+
+## 静态资源
+
+`tracking.resource=true` 时，Resource PerformanceObserver 为非 Fetch/XHR Entry 创建独立 `browser.resource` CLIENT Span。Fetch 和 `xmlhttprequest` Entry 只回填已有请求 Span，不重复上报。
+
+常见资源类型来自 `initiatorType`，例如 `script`、`link`、`img`、`css`、`beacon`、`other`。
+
+| 字段                              | 说明                                                       |
+| --------------------------------- | ---------------------------------------------------------- |
+| `resource.type`                   | initiator type                                             |
+| `resource.size`                   | `transferSize`                                             |
+| `resource.encoded_body_size`      | 编码后 Body Size                                           |
+| `resource.decoded_body_size`      | 解码后 Body Size                                           |
+| `resource.protocol`               | `nextHopProtocol`，例如 `h2`                               |
+| `resource.cache.hit`              | deliveryType=cache，或 transferSize=0 且 decodedBodySize>0 |
+| `resource.delivery_type`          | 浏览器提供的 delivery type                                 |
+| `resource.render_blocking_status` | blocking / non-blocking，浏览器支持时                      |
+
+## 网络阶段字段
+
+每个阶段同时写相对资源开始的 `start` 和阶段 `duration`，单位 ms：
+
+- `resource.redirect.*`
+- `resource.worker.*`
+- `resource.dns.*`
+- `resource.connect.*`
+- `resource.ssl.*`
+- `resource.first_byte.*`
+- `resource.download.*`
+
+SDK 先验证 `startTime → fetchStart → DNS → connect → request → response` 全部有限且非递减；任一异常时整组阶段字段不写入，避免负耗时污染。Safari 等返回 `duration=0` 但 `responseEnd` 有效时，总 Span duration 回退为 `responseEnd - startTime`。
+
+跨域资源缺少 `Timing-Allow-Origin` 时，浏览器会清零或隐藏部分阶段。SDK 不伪造缺失值。需要完整瀑布时，资源服务端应返回：
+
+```http
+Timing-Allow-Origin: https://your-web.example.com
+```
+
+## 仅关闭静态资源 Span
+
+`tracking.resource=false` 不会完全关闭 Resource Observer。Observer 仍用于：
+
+- 把 Fetch/XHR Resource Timing 回填到请求 Span；
+- 把静态资源完成通知给 View/Action 页面活动。
+
+它只禁止为静态资源创建独立 Span。
+
+## WebSocket 生命周期
+
+`tracking.websocket=true` 时，SDK 使用 Proxy 包装全局 `WebSocket` 构造器，并保持静态常量、`instanceof` 和子类构造行为。每条连接生成 `websocket.connection.id`，随后发送四类瞬时 CLIENT Span：
+
+| phase     | 时机                  | 额外字段                       |
+| --------- | --------------------- | ------------------------------ | -------- |
+| `connect` | 构造 WebSocket 后立即 | 基础目标字段                   |
+| `open`    | `open` Event          | 无                             |
+| `error`   | `error` Event         | `websocket.error.phase=connect | runtime` |
+| `close`   | `close` Event         | code、reason、was_clean        |
+
+Span 名统一为 `browser.websocket`，通过 `websocket.phase` 区分，不使用长连接 Span。基础字段包括：
+
+- `network.protocol.name=websocket`
+- `url.full`，经脱敏
+- `url.scheme=ws|wss`
+- `server.address`
+- 存在显式端口时的 `server.port`
+
+命中 SDK Endpoint 排除规则的 URL 不采集。WebSocket 没有独立 excludedUrls；如需更细过滤，应关闭内置能力并使用自定义插件。
+
+## 常见问题
+
+### 请求重复
+
+优先检查：
+
+- 同页是否初始化多个 SDK 实例；
+- 是否额外启用了 Fetch/XHR OpenTelemetry Instrumentation；
+- 是否同时由微前端主、子应用初始化。
+
+### 有请求 Span 但没有网络阶段
+
+可能原因：浏览器不支持 Resource Timing、200ms 内没有匹配到 Entry、同 URL 高并发匹配失败、跨域缺少 TAO，或浏览器返回乱序时间点。
+
+### 后端没有收到 traceparent
+
+检查 URL 是否真正命中 `allowedTracingUrls`、浏览器预检是否成功、服务端是否允许 `traceparent`，以及代理是否删除该 Header。
+
+完整字段见[遥测字段字典](./telemetry-reference.md#请求与静态资源字段)。