chore(tracing): simplify Span tag/metric API typing

ddtrace/_trace/context.py

@@ -9,8 +9,6 @@
 from typing import Tuple
 
 from ddtrace._trace._span_link import SpanLink
-from ddtrace._trace.types import _MetaDictType
-from ddtrace._trace.types import _MetricDictType
 from ddtrace.constants import _ORIGIN_KEY
 from ddtrace.constants import _SAMPLING_PRIORITY_KEY
 from ddtrace.constants import _USER_ID_KEY
@@ -25,8 +23,8 @@
 _ContextState = Tuple[
     Optional[int],  # trace_id
     Optional[int],  # span_id
-    _MetaDictType,  # _meta
-    _MetricDictType,  # _metrics
+    dict[str, str],  # _meta
+    dict[str, NumericType],  # _metrics
     List[SpanLink],  #  span_links
     Dict[str, Any],  # baggage
     bool,  # is_remote
@@ -63,15 +61,15 @@ def __init__(
         span_id: Optional[int] = None,
         dd_origin: Optional[str] = None,
         sampling_priority: Optional[float] = None,
-        meta: Optional[_MetaDictType] = None,
-        metrics: Optional[_MetricDictType] = None,
+        meta: Optional[dict[str, str]] = None,
+        metrics: Optional[dict[str, NumericType]] = None,
         lock: Optional[threading.RLock] = None,
         span_links: Optional[List[SpanLink]] = None,
         baggage: Optional[Dict[str, Any]] = None,
         is_remote: bool = True,
     ):
-        self._meta: _MetaDictType = meta if meta is not None else {}
-        self._metrics: _MetricDictType = metrics if metrics is not None else {}
+        self._meta: dict[str, str] = meta if meta is not None else {}
+        self._metrics: dict[str, NumericType] = metrics if metrics is not None else {}
         self._baggage: Dict[str, Any] = baggage if baggage is not None else {}
 
         self.trace_id: Optional[int] = trace_id

ddtrace/_trace/span.py

@@ -20,9 +20,6 @@
 from ddtrace._trace._span_pointer import _SpanPointerDirection
 from ddtrace._trace.context import Context
 from ddtrace._trace.types import _AttributeValueType
-from ddtrace._trace.types import _MetaDictType
-from ddtrace._trace.types import _MetricDictType
-from ddtrace._trace.types import _TagNameType
 from ddtrace.constants import _SAMPLING_AGENT_DECISION
 from ddtrace.constants import _SAMPLING_LIMIT_DECISION
 from ddtrace.constants import _SAMPLING_RULE_DECISION
@@ -37,14 +34,10 @@
 from ddtrace.constants import USER_KEEP
 from ddtrace.constants import USER_REJECT
 from ddtrace.constants import VERSION_KEY
-from ddtrace.ext import http
-from ddtrace.ext import net
 from ddtrace.internal import core
 from ddtrace.internal._rand import rand64bits as _rand64bits
 from ddtrace.internal._rand import rand128bits as _rand128bits
 from ddtrace.internal.compat import NumericType
-from ddtrace.internal.compat import ensure_text
-from ddtrace.internal.compat import is_integer
 from ddtrace.internal.constants import MAX_INT_64BITS as _MAX_INT_64BITS
 from ddtrace.internal.constants import MAX_UINT_64BITS as _MAX_UINT_64BITS
 from ddtrace.internal.constants import MIN_INT_64BITS as _MIN_INT_64BITS
@@ -191,9 +184,9 @@ def __init__(
         self.span_type = span_type
         self._span_api = span_api
 
-        self._meta: _MetaDictType = {}
+        self._meta: dict[str, str] = {}
         self.error = 0
-        self._metrics: _MetricDictType = {}
+        self._metrics: dict[str, NumericType] = {}
 
         self._meta_struct: Dict[str, Dict[str, Any]] = {}
 
@@ -335,51 +328,17 @@ def _set_sampling_decision_maker(
         self.context._meta[SAMPLING_DECISION_TRACE_TAG_KEY] = value
         return value
 
-    def set_tag(self, key: _TagNameType, value: Any = None) -> None:
+    def set_tag(self, key: str, value: Optional[str] = None) -> None:
         """Set a tag key/value pair on the span.
 
-        Keys must be strings, values must be ``str``-able.
+        Keys must be strings, values must be ``str``.
 
         :param key: Key to use for the tag
-        :type key: str
+        :type key: ``str``
         :param value: Value to assign for the tag
-        :type value: ``str``-able value
+        :type value: ``str`` | `None``
         """
-
-        if not isinstance(key, str):
-            log.warning("Ignoring tag pair %s:%s. Key must be a string.", key, value)
-            return
-
-        # Special case, force `http.status_code` as a string
-        # DEV: `http.status_code` *has* to be in `meta` for metrics
-        #   calculated in the trace agent
-        if key == http.STATUS_CODE:
-            value = str(value)
-
-        # Determine once up front
-        val_is_an_int = is_integer(value)
-
-        # Explicitly try to convert expected integers to `int`
-        # DEV: Some integrations parse these values from strings, but don't call `int(value)` themselves
-        INT_TYPES = (net.TARGET_PORT,)
-        if key in INT_TYPES and not val_is_an_int:
-            try:
-                value = int(value)
-                val_is_an_int = True
-            except (ValueError, TypeError):
-                pass
-
-        # Set integers that are less than equal to 2^53 as metrics
-        if value is not None and val_is_an_int and abs(value) <= 2**53:
-            self.set_metric(key, value)
-            return
-
-        # All floats should be set as a metric
-        elif isinstance(value, float):
-            self.set_metric(key, value)
-            return
-
-        elif key == MANUAL_KEEP_KEY:
+        if key == MANUAL_KEEP_KEY:
             self._override_sampling_decision(USER_KEEP)
             return
         elif key == MANUAL_DROP_KEY:
@@ -390,21 +349,17 @@ def set_tag(self, key: _TagNameType, value: Any = None) -> None:
         elif key == SERVICE_VERSION_KEY:
             # Also set the `version` tag to the same value
             # DEV: Note that we do no return, we want to set both
-            self.set_tag(VERSION_KEY, value)
-        elif key == _SPAN_MEASURED_KEY:
-            # Set `_dd.measured` tag as a metric
-            # DEV: `set_metric` will ensure it is an integer 0 or 1
-            if value is None:
-                value = 1
-            self.set_metric(key, value)
-            return
+            if value:
+                self._meta[VERSION_KEY] = value
+            else:
+                self._meta.pop(VERSION_KEY, None)
 
-        try:
-            self._meta[key] = str(value)
-            if key in self._metrics:
-                del self._metrics[key]
-        except Exception:
-            log.warning("error setting tag %s, ignoring it", key, exc_info=True)
+        if value is not None:
+            self._meta[key] = value
+        else:
+            self._meta.pop(key, None)
+        # Ensure we do not have the same key in both meta and metrics
+        self._metrics.pop(key, None)
 
     def set_struct_tag(self, key: str, value: Dict[str, Any]) -> None:
         """
@@ -417,35 +372,29 @@ def get_struct_tag(self, key: str) -> Optional[Dict[str, Any]]:
         """Return the given struct or None if it doesn't exist."""
         return self._meta_struct.get(key, None)
 
-    def set_tag_str(self, key: _TagNameType, value: Text) -> None:
+    def set_tag_str(self, key: str, value: str) -> None:
         """Set a value for a tag. Values are coerced to unicode in Python 2 and
         str in Python 3, with decoding errors in conversion being replaced with
         U+FFFD.
         """
-        try:
-            self._meta[key] = ensure_text(value, errors="replace")
-        except Exception as e:
-            if config._raise:
-                raise e
-            log.warning("Failed to set text tag '%s'", key, exc_info=True)
+        self._meta[key] = value
 
-    def get_tag(self, key: _TagNameType) -> Optional[Text]:
+    def get_tag(self, key: str) -> Optional[str]:
         """Return the given tag or None if it doesn't exist."""
         return self._meta.get(key, None)
 
-    def get_tags(self) -> _MetaDictType:
+    def get_tags(self) -> dict[str, str]:
         """Return all tags."""
         return self._meta.copy()
 
-    def set_tags(self, tags: Dict[_TagNameType, Any]) -> None:
+    def set_tags(self, tags: dict[str, str]) -> None:
         """Set a dictionary of tags on the given span. Keys and values
         must be strings (or stringable)
         """
-        if tags:
-            for k, v in iter(tags.items()):
-                self.set_tag(k, v)
+        for k, v in tags.items():
+            self.set_tag(k, v)
 
-    def set_metric(self, key: _TagNameType, value: NumericType) -> None:
+    def set_metric(self, key: str, value: NumericType) -> None:
         """This method sets a numeric tag value for the given key."""
         # Enforce a specific constant for `_dd.measured`
         if key == _SPAN_MEASURED_KEY:
@@ -455,35 +404,23 @@ def set_metric(self, key: _TagNameType, value: NumericType) -> None:
                 log.warning("failed to convert %r tag to an integer from %r", key, value)
                 return
 
-        # FIXME[matt] we could push this check to serialization time as well.
-        # only permit types that are commonly serializable (don't use
-        # isinstance so that we convert unserializable types like numpy
-        # numbers)
-        if not isinstance(value, (int, float)):
-            try:
-                value = float(value)
-            except (ValueError, TypeError):
-                log.debug("ignoring not number metric %s:%s", key, value)
-                return
-
         # don't allow nan or inf
         if math.isnan(value) or math.isinf(value):
             log.debug("ignoring not real metric %s:%s", key, value)
             return
 
-        if key in self._meta:
-            del self._meta[key]
         self._metrics[key] = value
+        # Ensure we do not have the same key in both meta and metrics
+        self._meta.pop(key, None)
 
-    def set_metrics(self, metrics: _MetricDictType) -> None:
+    def set_metrics(self, metrics: dict[str, NumericType]) -> None:
         """Set a dictionary of metrics on the given span. Keys must be
         must be strings (or stringable). Values must be numeric.
         """
-        if metrics:
-            for k, v in metrics.items():
-                self.set_metric(k, v)
+        for k, v in metrics.items():
+            self.set_metric(k, v)
 
-    def get_metric(self, key: _TagNameType) -> Optional[NumericType]:
+    def get_metric(self, key: str) -> Optional[NumericType]:
         """Return the given metric or None if it doesn't exist."""
         return self._metrics.get(key)
 
@@ -496,7 +433,7 @@ def _add_on_finish_exception_callback(self, callback: Callable[["Span"], None]):
         """Add an errortracking related callback to the on_finish_callback array"""
         self._on_finish_callbacks.insert(0, callback)
 
-    def get_metrics(self) -> _MetricDictType:
+    def get_metrics(self) -> dict[str, NumericType]:
         """Return all metrics."""
         return self._metrics.copy()
 

ddtrace/_trace/types.py

@@ -1,14 +1,7 @@
-from typing import Dict
 from typing import Sequence
-from typing import Text
 from typing import Union
 
-from ddtrace.internal.compat import NumericType
 
-
-_TagNameType = Union[Text, bytes]
-_MetaDictType = Dict[_TagNameType, Text]
-_MetricDictType = Dict[_TagNameType, NumericType]
 _AttributeValueType = Union[
     str,
     bool,

ddtrace/_trace/utils_botocore/aws_payload_tagging.py

@@ -198,7 +198,7 @@ def _tag_object(self, span: Span, key: str, obj: Any, depth: int = 0) -> None:
         """
         # if we've hit the maximum allowed tags, mark the expansion as incomplete
         if self.current_tag_count >= config.botocore.get("payload_tagging_max_tags"):
-            span.set_tag(self._INCOMPLETE_TAG, True)
+            span.set_tag(self._INCOMPLETE_TAG, str(True))
             return
         if obj is None:
             self.current_tag_count += 1

ddtrace/appsec/ai_guard/_api_client.py

@@ -1,4 +1,5 @@
 """AI Guard client for security evaluation of agentic AI workflows."""
+
 import json
 from typing import Any
 from typing import Dict
@@ -104,11 +105,11 @@ def evaluate_tool(
         tool_name: str,
         tool_args: Dict[Union[Text, bytes], Any],
         output: Optional[str] = None,
-        tags: Optional[Dict[Union[Text, bytes], Any]] = None,
+        tags: Optional[dict[str, str]] = None,
     ) -> bool:
         return self._client.evaluate_tool(tool_name, tool_args, output=output, history=self._history, tags=tags)
 
-    def evaluate_prompt(self, role: str, content: str, tags: Optional[Dict[Union[Text, bytes], Any]] = None) -> bool:
+    def evaluate_prompt(self, role: str, content: str, tags: Optional[dict[str, str]] = None) -> bool:
         return self._client.evaluate_prompt(role, content, history=self._history, tags=tags)
 
 
@@ -149,7 +150,7 @@ def evaluate_tool(
         tool_args: Dict[Union[Text, bytes], Any],
         output: Optional[str] = None,
         history: Optional[List[Evaluation]] = None,
-        tags: Optional[Dict[Union[Text, bytes], Any]] = None,
+        tags: Optional[dict[str, str]] = None,
     ) -> bool:
         """Evaluate if a tool call is safe to execute.
 
@@ -187,7 +188,7 @@ def evaluate_prompt(
         content: str,
         output: Optional[str] = None,
         history: Optional[List[Evaluation]] = None,
-        tags: Optional[Dict[Union[Text, bytes], Any]] = None,
+        tags: Optional[dict[str, str]] = None,
     ) -> bool:
         """Evaluate if a prompt is safe to execute.
 
@@ -269,7 +270,7 @@ def truncate_content(evaluation: Evaluation) -> Evaluation:
                 TELEMETRY_NAMESPACE.APPSEC, AI_GUARD.TRUNCATED_METRIC, 1, (("type", "content"),)
             )
 
-    def _evaluate(self, current: Evaluation, history: List[Evaluation], tags: Dict[Union[Text, bytes], Any]) -> bool:
+    def _evaluate(self, current: Evaluation, history: List[Evaluation], tags: dict[str, str]) -> bool:
         """Send evaluation request to AI Guard service."""
         with self._tracer.trace(AI_GUARD.RESOURCE_TYPE) as span:
             if tags is not None:

ddtrace/debugging/_signal/tracing.py

@@ -50,7 +50,7 @@ def enter(self, scope: t.Mapping[str, t.Any]) -> None:
         )
         span = self._span_cm.__enter__()
 
-        span.set_tags(probe.tags)  # type: ignore[arg-type]
+        span.set_tags(probe.tags)
         span.set_tag_str(PROBE_ID_TAG_NAME, probe.probe_id)
         span.set_tag_str(_ORIGIN_KEY, "di")
 

ddtrace/internal/ci_visibility/filters.py

@@ -18,7 +18,7 @@
 
 class TraceCiVisibilityFilter(TraceFilter):
     def __init__(self, tags, service):
-        # type: (Dict[Union[str, bytes], str], str) -> None
+        # type: (Dict[str, str], str) -> None
         self._tags = tags
         self._service = service
 

ddtrace/internal/ci_visibility/utils.py

@@ -70,9 +70,9 @@ def _add_start_end_source_file_path_data_to_span(
         log.debug("Tried to collect source start/end lines for test method %s but an exception was raised", test_name)
     span.set_tag_str(test.SOURCE_FILE, source_file_path)
     if start_line:
-        span.set_tag(test.SOURCE_START, start_line)
+        span.set_metric(test.SOURCE_START, start_line)
     if end_line:
-        span.set_tag(test.SOURCE_END, end_line)
+        span.set_metric(test.SOURCE_END, end_line)
 
 
 def _add_pct_covered_to_span(coverage_data: dict, span: ddtrace.trace.Span):
@@ -83,7 +83,7 @@ def _add_pct_covered_to_span(coverage_data: dict, span: ddtrace.trace.Span):
     if not isinstance(lines_pct_value, float):
         log.warning("Tried to add total covered percentage to session span but the format was unexpected")
         return
-    span.set_tag(test.TEST_LINES_PCT, lines_pct_value)
+    span.set_metric(test.TEST_LINES_PCT, lines_pct_value)
 
 
 def _generate_fully_qualified_test_name(test_module_path: str, test_suite_name: str, test_name: str) -> str:

ddtrace/internal/opentelemetry/span.py

@@ -42,7 +42,10 @@ def _ddmap(span, attribute, value):
     if attribute.startswith("meta") or attribute.startswith("metrics"):
         meta_key = attribute.split("'")[1] if len(attribute.split("'")) == 3 else None
         if meta_key:
-            span.set_tag(meta_key, value)
+            if isinstance(value, bytes):
+                span.set_tag(meta_key, value.decode("utf-8", errors="replace"))
+            else:
+                span.set_metric(meta_key, value)
     else:
         setattr(span, attribute, value)
     return span

ddtrace/internal/opentelemetry/trace.py

@@ -30,7 +30,6 @@
     from opentelemetry.trace import Link as OtelLink  # noqa:F401
     from opentelemetry.util.types import AttributeValue as OtelAttributeValue  # noqa:F401
 
-    from ddtrace._trace.span import _MetaDictType  # noqa:F401
     from ddtrace.trace import Tracer as DDTracer  # noqa:F401