Query traces, with optional grouping, windowing, filtering, and pagination.

GET 
/observability/v1/traces

Query traces, with optional grouping, windowing, filtering, and pagination.

Request

Query Parameters

format Format

Possible values: [opentelemetry, agenta]

Default value: agenta

focus any
oldest any
newest any
filtering any
page any
size any
next any
stop any

Responses

200

Successful Response

application/json

Schema

Schema

anyOf
OTelSpansResponse
version Version (string)required
countobject
anyOf
MOD1
integer
spansobject[]required
Array [
contextobjectrequired
trace_id Trace Id (string)required
span_id Span Id (string)required
name Name (string)required
kind OTelSpanKind (string)
Possible values: [SPAN_KIND_UNSPECIFIED, SPAN_KIND_INTERNAL, SPAN_KIND_SERVER, SPAN_KIND_CLIENT, SPAN_KIND_PRODUCER, SPAN_KIND_CONSUMER]
Default value: SPAN_KIND_UNSPECIFIED
start_time date-timerequired
end_time date-timerequired
status_code OTelStatusCode (string)
Possible values: [STATUS_CODE_OK, STATUS_CODE_ERROR, STATUS_CODE_UNSET]
Default value: STATUS_CODE_UNSET
status_messageobject
anyOf
MOD1
string
attributesobject
anyOf
eventsobject
anyOf
MOD1
Array [
name Name (string)required
timestamp Timestamp (string)required
attributesobject
anyOf
]
parentobject
anyOf
OTelContextDTO
trace_id Trace Id (string)required
span_id Span Id (string)required
linksobject
anyOf
MOD1
Array [
contextobjectrequired
trace_id Trace Id (string)required
span_id Span Id (string)required
attributesobject
anyOf
]
]
AgentaNodesResponse
nodesobject[]required
Array [
lifecycleobject
anyOf
LifecycleDTO
created_at date-timerequired
updated_atobject
anyOf
MOD1
string
updated_by_idobject
anyOf
MOD1
string
rootobjectrequired
id uuidrequired
treeobjectrequired
id uuidrequired
typeobject
anyOf
TreeType
string
Possible values: [invocation]
nodeobjectrequired
id uuidrequired
name Name (string)required
typeobject
anyOf
NodeType
string
Possible values: [agent, workflow, chain, task, tool, embedding, query, completion, chat, rerank]
parentobject
anyOf
ParentDTO
id uuidrequired
timeobjectrequired
start date-timerequired
end date-timerequired
statusobjectrequired
code StatusCode (string)required
Possible values: [UNSET, OK, ERROR]
messageobject
anyOf
MOD1
string
exceptionobject
anyOf
ExceptionDTO
timestamp date-timerequired
type Type (string)required
messageobject
anyOf
MOD1
string
stacktraceobject
anyOf
MOD1
string
attributesobject
anyOf
dataobject
anyOf
metricsobject
anyOf
metaobject
anyOf
refsobject
anyOf
linksobject
anyOf
MOD1
Array [
type TreeType (string)required
Possible values: [invocation]
id uuidrequired
tree_idobject
anyOf
MOD1
string
]
otelobject
anyOf
OTelExtraDTO
kindobject
anyOf
MOD1
string
attributesobject
anyOf
eventsobject
anyOf
MOD1
Array [
name Name (string)required
timestamp Timestamp (string)required
attributesobject
anyOf
]
linksobject
anyOf
MOD1
Array [
context
object
required
trace_id Trace Id (string)required
span_id Span Id (string)required
attributesobject
anyOf
]
nodesobject
anyOf
]
version Version (string)required
countobject
anyOf
MOD1
integer
AgentaTreesResponse
treesobject[]required
Array [
treeobjectrequired
id uuidrequired
typeobject
anyOf
TreeType
string
Possible values: [invocation]
nodesobject[]required
Array [
lifecycleobject
anyOf
LifecycleDTO
created_at date-timerequired
updated_atobject
anyOf
MOD1
string
updated_by_idobject
anyOf
MOD1
string
rootobjectrequired
id uuidrequired
treeobjectrequired
id uuidrequired
typeobject
anyOf
TreeType
string
Possible values: [invocation]
nodeobjectrequired
id uuidrequired
name Name (string)required
typeobject
anyOf
NodeType
string
Possible values: [agent, workflow, chain, task, tool, embedding, query, completion, chat, rerank]
parentobject
anyOf
ParentDTO
id uuidrequired
timeobjectrequired
start date-timerequired
end date-timerequired
statusobjectrequired
code StatusCode (string)required
Possible values: [UNSET, OK, ERROR]
messageobject
anyOf
MOD1
string
exceptionobject
anyOf
ExceptionDTO
timestamp date-timerequired
type Type (string)required
messageobject
anyOf
MOD1
string
stacktraceobject
anyOf
MOD1
string
attributesobject
anyOf
dataobject
anyOf
metricsobject
anyOf
metaobject
anyOf
refsobject
anyOf
linksobject
anyOf
MOD1
Array [
type TreeType (string)required
Possible values: [invocation]
id uuidrequired
tree_idobject
anyOf
MOD1
string
]
otelobject
anyOf
OTelExtraDTO
kindobject
anyOf
MOD1
string
attributesobject
anyOf
eventsobject
anyOf
MOD1
Array [
name Name (string)required
timestamp Timestamp (string)required
attributesobject
anyOf
]
linksobject
anyOf
MOD1
Array [
context
object
required
trace_id Trace Id (string)required
span_id Span Id (string)required
attributesobject
anyOf
]
nodesobject
anyOf
]
]
version Version (string)required
countobject
anyOf
MOD1
integer
AgentaRootsResponse
rootsobject[]required
Array [
rootobjectrequired
id uuidrequired
treesobject[]required
Array [
treeobjectrequired
id uuidrequired
typeobject
anyOf
TreeType
string
Possible values: [invocation]
nodesobject[]required
Array [
lifecycleobject
anyOf
LifecycleDTO
created_at date-timerequired
updated_atobject
anyOf
MOD1
string
updated_by_idobject
anyOf
MOD1
string
rootobjectrequired
id uuidrequired
treeobjectrequired
id uuidrequired
typeobject
anyOf
TreeType
string
Possible values: [invocation]
nodeobjectrequired
id uuidrequired
name Name (string)required
typeobject
anyOf
NodeType
string
Possible values: [agent, workflow, chain, task, tool, embedding, query, completion, chat, rerank]
parentobject
anyOf
ParentDTO
id uuidrequired
timeobjectrequired
start date-timerequired
end date-timerequired
statusobjectrequired
code StatusCode (string)required
Possible values: [UNSET, OK, ERROR]
messageobject
anyOf
MOD1
string
exceptionobject
anyOf
ExceptionDTO
timestamp date-timerequired
type Type (string)required
messageobject
anyOf
MOD1
string
stacktraceobject
anyOf
MOD1
string
attributesobject
anyOf
dataobject
anyOf
metricsobject
anyOf
metaobject
anyOf
refsobject
anyOf
linksobject
anyOf
MOD1
Array [
type TreeType (string)required
Possible values: [invocation]
id uuidrequired
tree_idobject
anyOf
MOD1
string
]
otelobject
anyOf
OTelExtraDTO
kindobject
anyOf
MOD1
string
attributesobject
anyOf
eventsobject
anyOf
MOD1
Array [
name Name (string)required
timestamp Timestamp (string)required
attributesobject
anyOf
]
linksobject
anyOf
MOD1
Array [
context
object
required
trace_id Trace Id (string)required
span_id Span Id (string)required
attributesobject
anyOf
]
nodesobject
anyOf
]
]
]
version Version (string)required
countobject
anyOf
MOD1
integer

Example (from schema)

{}

422

Validation Error

application/json

Schema

Schema

detailobject[]

Array [

locobject[]required

Array [

anyOf

MOD1

string

MOD2

integer

]

msg Message (string)required

type Error Type (string)required

]

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Loading...