Component schema

GetTraceRequest

object1 direct reference

Definition

Optional dataset to query across. Defaults to whatever is configured to be the default dataset for the organization.

stringrequired

Optional time range hint to bound the trace metadata lookup. When provided, the backend restricts the AggregatedTraceMetadata query to this window (with a small buffer) and will not fall back to a full-table scan. When absent, the backend uses a default short window with a full-scan fallback for backward compatibility — this fallback can be expensive on large datasets. API consumers are strongly encouraged to provide a timeRange covering when the trace occurred.

boolean

If true, recursively fetches all traces referenced via forward links (dash0ForwardLinks) and returns them in additionalResourceSpans. Implies includeOTLPSchemaExtensions=true.

Used by 1

These schemas and endpoints reference this type directly.

EndpointPOST /api/trace/details

json

OpenAPI source12345678910111213141516171819202122
{
  "properties": {
    "dataset": {
      "$ref": "#/components/schemas/Dataset"
    },
    "traceId": {
      "type": "string"
    },
    "timeRange": {
      "$ref": "#/components/schemas/TimeReferenceRange",
      "description": "Optional time range hint to bound the trace metadata lookup. When provided, the backend\nrestricts the `AggregatedTraceMetadata` query to this window (with a small buffer) and\nwill not fall back to a full-table scan. When absent, the backend uses a default short\nwindow with a full-scan fallback for backward compatibility — this fallback can be\nexpensive on large datasets. API consumers are strongly encouraged to provide a\n`timeRange` covering when the trace occurred.\n"
    },
    "includeLinkedTraces": {
      "description": "If true, recursively fetches all traces referenced via forward links (dash0ForwardLinks)\nand returns them in `additionalResourceSpans`. Implies includeOTLPSchemaExtensions=true.\n",
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "traceId"
  ]
}