Judgeval Python-v1 SDKPrimitives
Trace
A list of trace spans representing the execution flow of your AI system
A Trace is a type alias for List[TraceSpan] that represents the execution flow of your AI system. Each span in the trace captures a unit of work, such as an LLM call, tool invocation, or custom operation.
Each TraceSpan in a trace contains the following properties:
trace_id
:strUnique identifier for the trace
span_id
:strUnique identifier for the span
parent_span_id
:Optional[str]ID of the parent span, if any
span_name
:Optional[str]Name of the span
span_kind
:Optional[str]Kind of span (e.g., "LLM", "TOOL")
span_attributes
:Dict[str, Any]Custom attributes associated with the span
resource_attributes
:Dict[str, Any]Resource attributes for the span
duration
:strDuration of the span
timestamp
:strTimestamp when the span was created
status_code
:floatStatus code of the span
status_message
:Optional[str]Status message of the span
events
:List[Dict[str, Any]]Events that occurred during the span
service_name
:Optional[str]Name of the service that created the span