[feat] support span discard

CHANGLOG.md

@@ -1,3 +1,7 @@
+## [0.1.22] - 2026-01-06
+### Added
+- support span discard
+
 ## [0.1.21] - 2025-12-23
 ### Added
 - runtime scene support get from env

cozeloop/internal/trace/noop_span.py

@@ -34,6 +34,9 @@ def set_tags(self, tag_kvs: Dict[str, Any]) -> None:
     def set_baggage(self, baggage_items: Dict[str, str]) -> None:
         pass
 
+    def discard(self) -> None:
+        pass
+
     def finish(self) -> None:
         pass
 

cozeloop/internal/trace/span.py

@@ -490,6 +490,9 @@ def set_baggage_item(self, restricted_key: str, value: str):
         with self.lock:
             super().set_baggage_item(restricted_key, value)
 
+    def discard(self) -> None:
+        delete_span_in_context(self.span_id)
+
     def finish(self):
         try:
             if not self.is_do_finish():

cozeloop/span.py

@@ -218,6 +218,12 @@ def finish(self) -> None:
         Under the hood, it is actually placed in an asynchronous queue waiting to be reported.
         """
 
+    @abstractmethod
+    def discard(self) -> None:
+        """
+        The span will be discarded, not be reported.
+        """
+
     @property
     @abstractmethod
     def start_time(self) -> datetime:

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "cozeloop"
-version = "0.1.21"
+version = "0.1.22"
 description = "coze loop sdk"
 authors = ["JiangQi715 <[email protected]>"]
 license = "MIT"