telemetry-dev 0.2.5__tar.gz → 0.2.7__tar.gz

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telemetry-dev
-Version: 0.2.5
+Version: 0.2.7
 Summary: telemetry.dev SDK for Python — OpenTelemetry-native GenAI tracing, logs, and metrics
 Keywords: telemetry,opentelemetry,llm,genai,tracing,observability
 Author: telemetry.dev
@@ -14,9 +14,9 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
-Requires-Dist: opentelemetry-api>=1.35.0,<2
-Requires-Dist: opentelemetry-sdk>=1.35.0,<2
-Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.35.0,<2
+Requires-Dist: opentelemetry-api>=1.39.0,<2
+Requires-Dist: opentelemetry-sdk>=1.39.0,<2
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.39.0,<2
 Requires-Python: >=3.10
 Project-URL: Homepage, https://telemetry.dev
 Project-URL: Repository, https://github.com/telemetry-dev/telemetry
@@ -135,9 +135,12 @@ the core SDK with provider integrations to enable the new metric.
 ### Span fields (start/update/end)
 
 `input`, `output`, `model`, `provider`, `system_instructions`, `response_model`, `response_id`,
-`output_type`, `finish_reason`, `usage` (dict with exactly `input_tokens`, `output_tokens`,
+`output_type`, `finish_reason`, `usage` (dict with `input_tokens`, `output_tokens`,
 `total_tokens`, `cache_read_input_tokens`, `cache_creation_input_tokens`,
-`reasoning_output_tokens`), `cost_usd`, `temperature`, `top_p`, `top_k`, `max_tokens`,
+`reasoning_output_tokens`, `text_input_tokens`, `text_output_tokens`, `image_input_tokens`,
+`image_output_tokens`, `audio_input_tokens`, `audio_output_tokens`,
+`text_cache_read_input_tokens`, `image_cache_read_input_tokens`, and
+`audio_cache_read_input_tokens`), `cost_usd`, `temperature`, `top_p`, `top_k`, `max_tokens`,
 `stop_sequences`, `seed`, `frequency_penalty`, `presence_penalty`, `time_to_first_chunk_ms`,
 `tool_name`, `tool_call_id`, `tool_description`, `agent_name`, `agent_id`, `metadata`
 (→ `td.metadata.*`, this span only), `attributes` (raw escape hatch, merged last), `error`.

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/README.md

@@ -111,9 +111,12 @@ the core SDK with provider integrations to enable the new metric.
 ### Span fields (start/update/end)
 
 `input`, `output`, `model`, `provider`, `system_instructions`, `response_model`, `response_id`,
-`output_type`, `finish_reason`, `usage` (dict with exactly `input_tokens`, `output_tokens`,
+`output_type`, `finish_reason`, `usage` (dict with `input_tokens`, `output_tokens`,
 `total_tokens`, `cache_read_input_tokens`, `cache_creation_input_tokens`,
-`reasoning_output_tokens`), `cost_usd`, `temperature`, `top_p`, `top_k`, `max_tokens`,
+`reasoning_output_tokens`, `text_input_tokens`, `text_output_tokens`, `image_input_tokens`,
+`image_output_tokens`, `audio_input_tokens`, `audio_output_tokens`,
+`text_cache_read_input_tokens`, `image_cache_read_input_tokens`, and
+`audio_cache_read_input_tokens`), `cost_usd`, `temperature`, `top_p`, `top_k`, `max_tokens`,
 `stop_sequences`, `seed`, `frequency_penalty`, `presence_penalty`, `time_to_first_chunk_ms`,
 `tool_name`, `tool_call_id`, `tool_description`, `agent_name`, `agent_id`, `metadata`
 (→ `td.metadata.*`, this span only), `attributes` (raw escape hatch, merged last), `error`.

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "telemetry-dev"
-version = "0.2.5"
+version = "0.2.7"
 description = "telemetry.dev SDK for Python — OpenTelemetry-native GenAI tracing, logs, and metrics"
 readme = "README.md"
 license = "MIT"
@@ -25,9 +25,9 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "opentelemetry-api>=1.35.0,<2",
-    "opentelemetry-sdk>=1.35.0,<2",
-    "opentelemetry-exporter-otlp-proto-http>=1.35.0,<2",
+    "opentelemetry-api>=1.39.0,<2",
+    "opentelemetry-sdk>=1.39.0,<2",
+    "opentelemetry-exporter-otlp-proto-http>=1.39.0,<2",
 ]
 
 [[project.authors]]

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "telemetry-dev"
-version = "0.2.5"
+version = "0.2.7"
 description = "telemetry.dev SDK for Python — OpenTelemetry-native GenAI tracing, logs, and metrics"
 readme = "README.md"
 license = "MIT"
@@ -19,9 +19,9 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-  "opentelemetry-api>=1.35.0,<2",
-  "opentelemetry-sdk>=1.35.0,<2",
-  "opentelemetry-exporter-otlp-proto-http>=1.35.0,<2",
+  "opentelemetry-api>=1.39.0,<2",
+  "opentelemetry-sdk>=1.39.0,<2",
+  "opentelemetry-exporter-otlp-proto-http>=1.39.0,<2",
 ]
 
 [project.urls]

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/src/telemetry_dev/_capture.py

@@ -122,31 +122,34 @@ class CaptureBudget:
         if value_id in seen:
             return byte_count, item_count
         seen.add(value_id)
-        mapping: dict[object, object] | None = None
-        children: Iterable[object] = ()
-        if isinstance(value, dict):
-            mapping = cast("dict[object, object]", value)
-        elif isinstance(value, list | tuple | set | frozenset):
-            children = cast("Iterable[object]", value)
-        else:
-            attributes = getattr(value, "__dict__", None)
-            if isinstance(attributes, dict):
-                mapping = cast("dict[object, object]", attributes)
-
-        if mapping is not None:
-            children = chain.from_iterable(mapping.items())
-
-        for child in children:
-            measured = cls._measure(
-                child,
-                remaining_bytes=remaining_bytes - byte_count,
-                remaining_items=remaining_items - item_count,
-                depth=depth + 1,
-                seen=seen,
-            )
-            if measured is None:
-                return None
-            child_bytes, child_items = measured
-            byte_count += child_bytes
-            item_count += child_items
-        return byte_count, item_count
+        try:
+            mapping: dict[object, object] | None = None
+            children: Iterable[object] = ()
+            if isinstance(value, dict):
+                mapping = cast("dict[object, object]", value)
+            elif isinstance(value, list | tuple | set | frozenset):
+                children = cast("Iterable[object]", value)
+            else:
+                attributes = getattr(value, "__dict__", None)
+                if isinstance(attributes, dict):
+                    mapping = cast("dict[object, object]", attributes)
+
+            if mapping is not None:
+                children = chain.from_iterable(mapping.items())
+
+            for child in children:
+                measured = cls._measure(
+                    child,
+                    remaining_bytes=remaining_bytes - byte_count,
+                    remaining_items=remaining_items - item_count,
+                    depth=depth + 1,
+                    seen=seen,
+                )
+                if measured is None:
+                    return None
+                child_bytes, child_items = measured
+                byte_count += child_bytes
+                item_count += child_items
+            return byte_count, item_count
+        finally:
+            seen.remove(value_id)

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/src/telemetry_dev/_client.py

@@ -41,7 +41,12 @@ from ._config import (
     resolve_config,
 )
 from ._context import SessionSampler
-from ._metrics import GuardedOTLPMetricExporter, MetricsRecorder, OutputChunkAggregation
+from ._metrics import (
+    GuardedOTLPMetricExporter,
+    MetricsRecorder,
+    OutputChunkAggregation,
+    sdk_meter_provider,
+)
 from ._processor import ExportMode, StampingSpanProcessor
 from ._semconv import SCOPE_NAME
 from ._serialize import Mask, serialize_content
@@ -207,9 +212,7 @@ class Client:
             )
         metrics_recorder: MetricsRecorder | None = None
         if metric_reader is not None:
-            self._meter_provider = MeterProvider(
-                metric_readers=[metric_reader], resource=resource, shutdown_on_exit=False
-            )
+            self._meter_provider = sdk_meter_provider(metric_reader, resource)
             meter = self._meter_provider.get_meter(SCOPE_NAME, SDK_VERSION)
             metrics_recorder = MetricsRecorder(
                 meter, on_error=on_error, output_chunks=self._output_chunks

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/src/telemetry_dev/_metrics.py

@@ -9,16 +9,20 @@ from typing import Any
 
 from opentelemetry.exporter.otlp.proto.http.metric_exporter import OTLPMetricExporter
 from opentelemetry.metrics import Meter
+from opentelemetry.sdk.metrics import MeterProvider
 from opentelemetry.sdk.metrics.export import (
     AggregationTemporality,
     Histogram,
     HistogramDataPoint,
     Metric,
     MetricExportResult,
+    MetricReader,
     MetricsData,
     ResourceMetrics,
     ScopeMetrics,
 )
+from opentelemetry.sdk.metrics.view import DropAggregation, View
+from opentelemetry.sdk.resources import Resource
 from opentelemetry.sdk.trace import ReadableSpan
 from opentelemetry.trace import INVALID_SPAN_CONTEXT, NonRecordingSpan, set_span_in_context
 
@@ -41,6 +45,23 @@ _MAX_CHUNK_ATTRIBUTE_SETS = 2000
 _CHUNK_METRIC_NAME = "gen_ai.client.operation.time_per_output_chunk"
 
 
+def sdk_meter_provider(reader: MetricReader, resource: Resource) -> MeterProvider:
+    return MeterProvider(
+        metric_readers=[reader],
+        resource=resource,
+        shutdown_on_exit=False,
+        # OpenTelemetry records metric-reader metrics on the reader's own provider (always in
+        # 1.41, opt-in from 1.42); they must not be exported to telemetry.dev.
+        views=[
+            View(
+                meter_name="opentelemetry-sdk",
+                instrument_name="otel.sdk.*",
+                aggregation=DropAggregation(),
+            )
+        ],
+    )
+
+
 @dataclass
 class _ChunkAggregate:
     count: int

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/src/telemetry_dev/_semconv.py

@@ -91,6 +91,15 @@ USAGE_ATTRS: dict[str, str] = {
     "cache_read_input_tokens": "gen_ai.usage.cache_read.input_tokens",
     "cache_creation_input_tokens": "gen_ai.usage.cache_creation.input_tokens",
     "reasoning_output_tokens": "gen_ai.usage.reasoning.output_tokens",
+    "text_input_tokens": "gen_ai.usage.text.input_tokens",
+    "text_output_tokens": "gen_ai.usage.text.output_tokens",
+    "text_cache_read_input_tokens": "gen_ai.usage.text.cache_read.input_tokens",
+    "image_input_tokens": "gen_ai.usage.image.input_tokens",
+    "image_output_tokens": "gen_ai.usage.image.output_tokens",
+    "image_cache_read_input_tokens": "gen_ai.usage.image.cache_read.input_tokens",
+    "audio_input_tokens": "gen_ai.usage.audio.input_tokens",
+    "audio_output_tokens": "gen_ai.usage.audio.output_tokens",
+    "audio_cache_read_input_tokens": "gen_ai.usage.audio.cache_read.input_tokens",
 }
 
 SAMPLING_ATTRS: dict[str, str] = {

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/src/telemetry_dev/_spans.py

@@ -72,7 +72,7 @@ NOT_GIVEN: Any = _NotGiven()
 
 
 class Usage(TypedDict, total=False):
-    """Token usage — exactly these six fields are emitted; unknown keys are dropped."""
+    """Token usage; unknown keys are dropped."""
 
     input_tokens: int
     output_tokens: int
@@ -80,6 +80,15 @@ class Usage(TypedDict, total=False):
     cache_read_input_tokens: int
     cache_creation_input_tokens: int
     reasoning_output_tokens: int
+    text_input_tokens: int
+    text_output_tokens: int
+    text_cache_read_input_tokens: int
+    image_input_tokens: int
+    image_output_tokens: int
+    image_cache_read_input_tokens: int
+    audio_input_tokens: int
+    audio_output_tokens: int
+    audio_cache_read_input_tokens: int
 
 
 ParentType = str | Context | SpanContext | None

{telemetry_dev-0.2.5 → telemetry_dev-0.2.7}/src/telemetry_dev/otel.py

@@ -22,7 +22,7 @@ from opentelemetry.sdk.trace import ReadableSpan, Span, SpanProcessor
 from opentelemetry.sdk.trace.export import SpanExporter, SpanExportResult
 
 from ._config import SDK_VERSION, logger, report_error, resolve_config
-from ._metrics import GuardedOTLPMetricExporter, MetricsRecorder
+from ._metrics import GuardedOTLPMetricExporter, MetricsRecorder, sdk_meter_provider
 from ._processor import ExportMode, StampingSpanProcessor
 from ._semconv import SCOPE_NAME
 
@@ -137,9 +137,7 @@ class TelemetrySpanProcessor(SpanProcessor):
                     else _DORMANT_METRIC_INTERVAL_MILLIS
                 ),
             )
-            self._meter_provider = MeterProvider(
-                metric_readers=[reader], resource=resource, shutdown_on_exit=False
-            )
+            self._meter_provider = sdk_meter_provider(reader, resource)
             meter = self._meter_provider.get_meter(SCOPE_NAME, SDK_VERSION)
             metrics_recorder = MetricsRecorder(meter, on_error=on_error)