Struct QueryTrace 

pub struct QueryTrace {

    pub trace_ctx: TraceCtx,
    pub trace_id: Option<String>,
    pub scope: ScopeKey,
    pub classification: ClassifyResult,
    pub plan: RoutePlan,
    pub leg_timings_ms: Vec<u64>,
    pub total_duration: Duration,
    pub raw_result_count: usize,
    pub merged_result_count: usize,
    pub duplicates_fused: usize,
    pub requested_views: Vec<RuntimeView>,
    pub executed_views: Vec<RuntimeView>,
    pub widenings: Vec<WideningDisclosure>,
    pub warnings: Vec<QueryWarning>,
    pub derived_candidate_receipts: Vec<RuntimeDerivedCandidateTraceV1>,
    pub kernel_degraded_reason: Option<String>,
    pub valid_as_of: Option<String>,
    pub recorded_as_of: Option<String>,
    pub temporal_mode: Option<String>,
}

Observability record for a single query execution.

Fields

trace_ctx: TraceCtx

Canonical trace context for cross-crate correlation.

trace_id: Option<String>

Phase status: compatibility / migration-only. Legacy trace_id extracted from trace_ctx for backward compat.

scope: ScopeKey

Scope used for this query.

classification: ClassifyResult

Classification result.

plan: RoutePlan

Route plan that was executed.

leg_timings_ms: Vec<u64>

Per-leg timing in milliseconds.

total_duration: Duration

Total query duration.

raw_result_count: usize

Number of raw results before merge.

merged_result_count: usize

Number of results after merge.

duplicates_fused: usize

Number of duplicates fused during merge.

requested_views: Vec<RuntimeView>

Distinct views requested by the route plan.

executed_views: Vec<RuntimeView>

Distinct views actually executed after degradation/widening.

widenings: Vec<WideningDisclosure>

Explicit widening/degradation disclosures.

warnings: Vec<QueryWarning>

Warnings and degradation notices.

derived_candidate_receipts: Vec<RuntimeDerivedCandidateTraceV1>

Semantic-memory derived candidate backend receipts observed while executing legs.

kernel_degraded_reason: Option<String>

Kernel scheduler degradation surfaced by attached runtime inference, if any.

valid_as_of: Option<String>

Bitemporal valid-time coordinate used for this query, if temporal.

recorded_as_of: Option<String>

Bitemporal recorded-time ceiling used for this query, if temporal.

temporal_mode: Option<String>

How the temporal coordinates were resolved: “exact”, “downgraded”, “none”.

Implementations

impl QueryTrace

pub fn from_pipeline( trace_ctx: TraceCtx, scope: ScopeKey, classification: ClassifyResult, plan: RoutePlan, leg_timings_ms: Vec<u64>, total_duration: Duration, merged: &MergedResults, warnings: Vec<QueryWarning>, ) -> Self

Create a trace from query pipeline components.

pub fn has_temporal_downgrade(&self) -> bool

Whether any temporal requests were downgraded.

pub fn has_scope_enforcement_warning(&self) -> bool

Whether scope enforcement was only partial.

pub fn has_import_staleness_warning(&self) -> bool

Whether import staleness was detected.

pub fn is_degraded(&self) -> bool

Whether any degradation warnings were emitted.

pub fn runtime_query_provenance(&self) -> RuntimeQueryProvenanceV1

Build a versioned provenance snapshot from this trace for cross-crate audit.

Trait Implementations

impl Clone for QueryTrace

fn clone(&self) -> QueryTrace

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for QueryTrace

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for QueryTrace

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for QueryTrace

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

where __S: Serializer,

Serialize this value into the given Serde serializer.