Traces - TrueFoundry Docs

Methods

query_spans

Parameters

Parameters

str

required

Start time in ISO 8601 format (e.g., 2025-03-12T00:00:09.872Z)

typing.Optional[str]

End time in ISO 8601 format (e.g., 2025-03-12T00:10:00.000Z). Defaults to current time if not provided.

typing.Optional[typing.Sequence[str]]

Array of trace IDs to filter by

typing.Optional[typing.Sequence[str]]

Array of span IDs to filter by

typing.Optional[typing.Sequence[str]]

Array of parent span IDs to filter by

typing.Optional[typing.Sequence[SubjectType]]

🔗 SubjectTypeArray of subject types to filter by

typing.Optional[typing.Sequence[str]]

Array of subject slugs to filter by

typing.Optional[typing.Sequence[str]]

Array of application names to filter by

typing.Optional[int]

The maximum number of spans to return per page. Defaults to 200 if not provided.

typing.Optional[SortDirection]

🔗 SortDirectionSort direction for results based on time. Defaults to descending (latest first)

typing.Optional[str]

An opaque string that should be passed as-is from previous response for fetching the next page. Pass $response.pagination.nextPageToken from previous response for fetching the next page.

typing.Optional[str]

Tracing project FQN (e.g., truefoundry:tracing-project:tfy-default)

typing.Optional[str]

Data Routing Destination. One of tracingProjectFqn or dataRoutingDestination is required.

typing.Optional[typing.Sequence[QuerySpansRequestFiltersItem]]

🔗 QuerySpansRequestFiltersItemArray of filters

typing.Optional[bool]

When true, feedback data is included in the response. When false, feedback data is excluded (returns empty array).

Returns

🔗 QuerySpansResponseReturns all the spans matching the query.

Usage

from truefoundry import TrueFoundry

client = TrueFoundry(
    api_key="YOUR_API_KEY",
    base_url="https://yourhost.com/path/to/api",
)

client.traces.query_spans(
    start_time="value",
    end_time="value",
    trace_ids="value",
    span_ids="value",
    parent_span_ids="value",
    created_by_subject_types="value",
    created_by_subject_slugs="value",
    application_names="value",
    limit=10,
    sort_direction="value",
    page_token="value",
    tracing_project_fqn="value",
    data_routing_destination="value",
    filters="value",
    include_feedbacks="value",
)

⌘I