microsoft-agents-a365-observability-core 0.2.1.dev33__tar.gz → 0.2.1.dev36__tar.gz

{microsoft_agents_a365_observability_core-0.2.1.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-a365-observability-core
-Version: 0.2.1.dev33
+Version: 0.2.1.dev36
 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.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/microsoft_agents_a365/observability/core/__init__.py

@@ -12,13 +12,15 @@ 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 .inference_call_details import InferenceCallDetails
+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
 from .invoke_agent_details import InvokeAgentDetails
@@ -38,6 +40,9 @@ __all__ = [
     "is_configured",
     "get_tracer",
     "get_tracer_provider",
+    # Exporter options
+    "Agent365ExporterOptions",
+    "SpectraExporterOptions",
     # Span enrichment
     "register_span_enricher",
     "unregister_span_enricher",
@@ -61,6 +66,7 @@ __all__ = [
     "SourceMetadata",
     "Request",
     "InferenceCallDetails",
+    "ServiceEndpoint",
     # Enums
     "ExecutionType",
     "InferenceOperationType",

{microsoft_agents_a365_observability_core-0.2.1.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/microsoft_agents_a365/observability/core/agent_details.py

@@ -4,8 +4,6 @@
 from dataclasses import dataclass
 from typing import Optional
 
-from .models.agent_type import AgentType
-
 
 @dataclass
 class AgentDetails:
@@ -29,8 +27,8 @@ class AgentDetails:
     agent_blueprint_id: Optional[str] = None
     """Blueprint/Application ID for the agent."""
 
-    agent_type: Optional[AgentType] = None
-    """The agent type."""
+    agent_platform_id: Optional[str] = None
+    """Platform ID for the agent."""
 
     tenant_id: Optional[str] = None
     """Tenant ID for the agent."""
@@ -41,5 +39,5 @@ class AgentDetails:
     icon_uri: Optional[str] = None
     """Optional icon URI for the agent."""
 
-    agent_client_ip: Optional[str] = None
-    """Client IP address of the agent user."""
+    provider_name: Optional[str] = None
+    """The provider name (e.g., openai, anthropic)."""

{microsoft_agents_a365_observability_core-0.2.1.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/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.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/microsoft_agents_a365/observability/core/constants.py

@@ -6,6 +6,8 @@
 # Span operation names
 INVOKE_AGENT_OPERATION_NAME = "invoke_agent"
 EXECUTE_TOOL_OPERATION_NAME = "execute_tool"
+OUTPUT_MESSAGES_OPERATION_NAME = "output_messages"
+CHAT_OPERATION_NAME = "chat"
 
 # OpenTelemetry semantic conventions
 ERROR_TYPE_KEY = "error.type"
@@ -30,81 +32,79 @@ GEN_AI_REQUEST_MAX_TOKENS_KEY = "gen_ai.request.max_tokens"
 GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model"
 GEN_AI_REQUEST_TEMPERATURE_KEY = "gen_ai.request.temperature"
 GEN_AI_REQUEST_TOP_P_KEY = "gen_ai.request.top_p"
-GEN_AI_RESPONSE_ID_KEY = "gen_ai.response.id"
 GEN_AI_RESPONSE_FINISH_REASONS_KEY = "gen_ai.response.finish_reasons"
 GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model"
-GEN_AI_SYSTEM_KEY = "gen_ai.system"
-GEN_AI_SYSTEM_VALUE = "az.ai.agent365"
-GEN_AI_THOUGHT_PROCESS_KEY = "gen_ai.agent.thought.process"
-
+GEN_AI_RESPONSE_ID_KEY = "gen_ai.response.id"
 GEN_AI_AGENT_ID_KEY = "gen_ai.agent.id"
 GEN_AI_AGENT_NAME_KEY = "gen_ai.agent.name"
 GEN_AI_AGENT_DESCRIPTION_KEY = "gen_ai.agent.description"
+GEN_AI_AGENT_PLATFORM_ID_KEY = "microsoft.a365.agent.platform.id"
+GEN_AI_AGENT_THOUGHT_PROCESS_KEY = "microsoft.a365.agent.thought.process"
 GEN_AI_CONVERSATION_ID_KEY = "gen_ai.conversation.id"
-GEN_AI_CONVERSATION_ITEM_LINK_KEY = "gen_ai.conversation.item.link"
+GEN_AI_CONVERSATION_ITEM_LINK_KEY = "microsoft.conversation.item.link"
 GEN_AI_TOKEN_TYPE_KEY = "gen_ai.token.type"
 GEN_AI_USAGE_INPUT_TOKENS_KEY = "gen_ai.usage.input_tokens"
 GEN_AI_USAGE_OUTPUT_TOKENS_KEY = "gen_ai.usage.output_tokens"
 GEN_AI_CHOICE = "gen_ai.choice"
 GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name"
-GEN_AI_AGENT_TYPE_KEY = "gen_ai.agent.type"
 
 GEN_AI_SYSTEM_INSTRUCTIONS_KEY = "gen_ai.system_instructions"
 GEN_AI_INPUT_MESSAGES_KEY = "gen_ai.input.messages"
 GEN_AI_OUTPUT_MESSAGES_KEY = "gen_ai.output.messages"
-GEN_AI_EVENT_CONTENT = "gen_ai.event.content"
 
 # Tool execution constants
 GEN_AI_TOOL_CALL_ID_KEY = "gen_ai.tool.call.id"
 GEN_AI_TOOL_NAME_KEY = "gen_ai.tool.name"
 GEN_AI_TOOL_DESCRIPTION_KEY = "gen_ai.tool.description"
-GEN_AI_TOOL_ARGS_KEY = "gen_ai.tool.arguments"
-GEN_AI_TOOL_CALL_RESULT_KEY = GEN_AI_EVENT_CONTENT  # GEN_AI_EVENT_CONTENT
+GEN_AI_TOOL_ARGS_KEY = "gen_ai.tool.call.arguments"
+GEN_AI_TOOL_CALL_RESULT_KEY = "gen_ai.tool.call.result"
 GEN_AI_TOOL_TYPE_KEY = "gen_ai.tool.type"
 
-# Agent user(user tied to agent instance during creation) or caller dimensions
-GEN_AI_AGENT_USER_ID_KEY = "gen_ai.agent.userid"
-GEN_AI_CALLER_USER_ID_KEY = "gen_ai.caller.userid"
-GEN_AI_CALLER_TENANT_ID_KEY = "gen_ai.caller.tenantid"
-GEN_AI_CALLER_ID_KEY = "gen_ai.caller.id"
-GEN_AI_CALLER_NAME_KEY = "gen_ai.caller.name"
-GEN_AI_CALLER_UPN_KEY = "gen_ai.caller.upn"
-GEN_AI_CALLER_CLIENT_IP_KEY = "gen_ai.caller.client.ip"
+# Agent user (user tied to agent instance during creation) or caller dimensions
+GEN_AI_CALLER_ID_KEY = "microsoft.caller.id"
+GEN_AI_CALLER_NAME_KEY = "microsoft.caller.name"
+GEN_AI_CALLER_UPN_KEY = "microsoft.caller.upn"
+GEN_AI_CALLER_CLIENT_IP_KEY = "client.address"
 
 # Agent to Agent caller agent dimensions
-GEN_AI_CALLER_AGENT_USER_ID_KEY = "gen_ai.caller.agent.userid"
-GEN_AI_CALLER_AGENT_UPN_KEY = "gen_ai.caller.agent.upn"
-GEN_AI_CALLER_AGENT_TENANT_ID_KEY = "gen_ai.caller.agent.tenantid"
-GEN_AI_CALLER_AGENT_NAME_KEY = "gen_ai.caller.agent.name"
-GEN_AI_CALLER_AGENT_ID_KEY = "gen_ai.caller.agent.id"
-GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY = "gen_ai.caller.agent.applicationid"
-GEN_AI_CALLER_AGENT_TYPE_KEY = "gen_ai.caller.agent.type"
-GEN_AI_CALLER_AGENT_USER_CLIENT_IP = "gen_ai.caller.agent.user.client.ip"
+GEN_AI_CALLER_AGENT_USER_ID_KEY = "microsoft.a365.caller.agent.user.id"
+GEN_AI_CALLER_AGENT_UPN_KEY = "microsoft.a365.caller.agent.user.upn"
+GEN_AI_CALLER_AGENT_NAME_KEY = "microsoft.a365.caller.agent.name"
+GEN_AI_CALLER_AGENT_ID_KEY = "microsoft.a365.caller.agent.id"
+GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY = "microsoft.a365.caller.agent.blueprint.id"
+GEN_AI_CALLER_AGENT_PLATFORM_ID_KEY = "microsoft.a365.caller.agent.platform.id"
 
 # Agent-specific dimensions
 AGENT_ID_KEY = "gen_ai.agent.id"
 GEN_AI_TASK_ID_KEY = "gen_ai.task.id"
-SESSION_ID_KEY = "session.id"
+SESSION_ID_KEY = "microsoft.session.id"
+SESSION_DESCRIPTION_KEY = "microsoft.session.description"
 GEN_AI_ICON_URI_KEY = "gen_ai.agent365.icon_uri"
-TENANT_ID_KEY = "tenant.id"
+TENANT_ID_KEY = "microsoft.tenant.id"
 
 # Baggage keys
-OPERATION_SOURCE_KEY = "operation.source"
-GEN_AI_AGENT_AUID_KEY = "gen_ai.agent.user.id"
-GEN_AI_AGENT_UPN_KEY = "gen_ai.agent.upn"
-GEN_AI_AGENT_BLUEPRINT_ID_KEY = "gen_ai.agent.applicationid"
-CORRELATION_ID_KEY = "correlation.id"
-HIRING_MANAGER_ID_KEY = "hiring.manager.id"
-SESSION_DESCRIPTION_KEY = "session.description"
+GEN_AI_AGENT_AUID_KEY = "microsoft.agent.user.id"
+GEN_AI_AGENT_UPN_KEY = "microsoft.agent.user.upn"
+GEN_AI_AGENT_BLUEPRINT_ID_KEY = "microsoft.a365.agent.blueprint.id"
 
 # Execution context dimensions
 GEN_AI_EXECUTION_TYPE_KEY = "gen_ai.execution.type"
 GEN_AI_EXECUTION_PAYLOAD_KEY = "gen_ai.execution.payload"
 
-# Source metadata dimensions
-GEN_AI_EXECUTION_SOURCE_NAME_KEY = "gen_ai.channel.name"
-GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY = "gen_ai.channel.link"
+# Channel dimensions
+CHANNEL_NAME_KEY = "microsoft.channel.name"
+CHANNEL_LINK_KEY = "microsoft.channel.link"
 
-# custom parent id and parent name key
+# Custom parent id and parent name key
 CUSTOM_PARENT_SPAN_ID_KEY = "custom.parent.span.id"
 CUSTOM_SPAN_NAME_KEY = "custom.span.name"
+
+# Service attributes
+SERVICE_NAME_KEY = "service.name"
+
+# Telemetry SDK attributes
+TELEMETRY_SDK_NAME_KEY = "telemetry.sdk.name"
+TELEMETRY_SDK_LANGUAGE_KEY = "telemetry.sdk.language"
+TELEMETRY_SDK_VERSION_KEY = "telemetry.sdk.version"
+TELEMETRY_SDK_NAME_VALUE = "A365ObservabilitySDK"
+TELEMETRY_SDK_LANGUAGE_VALUE = "python"

{microsoft_agents_a365_observability_core-0.2.1.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/microsoft_agents_a365/observability/core/execute_tool_scope.py

@@ -3,12 +3,13 @@
 
 from datetime import datetime
 
+from opentelemetry.trace import SpanKind
+
 from .agent_details import AgentDetails
 from .constants import (
+    CHANNEL_LINK_KEY,
+    CHANNEL_NAME_KEY,
     EXECUTE_TOOL_OPERATION_NAME,
-    GEN_AI_EVENT_CONTENT,
-    GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY,
-    GEN_AI_EXECUTION_SOURCE_NAME_KEY,
     GEN_AI_TOOL_ARGS_KEY,
     GEN_AI_TOOL_CALL_ID_KEY,
     GEN_AI_TOOL_DESCRIPTION_KEY,
@@ -35,6 +36,7 @@ class ExecuteToolScope(OpenTelemetryScope):
         parent_id: str | None = None,
         start_time: datetime | None = None,
         end_time: datetime | None = None,
+        span_kind: SpanKind | None = None,
     ) -> "ExecuteToolScope":
         """Creates and starts a new scope for tool execution tracing.
 
@@ -50,12 +52,21 @@ class ExecuteToolScope(OpenTelemetryScope):
             end_time: Optional explicit end time as a datetime object. When provided,
                 the span will use this timestamp when disposed instead of the
                 current wall-clock time.
+            span_kind: Optional span kind override. Defaults to ``SpanKind.INTERNAL``.
+                Use ``SpanKind.CLIENT`` when the tool calls an external service.
 
         Returns:
             A new ExecuteToolScope instance
         """
         return ExecuteToolScope(
-            details, agent_details, tenant_details, request, parent_id, start_time, end_time
+            details,
+            agent_details,
+            tenant_details,
+            request,
+            parent_id,
+            start_time,
+            end_time,
+            span_kind,
         )
 
     def __init__(
@@ -67,6 +78,7 @@ class ExecuteToolScope(OpenTelemetryScope):
         parent_id: str | None = None,
         start_time: datetime | None = None,
         end_time: datetime | None = None,
+        span_kind: SpanKind | None = None,
     ):
         """Initialize the tool execution scope.
 
@@ -82,9 +94,11 @@ class ExecuteToolScope(OpenTelemetryScope):
             end_time: Optional explicit end time as a datetime object. When provided,
                 the span will use this timestamp when disposed instead of the
                 current wall-clock time.
+            span_kind: Optional span kind override. Defaults to ``SpanKind.INTERNAL``.
+                Use ``SpanKind.CLIENT`` when the tool calls an external service.
         """
         super().__init__(
-            kind="Internal",
+            kind=span_kind if span_kind is not None else SpanKind.INTERNAL,
             operation_name=EXECUTE_TOOL_OPERATION_NAME,
             activity_name=f"{EXECUTE_TOOL_OPERATION_NAME} {details.tool_name}",
             agent_details=agent_details,
@@ -115,15 +129,16 @@ class ExecuteToolScope(OpenTelemetryScope):
 
         # Set request metadata if provided
         if request and request.source_metadata:
-            self.set_tag_maybe(GEN_AI_EXECUTION_SOURCE_NAME_KEY, request.source_metadata.name)
-            self.set_tag_maybe(
-                GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY, request.source_metadata.description
-            )
+            self.set_tag_maybe(CHANNEL_NAME_KEY, request.source_metadata.name)
+            self.set_tag_maybe(CHANNEL_LINK_KEY, request.source_metadata.description)
 
     def record_response(self, response: str) -> None:
         """Records response information for telemetry tracking.
 
+        Note: This method is intentionally a no-op as GEN_AI_EVENT_CONTENT was removed.
+        The method is kept for interface compatibility.
+
         Args:
             response: The response to record
         """
-        self.set_tag_maybe(GEN_AI_EVENT_CONTENT, response)
+        pass

{microsoft_agents_a365_observability_core-0.2.1.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/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.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/microsoft_agents_a365/observability/core/exporters/agent365_exporter.py

@@ -17,11 +17,6 @@ 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,
@@ -59,7 +54,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 +63,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()
 
@@ -270,19 +263,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.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/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.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/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.dev36/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.dev33 → microsoft_agents_a365_observability_core-0.2.1.dev36}/microsoft_agents_a365/observability/core/inference_call_details.py

@@ -6,6 +6,17 @@ from dataclasses import dataclass
 from .inference_operation_type import InferenceOperationType
 
 
+@dataclass
+class ServiceEndpoint:
+    """Represents a service endpoint with hostname and optional port."""
+
+    hostname: str
+    """The hostname of the service endpoint."""
+
+    port: int | None = None
+    """The port of the service endpoint."""
+
+
 @dataclass
 class InferenceCallDetails:
     """Details of an inference call for generative AI operations."""
@@ -16,4 +27,5 @@ class InferenceCallDetails:
     inputTokens: int | None = None
     outputTokens: int | None = None
     finishReasons: list[str] | None = None
-    responseId: str | None = None
+    thoughtProcess: str | None = None
+    endpoint: ServiceEndpoint | None = None