Skip to main content

​
Returns

Returns a list of Trace objects.

​
Example

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

# Filter by type and name
traces = galtea.traces.list(
    session_id="YOUR_SESSION_ID",
    types=["TOOL", "GENERATION"],
    names=["fetch_user_data", "generate_response"],
    sort_by_start_time="asc"
)

​
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]
Filter traces by type. Options: SPAN, GENERATION, EVENT, AGENT, TOOL, CHAIN, RETRIEVER, EVALUATOR, EMBEDDING, GUARDRAIL.
​
names
list[string]
Filter traces by name.
​
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.