Cloady Docs
API ReferenceEndpointsWorkspaces

Read a trace

Returns the spans the workspace's apps sent in a trace, in tree order, with each span's service, timing, status, first exception and attributes. Spans from outside the workspace are left out. Answers 404 when no span of the trace belongs to the workspace, it was sampled out, or it is older than 7 days.

GET
/api/workspaces/{workspaceSlug}/traces/{traceId}
AuthorizationBearer <token>

Personal API token (cldy_…)

In: header

Path Parameters

workspaceSlug*string
traceId*string

Trace id, up to 32 hex characters

Query Parameters

around?integer

Unix milliseconds near the trace, such as a log line's time, which narrows the lookup

Range0 < value <= 9007199254740991

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/workspaces/string/traces/string"
{  "id": "string",  "start": 0,  "duration": 0,  "total": 0,  "spans": [    {      "id": "string",      "parent": "string",      "depth": 0,      "orphan": true,      "name": "string",      "kind": "server",      "app": "string",      "env": "production",      "service": "string",      "start": 0,      "duration": 0,      "status": "ok",      "message": "string",      "exception": {        "type": "string",        "message": "string",        "stack": "string"      },      "attributes": {        "property1": "string",        "property2": "string"      }    }  ]}