Documentation | Spans

post/v5/spans

Create Span

client.spans.retrieve() ->

get/v5/spans/{span_id}

Get Span

client.spans.search() -> SyncCursorPage[

]

post/v5/spans/search

Search and list spans

Parameters

ending_before: Optional[str]

from_ts: Optional[Union[str, datetime]]

(format: date-time)

The starting (oldest) timestamp in ISO format.

limit: Optional[int]

(maximum: 1000, minimum: 1, default: 100)

sort_order: Optional[Literal["asc", "desc"]]

(default: "asc")

"asc"

"desc"

starting_after: Optional[str]

to_ts: Optional[Union[str, datetime]]

(format: date-time)

The ending (most recent) timestamp in ISO format.

application_variant_ids: Optional[

[str]]

Filter by application variant IDs

excluded_span_ids: Optional[

[str]]

List of span IDs to exclude from results

excluded_trace_ids: Optional[

[str]]

List of trace IDs to exclude from results

extra_metadata: Optional[Dict[str,

]]

Filter on custom metadata key-value pairs

group_id: Optional[str]

Filter by group ID

names: Optional[

[str]]

Filter by trace/span name

parents_only: Optional[

bool

]

Only fetch spans that are the top-level (ie. have no parent_id)

search_texts: Optional[

[str]]

Free text search across span input and output fields

span_ids: Optional[

[str]]

Filter by span IDs

statuses: Optional[List[

SpanStatus

]]

Filter on span status

"SUCCESS"

"ERROR"

"CANCELED"

trace_ids: Optional[

[str]]

Filter by trace IDs

types: Optional[List[

SpanType

]]

"TEXT_INPUT"

"TEXT_OUTPUT"

"COMPLETION_INPUT"

"COMPLETION"

"KB_RETRIEVAL"

"KB_INPUT"

"RERANKING"

"EXTERNAL_ENDPOINT"

"PROMPT_ENGINEERING"

"DOCUMENT_INPUT"

"MAP_REDUCE"

"DOCUMENT_SEARCH"

"DOCUMENT_PROMPT"

"CUSTOM"

"CODE_EXECUTION"

"DATA_MANIPULATION"

"EVALUATION"

"FILE_RETRIEVAL"

"KB_ADD_CHUNK"

"KB_MANAGEMENT"

"GUARDRAIL"

"TRACER"

"AGENT_TRACER"

"AGENT_WORKFLOW"

"STANDALONE"

Returns

id: str

account_id: str

name: str

start_timestamp:

datetime

(format: date-time)

trace_id: str

(maxLength: 38)

id for grouping traces together, uuid is recommended

application_interaction_id: Optional[str]

The interaction ID this span belongs to

application_variant_id: Optional[str]

The id of the application variant this span belongs to

created_by: Optional[Identity]

The identity that created the entity.

end_timestamp: Optional[datetime]

(format: date-time)

group_id: Optional[str]

Reference to a group_id

input: Optional[Dict[str,

]]

metadata: Optional[Dict[str,

]]

object: Optional[Literal["span"]]

(default: "span")

output: Optional[Dict[str,

]]

parent_id: Optional[str]

Reference to a parent span_id

status: Optional[SpanStatus]

type: Optional[SpanType]

Request example

from scale_gp_beta import SGPClient

client = SGPClient(
    api_key="My API Key",
)
page = client.spans.search()
page = page.items[0]
print(page.id)

200Example

{
  "has_more": true,
  "items": [
    {
      "id": "id",
      "account_id": "account_id",
      "name": "name",
      "start_timestamp": "2019-12-27T18:11:19.117Z",
      "trace_id": "trace_id",
      "application_interaction_id": "application_interaction_id",
      "application_variant_id": "application_variant_id",
      "created_by": {
        "id": "id",
        "type": "user",
        "object": "identity"
      },
      "end_timestamp": "2019-12-27T18:11:19.117Z",
      "group_id": "group_id",
      "input": {
        "foo": "bar"
      },
      "metadata": {
        "foo": "bar"
      },
      "object": "span",
      "output": {
        "foo": "bar"
      },
      "parent_id": "parent_id",
      "status": "SUCCESS",
      "type": "TEXT_INPUT"
    }
  ],
  "total": 0,
  "limit": 0,
  "object": "list"
}

client.spans.update(, ) ->