Skip to main content

​
Returns

Returns a list of Trace objects.

​
Example

traces = galtea.traces.list(inference_result_id=inference_result_id)

​
Parameters

​
inference_result_id
string | list[string]
Filter traces by inference result ID(s).
​
session_id
string | list[string]
Filter traces by session ID(s).
​
types
list[string | TraceType]
Filter traces by type. Options: SPAN, GENERATION, EVENT, AGENT, TOOL, CHAIN, RETRIEVER, EVALUATOR, EMBEDDING, GUARDRAIL.
​
names
list[string]
Filter traces by name.
​
from_start_time
str | int
default:"None"
Filter traces started at or after this timestamp. Accepts ISO 8601 string (e.g., '2024-01-01T00:00:00Z') or Unix timestamp in seconds. Can be used independently or together with to_start_time.
​
to_start_time
str | int
default:"None"
Filter traces started at or before this timestamp. Accepts ISO 8601 string (e.g., '2024-12-31T23:59:59Z') or Unix timestamp in seconds. Can be used independently or together with from_start_time.
​
sort_by_start_time
string
Sort traces by start_time. Valid values: asc, desc.
​
offset
int
Number of traces to skip for pagination. Default: 0.
​
limit
int
Maximum number of traces to return. Default: 1000.
At least one of inference_result_id or session_id must be provided.