Query Traces
curl --request POST \
--url https://api.acme.rungalileo.io/v2/projects/{project_id}/traces/search \
--header 'Content-Type: application/json' \
--header 'Galileo-API-Key: <api-key>' \
--data '{
"filters": [
{
"case_sensitive": true,
"name": "input",
"operator": "eq",
"type": "text",
"value": "example input"
}
],
"log_stream_id": "00000000-0000-0000-0000-000000000000",
"pagination": {
"limit": 5,
"starting_token": 0
},
"sort": {
"ascending": false,
"name": "updated_at",
"sort_type": "column"
}
}'{
"next_starting_token": 2,
"num_rows": 2,
"paginated": true,
"records": [
{
"created_at": "2025-04-16T18:15:38.919525Z",
"id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
"input": "Who is a smart LLM?",
"metrics": {
"duration_ns": 4
},
"name": "",
"output": "I am",
"project_id": "0d4e3799-3861-4759-875f-9ae14c167b0a",
"run_id": "74aec44e-ec21-4c9f-a3e2-b2ab2b81b4db",
"tags": [],
"trace_id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
"type": "trace",
"user_metadata": {}
},
{
"created_at": "2025-04-16T18:15:38.919740Z",
"id": "1edc2401-24b4-448c-a392-b36932293061",
"input": [
{
"content": "Who is a smart LLM?",
"role": "user"
}
],
"metrics": {
"duration_ns": 4,
"num_input_tokens": 4,
"num_output_tokens": 2,
"num_total_tokens": 6
},
"name": "",
"output": {
"content": "I am",
"role": "user"
},
"parent_id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
"project_id": "0d4e3799-3861-4759-875f-9ae14c167b0a",
"run_id": "74aec44e-ec21-4c9f-a3e2-b2ab2b81b4db",
"tags": [],
"trace_id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
"type": "llm",
"user_metadata": {}
}
]
}Authorizations
Path Parameters
Body
Log stream id associated with the traces.
Experiment id associated with the traces.
Response
number of records
records matching the query
Input to the trace or span.
Galileo ID of the trace or span
Galileo ID of the trace containing the span (or the same value as id for a trace)
Galileo ID of the project associated with this trace or span
Galileo ID of the run (log stream or experiment) associated with this trace or span
Type of the trace or span.
"trace"Output of the trace or span.
Name of the trace or span.
Timestamp of the trace or span's creation.
Metadata associated with this trace or span.
Tags associated with this trace or span.
Status code of the trace or span. Used for logging failure or error states.
Metrics associated with this trace or span.
Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo.
Timestamp of the trace or span's last update
Whether or not this trace or span has child spans
Galileo ID of the metrics batch associated with this trace or span
Detailed information about the metrics associated with this trace or span
Was this page helpful?
curl --request POST \
--url https://api.acme.rungalileo.io/v2/projects/{project_id}/traces/search \
--header 'Content-Type: application/json' \
--header 'Galileo-API-Key: <api-key>' \
--data '{
"filters": [
{
"case_sensitive": true,
"name": "input",
"operator": "eq",
"type": "text",
"value": "example input"
}
],
"log_stream_id": "00000000-0000-0000-0000-000000000000",
"pagination": {
"limit": 5,
"starting_token": 0
},
"sort": {
"ascending": false,
"name": "updated_at",
"sort_type": "column"
}
}'{
"next_starting_token": 2,
"num_rows": 2,
"paginated": true,
"records": [
{
"created_at": "2025-04-16T18:15:38.919525Z",
"id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
"input": "Who is a smart LLM?",
"metrics": {
"duration_ns": 4
},
"name": "",
"output": "I am",
"project_id": "0d4e3799-3861-4759-875f-9ae14c167b0a",
"run_id": "74aec44e-ec21-4c9f-a3e2-b2ab2b81b4db",
"tags": [],
"trace_id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
"type": "trace",
"user_metadata": {}
},
{
"created_at": "2025-04-16T18:15:38.919740Z",
"id": "1edc2401-24b4-448c-a392-b36932293061",
"input": [
{
"content": "Who is a smart LLM?",
"role": "user"
}
],
"metrics": {
"duration_ns": 4,
"num_input_tokens": 4,
"num_output_tokens": 2,
"num_total_tokens": 6
},
"name": "",
"output": {
"content": "I am",
"role": "user"
},
"parent_id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
"project_id": "0d4e3799-3861-4759-875f-9ae14c167b0a",
"run_id": "74aec44e-ec21-4c9f-a3e2-b2ab2b81b4db",
"tags": [],
"trace_id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
"type": "llm",
"user_metadata": {}
}
]
}