Traces

Assemble a unified cross-project span waterfall (Phase 2).

Changed on

Fans out to every project that holds spans for trace_id (up to 20 projects, 10,000 total spans). Spans are annotated with project_id/project_name and sorted by start_time ASC. truncated: true signals a hit on either cap; truncated_projects lists the dropped project IDs. See ADR-027 §4 for the full design.

get/otel/global/traces/{trace_id}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/otel/global/traces/{trace_id}
  • Auth: HTTP bearer

Path parameters

trace_idstring required

Trace ID (32 lowercase hex characters)

Query parameters

start_timestring

Window start (RFC 3339); pair with end_time, max 31 days

end_timestring

Window end (RFC 3339); pair with start_time, max 31 days

Response

Unified cross-project trace waterfall

end_timestring date-time required
error_countinteger required
has_redacted_spansboolean required

true when at least one project has cross_project_trace_sharing = false and its spans were therefore excluded from the result set.

span_countinteger required
start_timestring date-time required
total_duration_msnumber double required

Trace wall-clock duration in milliseconds (end_time – start_time).

trace_idstring required
truncatedboolean required

true when the 20-project or 10,000-span cap was hit.

truncated_projectsinteger[] required

project_ids excluded due to truncation (most-recent first_seen dropped first).

Changes

  • 4b228ebed583Revision changes
    • info

      added the new optional query request parameter end_time

    • info

      added the new optional query request parameter start_time

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      deleted the query request parameter end_time

    • warning

      deleted the query request parameter start_time

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status