Get span export status

Retrieve the status, and when complete the result location, of an async span export.

Poll this with the export_id returned by POST /v5/spans/export. Only exports that ran as async jobs on the tracing service have a pollable status; synchronous exports from the legacy trace store return their result directly and have no export id to poll here. The lookup is proxied to the tracing service and scoped to the caller’s account; a tracing-service failure surfaces as a 503.

GET /v5/spans/export/{export_id}

Get span export status

cURL

curl --request GET \
  --url https://api.egp.scale.com/v5/spans/export/{export_id} \
  --header 'x-api-key: <api-key>'

200

{
  "export_id": "<string>",
  "status": "running",
  "run_id": "<string>",
  "rows_written": 123,
  "bytes_written": 123,
  "shards_completed": 123,
  "shards_total": 123,
  "filename": "<string>",
  "signed_url": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "from_ts": "2023-11-07T05:31:56Z",
  "to_ts": "2023-11-07T05:31:56Z",
  "snapshot_ts": "2023-11-07T05:31:56Z",
  "truncated": {
    "reason": "<string>",
    "rows_exported": 123,
    "resume_after": "<string>"
  },
  "staged_file": {
    "key": "<string>",
    "size_bytes": 123,
    "sha256": "<string>"
  },
  "reason": "<string>",
  "guidance": "<string>"
}

Authorizations

x-api-key · string · header · required

Headers

x-selected-account-id · string | null

Path Parameters

export_id · string · required

Response

200

application/json

Successful Response

Status for GET /v5/spans/export/{export_id} (mirrors the sgp-traces status object).

Always returned with HTTP 200; unknown or cross-account ids arrive as failed with reason=not_found.

export_id · string · required

The export id echoed back.

status · enum<string> · required

Lifecycle state.

Available options: running, succeeded, failed

run_id · string | null

Temporal run id of the export workflow.

rows_written · integer | null

Rows written so far (running).

bytes_written · integer | null

Bytes written so far (running).

shards_completed · integer | null

Export shards completed so far (running). A shard here is one of the export's concurrent read windows over the export time range, not a storage shard.

shards_total · integer | null

Total shards in the export plan, the time windows the export window is split into for concurrent reads (running).

filename · string | null

Name of the exported file (succeeded).

signed_url · string | null

Pre-signed download URL (succeeded).

expires_at · string<date-time> | null

When the signed URL expires.

from_ts · string<date-time> | null

Resolved start of the window.

to_ts · string<date-time> | null

Resolved end of the window.

snapshot_ts · string<date-time> | null

Snapshot the export read at.

truncated · SpansExportTruncation · object | null

Present when the export hit a budget.

Show child attributes

staged_file · SpansExportStagedFile · object | null

The export artifact's commit handle in the Datasets workspace grant, present only for a staged export (succeeded); signed_url is absent in that case.

Show child attributes

reason · string | null

Terminal failure reason (failed): not_found (unknown or cross-account export id, or a result that expired or predates the object-storage cutover), invalid_input (the request was rejected, and guidance names what to change), resource_exhausted, timed_out, resume_cursor_stale (the resume cursor does not match how this export is ordered), canceled, terminated, failed (no cause recorded), or internal (server-side fault).

guidance · string | null

Human-readable, actionable next step for a failed export (failed).