Sign in
OTel

Status of the most recent Temps Cloud telemetry backfill for a project.

Changed on
get/otel/cloud-telemetry/backfill/{project_id}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/otel/cloud-telemetry/backfill/{project_id}
  • Auth: HTTP bearer

Path parameters

project_idinteger required

Project ID

Response

Backfill status

backfill_availableboolean required

Whether a backfill would be accepted right now. False means the project is still at metered fidelity.

commandstring required

The exact command an operator should run. Always present, in every state, so the capability is discoverable from the Console even though the Console deliberately cannot trigger it.

completed_atstring date-time nullable
fidelity'metered' | 'queryable' required

Per-project fidelity tier for the optional Temps Cloud telemetry mirror.

last_errorstring nullable

Reason the last run stopped, when status is failed. Verbatim, but length-bounded: it originates as raw driver/server text and is readable by every project member with OtelRead, not only whoever ran the command.

percent_completenumber double nullable

spans_processed / spans_total, clamped to 0–100. None when the total is unknown or zero — an empty window is not "0% done".

project_idinteger required
setup_pathstring nullable

Where to go to raise fidelity, when backfill_available is false.

spans_processedinteger required
spans_totalinteger required
started_atstring date-time nullable
status'not_started' | 'running' | 'completed' | 'failed' required

Lifecycle of the most recent backfill run for a project.

updated_atstring date-time nullable

Bumped on every progress write. A running status whose updated_at is far in the past is a stalled run, and the client should say so instead of showing a spinner forever.

window_fromstring date-time nullable
window_tostring date-time nullable

Changes

  • 4b228ebed583Revision changes
    • 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

      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