telemetry-dev 0.2.6__tar.gz → 0.2.8__tar.gz

{telemetry_dev-0.2.6 → telemetry_dev-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telemetry-dev
-Version: 0.2.6
+Version: 0.2.8
 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
@@ -159,14 +159,19 @@ the core SDK with provider integrations to enable the new metric.
 | `log_level` | `"warn"` | SDK diagnostics level: `debug`/`info`/`warn`/`error`/`silent`. |
 | `capture_input`, `capture_output` | `True` | Global content-capture defaults. |
 | `mask` | `None` | `Callable[[Any, MaskContext], Any]` redaction hook, runs before JSON serialization on input/output/log messages (`MaskContext.key` is the attribute being written). Not applied to correlation identifiers. |
-| `max_attribute_length` | `65536` | Per-content-attribute cap; truncated values get an ASCII `...[truncated]` marker appended. |
+| `max_attribute_length` | `65536` | Non-negative integer per-content-attribute cap. Invalid values call `on_error`, do not raise into application code, and install a disabled client; truncated values use the ASCII `...[truncated]` marker, or its prefix when the cap is shorter than the marker. The cap also applies, with the marker, to string metadata and log attributes; any other string attribute is cut at the cap without a marker, except that a cap of `0` leaves those at 65536. |
 | `span_filter` | `None` | Export predicate `Callable[[ReadableSpan], bool]`. |
 | `sampler` | OTel environment configuration | OTel `Sampler` that overrides environment settings. Session roots use its root policy. Real parents keep their sampling decisions. |
-| `on_error` | `None` | Receives every internal SDK error; the SDK never raises. |
+| `on_error` | `None` | Receives internal SDK errors; repeated instrumentation failures from one stream may be coalesced into one report. The SDK never raises them into application code. |
 | `disable_atexit` | `False` | Skip the automatic atexit shutdown. |
 | `timeout` | `10.0` | OTLP HTTP timeout in seconds. |
 | `span_exporter`, `log_exporter`, `metric_reader` | `None` | Test seams / offline mode; any of them enables the client without an API key. |
 
+`capture_input=False` and `capture_output=False` omit captured content. Provider integrations may
+still record non-content metadata such as response IDs and models, finish reasons, usage, timing,
+and errors. Capture flags do not gate stop sequences, tool descriptions and definitions (`gen_ai.tool.description`, `gen_ai.tool.definitions`), caller-supplied metadata or raw attributes,
+or exception messages and stack traces; redact those separately when needed.
+
 Session roots share trace IDs from the API key and session ID. The hash matches the TypeScript SDK.
 The SDK uses the configured OTel sampling policy, not the synthetic parent's flags.
 For example, `init(sampler=ParentBased(TraceIdRatioBased(0.1)))` samples sessions with OTel's ratio sampler.

{telemetry_dev-0.2.6 → telemetry_dev-0.2.8}/README.md

@@ -135,14 +135,19 @@ the core SDK with provider integrations to enable the new metric.
 | `log_level` | `"warn"` | SDK diagnostics level: `debug`/`info`/`warn`/`error`/`silent`. |
 | `capture_input`, `capture_output` | `True` | Global content-capture defaults. |
 | `mask` | `None` | `Callable[[Any, MaskContext], Any]` redaction hook, runs before JSON serialization on input/output/log messages (`MaskContext.key` is the attribute being written). Not applied to correlation identifiers. |
-| `max_attribute_length` | `65536` | Per-content-attribute cap; truncated values get an ASCII `...[truncated]` marker appended. |
+| `max_attribute_length` | `65536` | Non-negative integer per-content-attribute cap. Invalid values call `on_error`, do not raise into application code, and install a disabled client; truncated values use the ASCII `...[truncated]` marker, or its prefix when the cap is shorter than the marker. The cap also applies, with the marker, to string metadata and log attributes; any other string attribute is cut at the cap without a marker, except that a cap of `0` leaves those at 65536. |
 | `span_filter` | `None` | Export predicate `Callable[[ReadableSpan], bool]`. |
 | `sampler` | OTel environment configuration | OTel `Sampler` that overrides environment settings. Session roots use its root policy. Real parents keep their sampling decisions. |
-| `on_error` | `None` | Receives every internal SDK error; the SDK never raises. |
+| `on_error` | `None` | Receives internal SDK errors; repeated instrumentation failures from one stream may be coalesced into one report. The SDK never raises them into application code. |
 | `disable_atexit` | `False` | Skip the automatic atexit shutdown. |
 | `timeout` | `10.0` | OTLP HTTP timeout in seconds. |
 | `span_exporter`, `log_exporter`, `metric_reader` | `None` | Test seams / offline mode; any of them enables the client without an API key. |
 
+`capture_input=False` and `capture_output=False` omit captured content. Provider integrations may
+still record non-content metadata such as response IDs and models, finish reasons, usage, timing,
+and errors. Capture flags do not gate stop sequences, tool descriptions and definitions (`gen_ai.tool.description`, `gen_ai.tool.definitions`), caller-supplied metadata or raw attributes,
+or exception messages and stack traces; redact those separately when needed.
+
 Session roots share trace IDs from the API key and session ID. The hash matches the TypeScript SDK.
 The SDK uses the configured OTel sampling policy, not the synthetic parent's flags.
 For example, `init(sampler=ParentBased(TraceIdRatioBased(0.1)))` samples sessions with OTel's ratio sampler.

{telemetry_dev-0.2.6 → telemetry_dev-0.2.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "telemetry-dev"
-version = "0.2.6"
+version = "0.2.8"
 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.6 → telemetry_dev-0.2.8}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "telemetry-dev"
-version = "0.2.6"
+version = "0.2.8"
 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.6 → telemetry_dev-0.2.8}/src/telemetry_dev/_capture.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from collections.abc import Iterable
+from collections.abc import Iterable, Mapping, Sequence
 from itertools import chain
 from typing import Final, cast
 
@@ -123,16 +123,18 @@ class CaptureBudget:
             return byte_count, item_count
         seen.add(value_id)
         try:
-            mapping: dict[object, object] | None = None
+            mapping: Mapping[object, object] | None = None
             children: Iterable[object] = ()
-            if isinstance(value, dict):
-                mapping = cast("dict[object, object]", value)
-            elif isinstance(value, list | tuple | set | frozenset):
+            if isinstance(value, Mapping):
+                mapping = cast("Mapping[object, object]", value)
+            elif isinstance(value, Sequence) and not isinstance(value, str | bytes | bytearray):
+                children = cast("Iterable[object]", value)
+            elif isinstance(value, set | frozenset):
                 children = cast("Iterable[object]", value)
             else:
                 attributes = getattr(value, "__dict__", None)
-                if isinstance(attributes, dict):
-                    mapping = cast("dict[object, object]", attributes)
+                if isinstance(attributes, Mapping):
+                    mapping = cast("Mapping[object, object]", attributes)
 
             if mapping is not None:
                 children = chain.from_iterable(mapping.items())

{telemetry_dev-0.2.6 → telemetry_dev-0.2.8}/src/telemetry_dev/_client.py

@@ -41,10 +41,15 @@ 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
+from ._serialize import DEFAULT_MAX_ATTRIBUTE_LENGTH, Mask, serialize_content
 
 _lock = threading.RLock()
 _client: Client | None = None
@@ -177,14 +182,16 @@ class Client:
         )
 
         # The funnel keeps capped content (marker included) within max_attribute_length, so
-        # the backstop can use the same cap for raw attributes set outside the funnel.
+        # the backstop can use the same cap for raw attributes set outside the funnel. A zero
+        # cap only drops content; as a backstop it would blank every string attribute.
+        backstop_length = max_attribute_length or DEFAULT_MAX_ATTRIBUTE_LENGTH
         self._tracer_provider = TracerProvider(
             resource=resource,
             sampler=sampler,
             shutdown_on_exit=False,
             span_limits=SpanLimits(
-                max_attribute_length=max_attribute_length,
-                max_span_attribute_length=max_attribute_length,
+                max_attribute_length=backstop_length,
+                max_span_attribute_length=backstop_length,
             ),
         )
         self._tracer_provider.sampler = SessionSampler(self._tracer_provider.sampler)
@@ -207,9 +214,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
@@ -362,6 +367,14 @@ def init(
     try:
         if session_mode not in ("explicit", "process"):
             raise ValueError(f"invalid session_mode: {session_mode!r}")
+        raw_max_attribute_length: Any = max_attribute_length
+        if (
+            isinstance(raw_max_attribute_length, bool)
+            or not isinstance(raw_max_attribute_length, int)
+            or raw_max_attribute_length < 0
+        ):
+            raise ValueError("max_attribute_length must be a non-negative integer")
+        max_attribute_length = raw_max_attribute_length
         client = Client(
             config=config,
             enabled=effective_enabled,

{telemetry_dev-0.2.6 → telemetry_dev-0.2.8}/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.6 → telemetry_dev-0.2.8}/src/telemetry_dev/_serialize.py

@@ -31,9 +31,9 @@ def truncate(text: str, max_len: int) -> str:
     encoded = text.encode("utf-16-le")
     if len(encoded) <= max_len * 2:
         return text
-    # Total stays within max_len so the provider's attribute_value_length_limit backstop,
-    # set to the same cap, never slices the marker off.
-    head = encoded[: max(max_len - len(TRUNCATION_MARKER), 0) * 2]
+    if max_len < len(TRUNCATION_MARKER):
+        return TRUNCATION_MARKER[: max(max_len, 0)]
+    head = encoded[: (max_len - len(TRUNCATION_MARKER)) * 2]
     try:
         return head.decode("utf-16-le") + TRUNCATION_MARKER
     except UnicodeDecodeError:

{telemetry_dev-0.2.6 → telemetry_dev-0.2.8}/src/telemetry_dev/_spans.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import math
+import sys
 import threading
 import time
 import traceback
@@ -267,7 +268,7 @@ def _fields_to_attributes(
         for key, value in raw.items():
             attr = coerce_attr_value(
                 value,
-                max_len=client.max_attribute_length,
+                max_len=sys.maxsize,
                 key=key,
                 on_error=client.on_error,
             )
@@ -379,6 +380,22 @@ class SpanHandle:
         self._context_token: Token[Context] | None = None
         self._ended = False
 
+    @property
+    def capture_output(self) -> bool:
+        return self._state.capture_output if self._state is not None else False
+
+    @property
+    def capture_masked(self) -> bool:
+        return self._client is not None and self._client.mask is not None
+
+    @property
+    def max_attribute_length(self) -> int:
+        return self._client.max_attribute_length if self._client is not None else 0
+
+    def report_error(self, cause: BaseException) -> None:
+        if self._client is not None:
+            self._client.report("provider instrumentation failed", cause)
+
     def _recording(self) -> bool:
         return (
             self._client is not None

{telemetry_dev-0.2.6 → telemetry_dev-0.2.8}/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)