traces

Trace Of Request

Changed on

The session a gateway request was traced into, by the Otari-Request-ID it was sent.

The usage log's request_group_id is that id, so a request log row opens its session here. A request outside the scope, or with no trace stored, is a 404.

get/api/v1/traces/requests/{request_id}

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header Otari-Key
    • API key in header x-api-key

Path parameters

request_idstring required

Response

Successful Response

api_key_idstring nullable required
costnumber required

USD, a snapshot of the usage rows' cost. Usage stays the billing record.

error_countinteger required

Spans that ended in an error no fallback recovered, including tools' errors, which do not fail the session.

harnessstring nullable required

The agent or client that sent the requests, from its User-Agent.

input_tokensinteger required
last_activity_atstring date-time required
namestring nullable required
output_tokensinteger required
session_source'client' | 'harness' | 'otlp' | 'none' required

What grouped the session's requests: the client's own id, its agent harness's id, an OTLP conversation id, or nothing (a single request).

span_countinteger required
started_atstring date-time required
step_countinteger required

Requests the gateway served in the session.

trace_idstring required
user_idstring nullable required
workspace_idstring uuid required

Changes