@blueking/open-telemetry 0.0.27 → 0.0.28

package/dist/core/config.d.ts

@@ -71,8 +71,9 @@ export interface BkOTRequestConfig {
     allowedTracingUrls?: BkOTUrlMatcher | BkOTUrlMatcher[];
     excludedUrls?: BkOTUrlMatcher | BkOTUrlMatcher[];
     beforeSend?: (event: BkOTRequestEvent, context: BkOTRequestContext) => boolean | void;
+    /** 返回请求 URL 的低基数模板，例如 `/api/orders/{id}`；返回空值时回退到默认折叠规则。 */
+    getUrlTemplate?: (url: string) => string | undefined;
 }
-export type BkOTRequestOutcome = RumRequestOutcome;
 export type BkOTRequestContext = {
     error?: unknown;
     request: Request | RequestInit;
@@ -92,6 +93,7 @@ export interface BkOTRequestEvent {
         url?: string;
     };
 }
+export type BkOTRequestOutcome = RumRequestOutcome;
 export type BkOTSpanProcessorMode = 'batch' | 'simple';
 export interface BkOTTrackingConfig {
     action?: BkOTActionPluginOptions | boolean;
@@ -124,8 +126,8 @@ export interface BkOTViewConfig {
     /** 自动计算初始加载与 SPA 路由的页面稳定耗时，默认开启。 */
     loadingTime?: boolean;
     tracking?: 'auto' | 'manual';
-    /** 返回低基数路由分组，例如 `/trace/:id`。 */
-    getPathGroup?: (url: string) => string | undefined;
+    /** 返回页面路由的低基数模板，例如 `/trace/:id`；返回空值时回退到默认折叠规则。 */
+    getUrlTemplate?: (url: string) => string | undefined;
 }
 export interface ResolvedApplicationConfig {
     environment: string;
@@ -154,7 +156,8 @@ export interface ResolvedConfigHooks {
     getCustomAttributes: () => Attributes;
     getErrorAttributes: () => Attributes;
     getPageAttributes: () => Attributes;
-    getViewPathGroup: (url: string) => string;
+    getRequestUrlTemplate: (url: string) => string;
+    getViewUrlTemplate: (url: string) => string;
     redactAttributes: (attributes: Attributes) => Attributes;
     redactUrl: (url: string) => string;
 }

package/dist/core/runtime-context.d.ts

@@ -37,7 +37,7 @@ export interface BkOTViewContext {
     name?: string;
     startedAt?: number;
     url?: string;
-    urlPathGroup?: string;
+    urlTemplate?: string;
 }
 /**
  * 管理 SDK 运行期公共属性快照。

package/dist/core/url.d.ts

@@ -1,5 +1,10 @@
 import type { BkOTUrlMatcher, ResolvedBkOTConfig } from './config';
 export declare const toAbsoluteUrl: (url: string) => string;
+/**
+ * 常见数字 ID、UUID 和长十六进制段统一折叠为 :id，便于服务端按路由聚合。
+ * 同时服务 `view.url_template`（页面路由）与 `url.template`（请求路径）两个维度。
+ */
+export declare const normalizeUrlPathTemplate: (pathGroup: string) => string;
 export declare const isBkOTEndpoint: (config: ResolvedBkOTConfig, url: string) => boolean;
 export declare const shouldIgnoreUrl: (config: ResolvedBkOTConfig, url: string) => boolean;
 export declare const matchesUrlList: (matchers: BkOTUrlMatcher | BkOTUrlMatcher[] | undefined, url: string) => boolean;