List Traces

Retrieve traces for an inference result.

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. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.

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: 10000.

id · string | list[string] · default: "None"

The ID or IDs of the trace(s) to retrieve.

At least one of inference_result_id, session_id, or id must be provided.