Timeline

Struct Timeline 

Source
pub struct Timeline {
    pub phases: Vec<Phase>,
}
Expand description

Correlated timeline of stimulus events and monitor observations.

Fields§

§phases: Vec<Phase>

Implementations§

Source§

impl Timeline

Source

pub fn build( stimulus_events: &[StimulusEvent], monitor_samples: &[MonitorSample], preemption_threshold_ns: u64, ) -> Self

Build a timeline from stimulus events and monitor samples.

Clock alignment: stimulus events use guest monotonic time (ms since scenario start). Monitor samples use host monotonic time (ms since VM boot). The first stimulus event’s timestamp and the first non-trivial monitor sample (after 500ms warmup) approximately coincide. We compute an offset to align them.

Returns an empty timeline if either input is empty. Build a Timeline from stimulus events + raw monitor samples via the per-window compute_metrics reduction. The production success path uses Self::from_phase_buckets (which folds pre-bucketed PhaseBuckets); build is the fallback evaluate_vm_result takes only for a run with an EMPTY PhaseBuckets vec but monitor samples present — i.e. no periodic captures AND no stimulus Steps. A monitor-only run that DID run Steps now synthesizes a capture-free bucket per StepStart (see crate::assert::build_phase_buckets_with_stimulus), so its vec is non-empty and it takes the from_phase_buckets path (whose fold_monitor_into_bucket recovers the same monitor-derived metric set this path computes). Both entry points produce the same Timeline field shape; from_phase_buckets is preferred when buckets are available because it avoids the per-MonitorSample reduction.

preemption_threshold_ns threads the vCPU-preemption exemption window into the per-phase stall predicate (see compute_metrics); the production caller passes the run’s MonitorReport::preemption_threshold_ns. 0 derives it from the guest kernel CONFIG_HZ.

Source

pub fn format_with_context(&self, ctx: &TimelineContext) -> String

Format the timeline with a system context header.

Tests without a real context pass &TimelineContext::default(); the header lines (kernel:, topology:, etc.) are omitted but the --- timeline --- prefix is preserved.

Source

pub fn from_phase_buckets( phase_buckets: &[PhaseBucket], stimulus_events: &[StimulusEvent], _ctx: &TimelineContext, ) -> Self

Build a Timeline from pre-bucketed crate::assert::PhaseBuckets emitted by the metric pipeline. Preferred over Self::build when the caller already has PhaseBuckets in hand — avoids re-deriving phase boundaries from stimulus events + monitor samples by walking the buckets directly.

One Phase is emitted per bucket, in step_index order. PhaseMetrics fields are populated from the bucket’s metrics map via a name-keyed mapping:

PhaseBucket metric keyPhaseMetrics field
max_imbalance_ratiomax_imbalance
avg_imbalance_ratioavg_imbalance
max_dsq_depthmax_dsq_depth
avg_dsq_depthavg_dsq_depth
avg_nr_runningavg_nr_running
stuck_countstuck_count
total_fallbackfallback_rate (rate)
total_keep_lastkeep_last_rate (rate)
iteration_rateiteration_rate

Rate fields (fallback_rate, keep_last_rate) are divided by mean delivered vCPU CPU-seconds. They stay None when complete vCPU CPU clock coverage is unavailable.

iteration_rate is present only when matching guest per-cgroup phase carriers provide both iterations and positive CPU time. It defaults to None when PhaseBucket.metrics has no such rate.

changes (boundary degradation detection) IS computed here by diffing adjacent PhaseMetrics fields — same detection logic Self::build uses, applied after the per-bucket conversion. avg_imbalance + avg_dsq_depth are supplied by PhaseBucket so the detection runs on the same fields as the legacy path.

Trait Implementations§

Source§

impl Clone for Timeline

Source§

fn clone(&self) -> Timeline

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Timeline

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSend for T
where T: Send,