Skip to content

Bedrock AgentCore  >  Structures  >  SpanContext

SpanContext

Structure Class

SpanContext dataclass

The contextual information that uniquely identifies a span within the distributed tracing system. Contains session, trace, and span identifiers used to correlate evaluation results with specific agent execution points.

Attributes

session_id instance-attribute 
session_id: str

The unique identifier of the session containing this span. Sessions represent complete conversation flows and are detected using configurable SessionTimeoutMinutes (default 15 minutes).

span_id class-attribute instance-attribute 
span_id: str | None = None

The unique identifier of the specific span being referenced. Spans represent individual operations like tool calls, model invocations, or other discrete actions within the agent's execution.

trace_id class-attribute instance-attribute 
trace_id: str | None = None

The unique identifier of the trace containing this span. Traces represent individual request-response interactions within a session and group related spans together.