@lark-apaas/observable 1.0.2 → 1.0.3-alpha.1

package/dist/index.cjs

@@ -8844,7 +8844,7 @@ __name(hrTimeToNanosNumber, "hrTimeToNanosNumber");
 
 // package.json
 var package_default = {
-  version: "1.0.2-alpha.4"};
+  version: "1.0.3-alpha.1"};
 
 // src/const.ts
 var AppEnv = /* @__PURE__ */ (function(AppEnv2) {
@@ -8857,6 +8857,7 @@ var defaultResourceAttr = {
   "sdk_type": "client-backend",
   "sdk_language": "node"
 };
+var TraceDropToken = "TraceDropToken";
 
 // src/utils/convertAllAttrIntoString.ts
 var safeStringify = /* @__PURE__ */ __name((obj) => {
@@ -8960,13 +8961,15 @@ var CustomTraceExporter = class {
       uuid: idGenerator.generateTraceId(),
       app_env: isDev ? AppEnv.Dev : AppEnv.Prod
     };
+    const finalSpans = spans.filter((span) => !(span.attributes ?? {})[TraceDropToken]);
+    if (!finalSpans.length) return;
     const otlpLikeStructure = {
       resource: {
         attributes: {
           ...defaultResourceAttr
         }
       },
-      spans: spans.map((span) => {
+      spans: finalSpans.map((span) => {
         const rawAttributes = {
           ...defaultAttributes,
           ...span.attributes ?? {}
@@ -9038,6 +9041,7 @@ var AppOTelSDK = class _AppOTelSDK {
   /**
   * [框架专用 API] 开启一个根 Span (Root Span)
   * 该方法专供 Middleware/Interceptor 使用
+  * wrapper 形式
   */
   startContext(headers, name, fn) {
     const carrier = {};
@@ -9052,6 +9056,22 @@ var AppOTelSDK = class _AppOTelSDK {
     });
   }
   /**
+  * [框架专用 API] 开启一个根 Span (Root Span)
+  * 该方法专供 Middleware/Interceptor 使用
+  * wrapper 形式
+  */
+  startRootTrace(headers, name) {
+    const carrier = {};
+    const customTraceId = headers["rpc-persist-apaas-observability-trace"];
+    if (customTraceId && _AppOTelSDK.CUSTOM_FORMAT_REGEX.test(customTraceId)) {
+      carrier["traceparent"] = `00-${customTraceId}-01`;
+    }
+    const activeContext = api.propagation.extract(api.context.active(), carrier);
+    const tracer = api.trace.getTracer("app-core");
+    const rootSpan = tracer.startSpan(name, {}, activeContext);
+    return rootSpan;
+  }
+  /**
   * [用户专用 API] 手动打点 (Child Span)
   * 用户在 Service 中调用此方法，会自动挂载到 Middleware 创建的 Root Span 下
   */
@@ -9105,6 +9125,31 @@ var AppOTelSDK = class _AppOTelSDK {
     });
   }
   /**
+  * 启动 Span 的工厂函数
+  * @param {string} name - Span 名称
+  * @param {Object} [parentSpan] - (可选) 父 Span 对象
+  */
+  startTrace(name, parentSpan) {
+    try {
+      const tracer = api.trace.getTracer("app-core");
+      let ctx = api.context.active();
+      if (parentSpan) {
+        ctx = api.trace.setSpan(ctx, parentSpan);
+      }
+      const span = tracer.startSpan(name, void 0, ctx);
+      return span;
+    } catch {
+      return _AppOTelSDK.emptySpan;
+    }
+  }
+  /**
+  * 丢弃 Span 的工厂函数
+  * @param {Span} span - 要被丢弃的 Span 对象
+  */
+  static dropTraceSpan(span) {
+    span.setAttribute(TraceDropToken, true);
+  }
+  /**
   * [框架专用] 强制刷新
   */
   async flush() {