Struct TopSpansQuery 

pub struct TopSpansQuery {
    pub start_time: Option<i64>,
    pub end_time: Option<i64>,
    pub limit: Option<usize>,
    pub sort_by: TopSpanSort,
    pub truncated_only: bool,
    pub agent: Option<String>,
    pub model: Option<String>,
    pub provider: Option<String>,
    pub project: Option<String>,
    pub session: Option<String>,
}

Query parameters for top-spans endpoint

Fields

start_time: Option<i64>

Start time (nanoseconds since Unix epoch)

end_time: Option<i64>

End time (nanoseconds since Unix epoch)

limit: Option<usize>

Maximum number of spans to return (default 20, capped at 100)

sort_by: TopSpanSort

Sort dimension: total_tokens (default), duration, output_input_ratio (output divided by all input context), cache_efficiency

truncated_only: bool

When true, return only spans with finish_reason max_tokens or length

agent: Option<String>

Agent family filter: claude, opencode, or codex

model: Option<String>

Model name filter

provider: Option<String>

Provider filter

project: Option<String>

Project id filter (opencode data only)

session: Option<String>

Session id filter

Trait Implementations

impl Debug for TopSpansQuery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TopSpansQuery

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl IntoParams for TopSpansQuery

fn into_params( parameter_in_provider: impl Fn() -> Option<ParameterIn>, ) -> Vec<Parameter>

Provide Vec of openapi::path::Parameters to caller. The result is used in utoipa-gen library to provide OpenAPI parameter information for the endpoint using the parameters.

impl Serialize for TopSpansQuery

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'__s> ToSchema<'__s> for TopSpansQuery

fn schema() -> (&'__s str, RefOr<Schema>)

Return a tuple of name and schema or reference to a schema that can be referenced by the name or inlined directly to responses, request bodies or parameters.

fn aliases() -> Vec<(&'__s str, Schema)>

Optional set of alias schemas for the ToSchema::schema.