List Spans

result = client.spans.list(options?)
# Async
result = await client.spans.alist(options?)

class ListSpansResult(BaseModel):
    spans: list[SpanListItem]
    cursor: str | None
    has_more: bool              # alias: "hasMore"

result = client.spans.list()
print(f"Found {len(result.spans)} spans")

from tracia import ListSpansOptions

result = client.spans.list(ListSpansOptions(
    prompt_slug="welcome-email",
    status="SUCCESS",
))

for span in result.spans:
    print(f"{span.span_id}: {span.latency_ms}ms, {span.total_tokens} tokens")

from datetime import datetime
from tracia import ListSpansOptions

result = client.spans.list(ListSpansOptions(
    start_date=datetime(2024, 1, 1),
    end_date=datetime(2024, 1, 31),
))

from tracia import ListSpansOptions

result = client.spans.list(ListSpansOptions(
    tags=["production", "v2"],  # Must have ALL tags
))

from tracia import ListSpansOptions

def get_all_spans():
    all_spans = []
    cursor = None

    while True:
        result = client.spans.list(ListSpansOptions(limit=100, cursor=cursor))
        all_spans.extend(result.spans)
        if not result.has_more:
            break
        cursor = result.cursor

    return all_spans

from datetime import datetime
from tracia import ListSpansOptions

result = client.spans.list(ListSpansOptions(
    prompt_slug="welcome-email",
    start_date=datetime(2024, 1, 1),
))

total_cost = sum(s.cost or 0 for s in result.spans)
total_tokens = sum(s.total_tokens for s in result.spans)

print(f"Total cost: ${total_cost:.4f}")
print(f"Total tokens: {total_tokens}")

from tracia import TraciaError, TraciaErrorCode

try:
    result = client.spans.list()
except TraciaError as error:
    if error.code == TraciaErrorCode.UNAUTHORIZED:
        print("Invalid API key")