cURL

curl --request GET \
  --url https://api.bedrock.orinlabs.org/api/tracing/traces/{trace_id}/ \
  --header 'Authorization: <api-key>'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "agent": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z",
  "spans": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "trace": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "duration_ms": 123,
      "has_error": true,
      "parent": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ended_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total_spans": 123,
  "error": "<string>",
  "metadata": "<unknown>"
}

Tracing

Get Trace

ViewSet for Trace operations.

IMPORTANT — Memory safety: Traces can have hundreds of spans, each with metadata containing base64 screenshots (1MB+). Never use TraceSerializer or prefetch_related(“spans”) here — that eagerly loads ALL span data and WILL OOM on 2GB instances.

Safe patterns:

list: TraceListSerializer (no spans, just trace metadata + annotated count)
retrieve: SpanTreeSerializer with .only() (minimal columns, no metadata)
create/end: TraceDetailSerializer (no spans at all)
Individual span detail: fetched separately via SpanViewSet

GET

api

tracing

traces

{trace_id}

cURL

curl --request GET \
  --url https://api.bedrock.orinlabs.org/api/tracing/traces/{trace_id}/ \
  --header 'Authorization: <api-key>'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "agent": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z",
  "spans": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "trace": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "duration_ms": 123,
      "has_error": true,
      "parent": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ended_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total_spans": 123,
  "error": "<string>",
  "metadata": "<unknown>"
}

Authorizations

Authorization

string

header

required

Token-based authentication with required prefix "Token"

Path Parameters

trace_id

string<uuid>

required

Response

200 - application/json

Response serializer for trace detail with tree-optimized spans.

Spans use SpanTreeSerializer (minimal fields) for fast initial load. Fetch individual span details via GET /api/tracing/spans/{id}/.

string<uuid>

required

read-only

name

string

required

agent

string<uuid> | null

required

started_at

string<date-time>

required

read-only

ended_at

string<date-time> | null

required

spans

object[]

required

Show child attributes

total_spans

integer

required

error

string | null

metadata

any

List Traces Create Trace