Struct QueryOptions 

pub struct QueryOptions {
    pub parent: Option<String>,
    pub aggregated: bool,
    pub sort: SortMode,
    pub search: Option<String>,
    pub max_depth: u32,
    pub depth: u32,
    pub page: usize,
    pub page_size: Option<usize>,
}

Options for querying spans from the trace store.

Fields

parent: Option<String>

Optional parent span ID (as produced by SpanInfo::id). None means root level.

aggregated: bool

When true, aggregate child spans with the same name.

sort: SortMode

How to sort the results.

search: Option<String>

Optional substring search query.

Matches the parent’s entire subtree, not just its direct children. Each result’s id is the full path from parent down to the match, so it can be passed straight back as parent.

Cost scales with the size of that subtree, so a root search on a large trace walks everything. Setting parent, or lowering max_depth, bounds it.

max_depth: u32

Maximum depth to descend below parent when search is set, or when depth requests a nested subtree. Clamped to DEFAULT_SEARCH_MAX_DEPTH.

depth: u32

When greater than 1, each returned span carries this many levels of descendants inline in children.

page: usize

1-based page number.

page_size: Option<usize>

Number of spans per page. Clamped to MAX_PAGE_SIZE; None uses DEFAULT_PAGE_SIZE.