Struct StatsPathProjector 

pub struct StatsPathProjector<'a> { /* private fields */ }

Auto-projector handle returned by SampleSeries::stats_path. Walks a stats sub-tree per sample and exposes scalar / nested projections for the keys at that level.

Implementations

impl<'a> StatsPathProjector<'a>

pub fn field_u64(&self, key: &str) -> SeriesField<u64>

Project a JSON key under the resolved path as u64.

pub fn field_i64(&self, key: &str) -> SeriesField<i64>

Project a JSON key under the resolved path as i64.

pub fn field_f64(&self, key: &str) -> SeriesField<f64>

Project a JSON key under the resolved path as f64.

pub fn key(&self, key: &str) -> StatsPathProjector<'a>

Return a sub-projector rooted under key. Composable — series.stats_path("layers").key("batch").field_f64("util") drills into the per-layer scheduler stats one segment at a time without each call site re-typing the full dotted path.

pub fn key_names(&self) -> Vec<String>

Discover the JSON object keys of the resolved path, unioned across ALL samples (sorted, deduplicated). Empty ONLY when no sample resolves the path to an object.

Discovery spans every row rather than sample 0 alone: a scheduler-defined scx_stats object can be absent or Err in sample 0 (the first capture often predates the scheduler’s first stats emit) while later samples carry it; reading only sample 0 would silently return no keys and blind a “assert over every scx_stats counter” blanket projection.

pub fn u64_fields(&self) -> Vec<(String, SeriesField<u64>)>

Project every object key that resolves as u64 for at least one sample. Iterates Self::key_names, calls Self::field_u64 for each, and keeps the entries whose resulting SeriesField has at least one Ok value — non-numeric leaves (strings, nested objects, floats) drop out.

pub fn f64_fields(&self) -> Vec<(String, SeriesField<f64>)>

Project every object key that resolves as f64 for at least one sample. Mirrors Self::u64_fields using Self::field_f64.