Struct QueryTraceBuilder 

pub struct QueryTraceBuilder { /* private fields */ }

Builder for creating and tracking query execution traces.

Example

use fraiseql_core::runtime::query_tracing::QueryTraceBuilder;

let mut builder = QueryTraceBuilder::new("query_123", "{ user { id name } }");

// Record parse phase (2.5ms = 2500 microseconds)
builder.record_phase_success("parse", 2500);

// Record validate phase (3ms = 3000 microseconds)
builder.record_phase_success("validate", 3000);

// Record execute phase (7ms = 7000 microseconds)
builder.record_phase_success("execute", 7000);

// Finalize trace with result count
let trace = builder.finish(true, None, Some(42))?;
assert_eq!(trace.success, true);
assert_eq!(trace.result_count, Some(42));
println!("Query took {} microseconds", trace.total_duration_us);

Implementations

impl QueryTraceBuilder

pub fn new(query_id: &str, query: &str) -> Self

Create new query trace builder.

Arguments

• query_id - Unique ID for query correlation
• query - Query string (will be truncated if very long)

pub fn record_phase_success(&mut self, phase_name: &str, duration_us: u64)

Record a phase that completed successfully.

Arguments

• phase_name - Name of phase (e.g., “parse”, “validate”)
• duration_us - Duration in microseconds

pub fn record_phase_error( &mut self, phase_name: &str, duration_us: u64, error: &str, )

Record a phase that failed.

Arguments

• phase_name - Name of phase (e.g., “parse”, “validate”)
• duration_us - Duration in microseconds
• error - Error message

pub fn finish( self, success: bool, error: Option<&str>, result_count: Option<usize>, ) -> Result<QueryExecutionTrace>

Finish tracing and create final trace record.

Arguments

• success - Whether query executed successfully
• error - Optional error message
• result_count - Number of results returned (if applicable)

Returns

Complete query execution trace

pub fn query_id(&self) -> &str

Get query ID for logging/correlation.

pub fn elapsed_us(&self) -> u64

Get current elapsed time in microseconds.