microsoft-agents-a365-observability-core 0.2.1.dev35__tar.gz → 0.2.1.dev42__tar.gz

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-a365-observability-core
-Version: 0.2.1.dev35
+Version: 0.2.1.dev42
 Summary: Telemetry, tracing, and monitoring components for AI agents
 Author-email: Microsoft <support@microsoft.com>
 License: MIT

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365/observability/core/__init__.py

@@ -12,12 +12,14 @@ from .config import (
 )
 from .execute_tool_scope import ExecuteToolScope
 from .execution_type import ExecutionType
+from .exporters.agent365_exporter_options import Agent365ExporterOptions
 from .exporters.enriched_span import EnrichedReadableSpan
 from .exporters.enriching_span_processor import (
     get_span_enricher,
     register_span_enricher,
     unregister_span_enricher,
 )
+from .exporters.spectra_exporter_options import SpectraExporterOptions
 from .inference_call_details import InferenceCallDetails, ServiceEndpoint
 from .inference_operation_type import InferenceOperationType
 from .inference_scope import InferenceScope
@@ -38,6 +40,9 @@ __all__ = [
     "is_configured",
     "get_tracer",
     "get_tracer_provider",
+    # Exporter options
+    "Agent365ExporterOptions",
+    "SpectraExporterOptions",
     # Span enrichment
     "register_span_enricher",
     "unregister_span_enricher",

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365/observability/core/config.py

@@ -8,6 +8,9 @@ from collections.abc import Callable
 from typing import Any, Optional
 
 from opentelemetry import trace
+from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import (
+    OTLPSpanExporter as GrpcOTLPSpanExporter,
+)
 from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
 from opentelemetry.sdk.resources import SERVICE_NAME, SERVICE_NAMESPACE, Resource
 from opentelemetry.sdk.trace import TracerProvider
@@ -18,6 +21,7 @@ from .exporters.agent365_exporter_options import Agent365ExporterOptions
 from .exporters.enriching_span_processor import (
     _EnrichingBatchSpanProcessor,
 )
+from .exporters.spectra_exporter_options import SpectraExporterOptions
 from .exporters.utils import is_agent365_exporter_enabled
 from .trace_processor.span_processor import SpanProcessor
 
@@ -58,7 +62,7 @@ class TelemetryManager:
         logger_name: str = DEFAULT_LOGGER_NAME,
         token_resolver: Callable[[str, str], str | None] | None = None,
         cluster_category: str = "prod",
-        exporter_options: Optional[Agent365ExporterOptions] = None,
+        exporter_options: Agent365ExporterOptions | SpectraExporterOptions | None = None,
         suppress_invoke_agent_input: bool = False,
         **kwargs: Any,
     ) -> bool:
@@ -72,9 +76,10 @@ class TelemetryManager:
             Use exporter_options instead.
         :param cluster_category: (Deprecated) Environment / cluster category (e.g. "prod").
             Use exporter_options instead.
-        :param exporter_options: Agent365ExporterOptions instance for configuring the exporter.
-            If provided, exporter_options takes precedence. If exporter_options is None, the token_resolver and cluster_category parameters are used as fallback/legacy support to construct a default Agent365ExporterOptions instance.
-        :param suppress_invoke_agent_input: If True, suppress input messages for spans that are children of InvokeAgent spans.
+        :param exporter_options: Exporter configuration. Pass Agent365ExporterOptions for A365 API
+            export, SpectraExporterOptions for Spectra Collector sidecar export, or None (default)
+            to construct Agent365ExporterOptions from legacy parameters.
+        :param suppress_invoke_agent_input: If True, suppress input messages for InvokeAgent spans.
         :return: True if configuration succeeded, False otherwise.
         """
         try:
@@ -100,7 +105,7 @@ class TelemetryManager:
         logger_name: str,
         token_resolver: Callable[[str, str], str | None] | None = None,
         cluster_category: str = "prod",
-        exporter_options: Optional[Agent365ExporterOptions] = None,
+        exporter_options: Agent365ExporterOptions | SpectraExporterOptions | None = None,
         suppress_invoke_agent_input: bool = False,
         **kwargs: Any,
     ) -> bool:
@@ -156,25 +161,43 @@ class TelemetryManager:
             "max_export_batch_size": exporter_options.max_export_batch_size,
         }
 
-        if is_agent365_exporter_enabled() and exporter_options.token_resolver is not None:
+        # Type-based exporter dispatch
+        if isinstance(exporter_options, SpectraExporterOptions):
+            # Spectra path — OTLP exporter to sidecar
+            # ENABLE_A365_OBSERVABILITY_EXPORTER is intentionally ignored.
+            if exporter_options.protocol == "grpc":
+                exporter = GrpcOTLPSpanExporter(
+                    endpoint=exporter_options.endpoint,
+                    insecure=exporter_options.insecure,
+                )
+            else:
+                exporter = OTLPSpanExporter(
+                    endpoint=exporter_options.endpoint,
+                )
+
+        elif is_agent365_exporter_enabled() and exporter_options.token_resolver is not None:
             exporter = _Agent365Exporter(
                 token_resolver=exporter_options.token_resolver,
                 cluster_category=exporter_options.cluster_category,
                 use_s2s_endpoint=exporter_options.use_s2s_endpoint,
-                suppress_invoke_agent_input=suppress_invoke_agent_input,
             )
 
         else:
             exporter = ConsoleSpanExporter()
             self._logger.warning(
-                "is_agent365_exporter_enabled() not enabled or token_resolver not set. Falling back to console exporter."
+                "is_agent365_exporter_enabled() not enabled or token_resolver not set."
+                " Falling back to console exporter."
             )
 
         # Add span processors
 
         # Create _EnrichingBatchSpanProcessor with optimized settings
         # This allows extensions to enrich spans before export
-        batch_processor = _EnrichingBatchSpanProcessor(exporter, **batch_processor_kwargs)
+        batch_processor = _EnrichingBatchSpanProcessor(
+            exporter,
+            suppress_invoke_agent_input=suppress_invoke_agent_input,
+            **batch_processor_kwargs,
+        )
         agent_processor = SpanProcessor()
 
         tracer_provider.add_span_processor(batch_processor)
@@ -248,7 +271,8 @@ def configure(
     logger_name: str = DEFAULT_LOGGER_NAME,
     token_resolver: Callable[[str, str], str | None] | None = None,
     cluster_category: str = "prod",
-    exporter_options: Optional[Agent365ExporterOptions] = None,
+    exporter_options: Agent365ExporterOptions | SpectraExporterOptions | None = None,
+    suppress_invoke_agent_input: bool = False,
     **kwargs: Any,
 ) -> bool:
     """
@@ -261,8 +285,10 @@ def configure(
         Use exporter_options instead.
     :param cluster_category: (Deprecated) Environment / cluster category (e.g. "prod").
         Use exporter_options instead.
-    :param exporter_options: Agent365ExporterOptions instance for configuring the exporter.
-        If provided, exporter_options takes precedence. If exporter_options is None, the token_resolver and cluster_category parameters are used as fallback/legacy support to construct a default Agent365ExporterOptions instance.
+    :param exporter_options: Exporter configuration. Pass Agent365ExporterOptions for A365 API
+        export, SpectraExporterOptions for Spectra Collector sidecar export, or None (default)
+        to construct Agent365ExporterOptions from legacy parameters.
+    :param suppress_invoke_agent_input: If True, suppress input messages for InvokeAgent spans.
     :return: True if configuration succeeded, False otherwise.
     """
     return _telemetry_manager.configure(
@@ -272,6 +298,7 @@ def configure(
         token_resolver,
         cluster_category,
         exporter_options,
+        suppress_invoke_agent_input,
         **kwargs,
     )
 

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365/observability/core/exporters/__init__.py

@@ -2,7 +2,8 @@
 # Licensed under the MIT License.
 
 from .agent365_exporter_options import Agent365ExporterOptions
+from .spectra_exporter_options import SpectraExporterOptions
 
 # Agent365Exporter is not exported intentionally.
 # It should only be used internally by the observability core module.
-__all__ = ["Agent365ExporterOptions"]
+__all__ = ["Agent365ExporterOptions", "SpectraExporterOptions"]

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365/observability/core/exporters/agent365_exporter.py

@@ -17,17 +17,13 @@ from opentelemetry.sdk.trace import ReadableSpan
 from opentelemetry.sdk.trace.export import SpanExporter, SpanExportResult
 from opentelemetry.trace import StatusCode
 
-from ..constants import (
-    GEN_AI_INPUT_MESSAGES_KEY,
-    GEN_AI_OPERATION_NAME_KEY,
-    INVOKE_AGENT_OPERATION_NAME,
-)
 from .utils import (
     build_export_url,
     get_validated_domain_override,
     hex_span_id,
     hex_trace_id,
     kind_name,
+    parse_retry_after,
     partition_by_identity,
     status_name,
     truncate_span,
@@ -59,7 +55,6 @@ class _Agent365Exporter(SpanExporter):
         token_resolver: Callable[[str, str], str | None],
         cluster_category: str = "prod",
         use_s2s_endpoint: bool = False,
-        suppress_invoke_agent_input: bool = False,
     ):
         if token_resolver is None:
             raise ValueError("token_resolver must be provided.")
@@ -69,7 +64,6 @@ class _Agent365Exporter(SpanExporter):
         self._token_resolver = token_resolver
         self._cluster_category = cluster_category
         self._use_s2s_endpoint = use_s2s_endpoint
-        self._suppress_invoke_agent_input = suppress_invoke_agent_input
         # Read domain override once at initialization
         self._domain_override = get_validated_domain_override()
 
@@ -86,9 +80,9 @@ class _Agent365Exporter(SpanExporter):
                 logger.info("No spans with tenant/agent identity found; nothing exported.")
                 return SpanExportResult.SUCCESS
 
-            # Debug: Log number of groups and total span count
+            # Log number of groups and total span count
             total_spans = sum(len(activities) for activities in groups.values())
-            logger.info(
+            logger.debug(
                 f"Found {len(groups)} identity groups with {total_spans} total spans to export"
             )
 
@@ -105,8 +99,8 @@ class _Agent365Exporter(SpanExporter):
 
                 url = build_export_url(endpoint, agent_id, tenant_id, self._use_s2s_endpoint)
 
-                # Debug: Log endpoint being used
-                logger.info(
+                # Log endpoint details at DEBUG to avoid leaking IDs in production logs
+                logger.debug(
                     f"Exporting {len(activities)} spans to endpoint: {url} "
                     f"(tenant: {tenant_id}, agent: {agent_id})"
                 )
@@ -115,10 +109,16 @@ class _Agent365Exporter(SpanExporter):
                 try:
                     token = self._token_resolver(agent_id, tenant_id)
                     if token:
+                        # Warn if sending bearer token over non-HTTPS connection
+                        if not url.lower().startswith("https://"):
+                            logger.warning(
+                                "Bearer token is being sent over a non-HTTPS connection. "
+                                "This may expose credentials in transit."
+                            )
                         headers["authorization"] = f"Bearer {token}"
-                        logger.info(f"Token resolved successfully for agent {agent_id}")
+                        logger.debug(f"Token resolved successfully for agent {agent_id}")
                     else:
-                        logger.info(f"No token returned for agent {agent_id}")
+                        logger.debug(f"No token returned for agent {agent_id}")
                 except Exception as e:
                     # If token resolution fails, treat as failure for this group
                     logger.error(
@@ -181,7 +181,7 @@ class _Agent365Exporter(SpanExporter):
 
                 # 2xx => success
                 if 200 <= resp.status_code < 300:
-                    logger.info(
+                    logger.debug(
                         f"HTTP {resp.status_code} success on attempt {attempt + 1}. "
                         f"Correlation ID: {correlation_id}. "
                         f"Response: {self._truncate_text(resp.text, 200)}"
@@ -193,12 +193,19 @@ class _Agent365Exporter(SpanExporter):
 
                 # Retry transient
                 if resp.status_code in (408, 429) or 500 <= resp.status_code < 600:
+                    # Respect Retry-After header for 429 responses
+                    retry_after = parse_retry_after(resp.headers)
                     if attempt < DEFAULT_MAX_RETRIES:
-                        time.sleep(0.2 * (attempt + 1))
+                        if retry_after is not None:
+                            time.sleep(min(retry_after, 60.0))
+                        else:
+                            # Exponential backoff with base 0.5s
+                            time.sleep(0.5 * (2**attempt))
                         continue
                     # Final attempt failed
                     logger.error(
-                        f"HTTP {resp.status_code} final failure after {DEFAULT_MAX_RETRIES + 1} attempts. "
+                        f"HTTP {resp.status_code} final failure after "
+                        f"{DEFAULT_MAX_RETRIES + 1} attempts. "
                         f"Correlation ID: {correlation_id}. "
                         f"Response: {response_text}"
                     )
@@ -213,12 +220,11 @@ class _Agent365Exporter(SpanExporter):
 
             except requests.RequestException as e:
                 if attempt < DEFAULT_MAX_RETRIES:
-                    time.sleep(0.2 * (attempt + 1))
+                    # Exponential backoff with base 0.5s
+                    time.sleep(0.5 * (2**attempt))
                     continue
                 # Final attempt failed
-                logger.error(
-                    f"Request failed after {DEFAULT_MAX_RETRIES + 1} attempts with exception: {e}"
-                )
+                logger.error(f"Request failed after {DEFAULT_MAX_RETRIES + 1} attempts: {e}")
                 return False
         return False
 
@@ -270,19 +276,6 @@ class _Agent365Exporter(SpanExporter):
         # attributes
         attrs = dict(sp.attributes or {})
 
-        # Suppress input messages if configured and current span is an InvokeAgent span
-        if self._suppress_invoke_agent_input:
-            # Check if current span is an InvokeAgent span by:
-            # 1. Span name starts with "invoke_agent"
-            # 2. Has attribute gen_ai.operation.name set to INVOKE_AGENT_OPERATION_NAME
-            operation_name = attrs.get(GEN_AI_OPERATION_NAME_KEY)
-            if (
-                sp.name.startswith(INVOKE_AGENT_OPERATION_NAME)
-                and operation_name == INVOKE_AGENT_OPERATION_NAME
-            ):
-                # Remove input messages attribute
-                attrs.pop(GEN_AI_INPUT_MESSAGES_KEY, None)
-
         # events
         events = []
         for ev in sp.events:

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365/observability/core/exporters/enriched_span.py

@@ -19,22 +19,31 @@ class EnrichedReadableSpan(ReadableSpan):
     the original span.
     """
 
-    def __init__(self, span: ReadableSpan, extra_attributes: dict):
+    def __init__(
+        self,
+        span: ReadableSpan,
+        extra_attributes: dict,
+        excluded_attribute_keys: set[str] | None = None,
+    ):
         """
         Initialize the enriched span wrapper.
 
         Args:
             span: The original ReadableSpan to wrap.
             extra_attributes: Additional attributes to merge with the original.
+            excluded_attribute_keys: Attribute keys to remove after merging.
         """
         self._span = span
         self._extra_attributes = extra_attributes
+        self._excluded_attribute_keys = excluded_attribute_keys or set()
 
     @property
     def attributes(self) -> types.Attributes:
         """Return merged attributes from original span and extra attributes."""
         original = dict(self._span.attributes or {})
         original.update(self._extra_attributes)
+        for key in self._excluded_attribute_keys:
+            original.pop(key, None)
         return original
 
     @property

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365/observability/core/exporters/enriching_span_processor.py

@@ -10,6 +10,13 @@ from collections.abc import Callable
 from opentelemetry.sdk.trace import ReadableSpan
 from opentelemetry.sdk.trace.export import BatchSpanProcessor
 
+from ..constants import (
+    GEN_AI_INPUT_MESSAGES_KEY,
+    GEN_AI_OPERATION_NAME_KEY,
+    INVOKE_AGENT_OPERATION_NAME,
+)
+from .enriched_span import EnrichedReadableSpan
+
 logger = logging.getLogger(__name__)
 
 # Single span enricher - only one platform instrumentor should be active at a time
@@ -65,6 +72,15 @@ def get_span_enricher() -> Callable[[ReadableSpan], ReadableSpan] | None:
 class _EnrichingBatchSpanProcessor(BatchSpanProcessor):
     """BatchSpanProcessor that applies the registered enricher before batching."""
 
+    def __init__(
+        self,
+        *args: object,
+        suppress_invoke_agent_input: bool = False,
+        **kwargs: object,
+    ):
+        super().__init__(*args, **kwargs)
+        self._suppress_invoke_agent_input = suppress_invoke_agent_input
+
     def on_end(self, span: ReadableSpan) -> None:
         """Apply the span enricher and pass to parent for batching.
 
@@ -83,4 +99,18 @@ class _EnrichingBatchSpanProcessor(BatchSpanProcessor):
                     enricher.__name__,
                 )
 
+        # Apply input message suppression for InvokeAgent spans
+        if self._suppress_invoke_agent_input:
+            attrs = enriched_span.attributes or {}
+            operation_name = attrs.get(GEN_AI_OPERATION_NAME_KEY)
+            if (
+                enriched_span.name.startswith(INVOKE_AGENT_OPERATION_NAME)
+                and operation_name == INVOKE_AGENT_OPERATION_NAME
+            ):
+                enriched_span = EnrichedReadableSpan(
+                    enriched_span,
+                    extra_attributes={},
+                    excluded_attribute_keys={GEN_AI_INPUT_MESSAGES_KEY},
+                )
+
         super().on_end(enriched_span)

microsoft_agents_a365_observability_core-0.2.1.dev42/microsoft_agents_a365/observability/core/exporters/spectra_exporter_options.py

@@ -0,0 +1,56 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+from typing import Literal
+
+
+class SpectraExporterOptions:
+    """
+    Configuration for exporting traces to a Spectra Collector sidecar via OTLP.
+
+    Spectra Collector is deployed as a Kubernetes sidecar that accepts
+    standard OTLP telemetry on localhost. Defaults are tuned for this
+    deployment topology — most consumers should not need to override them.
+
+    Note: Batch processor fields (max_queue_size, scheduled_delay_ms, etc.)
+    are duplicated from Agent365ExporterOptions intentionally — these two
+    options classes have no shared base class per design decision C4.
+    """
+
+    _DEFAULT_GRPC_ENDPOINT = "http://localhost:4317"
+    _DEFAULT_HTTP_ENDPOINT = "http://localhost:4318"
+
+    def __init__(
+        self,
+        endpoint: str | None = None,
+        protocol: Literal["grpc", "http"] = "grpc",
+        insecure: bool = True,
+        max_queue_size: int = 2048,
+        scheduled_delay_ms: int = 5000,
+        exporter_timeout_ms: int = 30000,
+        max_export_batch_size: int = 512,
+    ):
+        """
+        Args:
+            endpoint: Spectra sidecar OTLP endpoint. Defaults to
+                http://localhost:4317 for gRPC or http://localhost:4318 for HTTP.
+            protocol: OTLP protocol — "grpc" or "http". Default: grpc.
+            insecure: Use insecure (no TLS) connection. Default: True (localhost sidecar).
+            max_queue_size: Batch processor queue size. Default: 2048.
+            scheduled_delay_ms: Export interval in milliseconds. Default: 5000.
+            exporter_timeout_ms: Export timeout in milliseconds. Default: 30000.
+            max_export_batch_size: Max spans per export batch. Default: 512.
+        """
+        if protocol not in ("grpc", "http"):
+            raise ValueError(f"protocol must be 'grpc' or 'http', got '{protocol}'")
+        if endpoint is None:
+            endpoint = (
+                self._DEFAULT_GRPC_ENDPOINT if protocol == "grpc" else self._DEFAULT_HTTP_ENDPOINT
+            )
+        self.endpoint = endpoint
+        self.protocol = protocol
+        self.insecure = insecure
+        self.max_queue_size = max_queue_size
+        self.scheduled_delay_ms = scheduled_delay_ms
+        self.exporter_timeout_ms = exporter_timeout_ms
+        self.max_export_batch_size = max_export_batch_size

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365/observability/core/exporters/utils.py

@@ -1,6 +1,8 @@
 # Copyright (c) Microsoft Corporation.
 # Licensed under the MIT License.
 
+from __future__ import annotations
+
 import json
 import logging
 import os
@@ -194,6 +196,13 @@ def get_validated_domain_override() -> str | None:
         logger.warning(f"Invalid domain override '{domain_override}': {e}")
         return None
 
+    # Warn when using insecure HTTP — telemetry data and bearer tokens may be exposed
+    if domain_override.lower().startswith("http://"):
+        logger.warning(
+            "Domain override uses insecure HTTP. Telemetry data (including "
+            "bearer tokens) will be transmitted in cleartext."
+        )
+
     return domain_override
 
 
@@ -223,6 +232,31 @@ def build_export_url(
     return f"https://{endpoint}{endpoint_path}?api-version=1"
 
 
+def parse_retry_after(headers: dict[str, str]) -> float | None:
+    """Parse the ``Retry-After`` header value.
+
+    Only numeric (seconds) values are supported.  HTTP-date values
+    (e.g. ``Wed, 21 Oct 2025 07:28:00 GMT``) are intentionally ignored
+    and treated as absent, falling back to exponential backoff.
+
+    Args:
+        headers: Response headers mapping.
+
+    Returns:
+        The number of seconds to wait, or ``None`` if the header is
+        absent, non-numeric, or otherwise invalid.
+    """
+    retry_after = headers.get("Retry-After")
+    if retry_after is None:
+        return None
+    try:
+        return float(retry_after)
+    except (ValueError, TypeError):
+        # Intentionally ignore HTTP-date formatted Retry-After values;
+        # callers should fall back to exponential backoff.
+        return None
+
+
 def is_agent365_exporter_enabled() -> bool:
     """Check if Agent 365 exporter is enabled."""
     # Check environment variable

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365/observability/core/opentelemetry_scope.py

@@ -9,7 +9,7 @@ from datetime import datetime
 from threading import Lock
 from typing import TYPE_CHECKING, Any
 
-from opentelemetry import baggage, context, trace
+from opentelemetry import context, trace
 from opentelemetry.trace import (
     Span,
     SpanKind,
@@ -241,21 +241,6 @@ class OpenTelemetryScope:
         if value is not None and self._span and self._is_telemetry_enabled():
             self._span.set_attribute(name, value)
 
-    def add_baggage(self, key: str, value: str) -> None:
-        """Add baggage to the current context.
-
-        Args:
-            key: The baggage key
-            value: The baggage value
-        """
-        # Set baggage in the current context
-        if self._is_telemetry_enabled():
-            # Set baggage on the current context
-            # This will be inherited by child spans created within this context
-            baggage_context = baggage.set_baggage(key, value)
-            # The context needs to be made current for child spans to inherit the baggage
-            context.attach(baggage_context)
-
     def record_attributes(self, attributes: dict[str, Any] | list[tuple[str, Any]]) -> None:
         """Record multiple attribute key/value pairs for telemetry tracking.
 

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365/observability/core/spans_scopes/output_scope.py

@@ -16,6 +16,8 @@ OUTPUT_OPERATION_NAME = "output_messages"
 class OutputScope(OpenTelemetryScope):
     """Provides OpenTelemetry tracing scope for output messages."""
 
+    _MAX_OUTPUT_MESSAGES = 5000
+
     @staticmethod
     def start(
         agent_details: AgentDetails,
@@ -82,9 +84,12 @@ class OutputScope(OpenTelemetryScope):
         """Records the output messages for telemetry tracking.
 
         Appends the provided messages to the accumulated output messages list.
+        The list is capped at _MAX_OUTPUT_MESSAGES to prevent unbounded memory growth.
 
         Args:
             messages: List of output messages to append
         """
         self._output_messages.extend(messages)
+        if len(self._output_messages) > self._MAX_OUTPUT_MESSAGES:
+            self._output_messages = self._output_messages[-self._MAX_OUTPUT_MESSAGES :]
         self.set_tag_maybe(GEN_AI_OUTPUT_MESSAGES_KEY, safe_json_dumps(self._output_messages))

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365_observability_core.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-a365-observability-core
-Version: 0.2.1.dev35
+Version: 0.2.1.dev42
 Summary: Telemetry, tracing, and monitoring components for AI agents
 Author-email: Microsoft <support@microsoft.com>
 License: MIT

{microsoft_agents_a365_observability_core-0.2.1.dev35 → microsoft_agents_a365_observability_core-0.2.1.dev42}/microsoft_agents_a365_observability_core.egg-info/SOURCES.txt

@@ -24,6 +24,7 @@ microsoft_agents_a365/observability/core/exporters/agent365_exporter.py
 microsoft_agents_a365/observability/core/exporters/agent365_exporter_options.py
 microsoft_agents_a365/observability/core/exporters/enriched_span.py
 microsoft_agents_a365/observability/core/exporters/enriching_span_processor.py
+microsoft_agents_a365/observability/core/exporters/spectra_exporter_options.py
 microsoft_agents_a365/observability/core/exporters/utils.py
 microsoft_agents_a365/observability/core/middleware/__init__.py
 microsoft_agents_a365/observability/core/middleware/baggage_builder.py