Skip to main content

RealTimeOptimizer

Struct RealTimeOptimizer 

Source
pub struct RealTimeOptimizer { /* private fields */ }
Expand description

Real-time performance optimizer.

Drives a single discrete knob — RTOptimizationState::optimization_level — from measured latency behaviour: it escalates while the observed deadline-miss rate is too high, relaxes while there is ample headroom, and reports the improvement it can actually attribute to its last move by comparing the current measured average against the average recorded at the moment that move was made.

Implementations§

Source§

impl RealTimeOptimizer

Source

pub fn new(config: RealTimeConfig) -> Result<Self>

Source

pub fn observe_latency(&mut self, latency: Duration)

Record one real end-to-end processing latency.

This is what turns the optimizer from a constructed-and-forgotten object into a controller: without observations it has nothing to optimize, and Self::optimize_realtime honestly reports “nothing applied, nothing measured”.

Source

pub fn observe_utilization( &mut self, cpu_utilization: f64, memory_pressure: f64, )

Record the real resource utilisation observed by the caller.

Source

pub fn performance_metrics(&self) -> &RealTimeMetrics

Measured real-time metrics.

Source

pub fn optimization_state(&self) -> &RTOptimizationState

Current optimization state.

Source

pub fn observation_count(&self) -> usize

Number of latency observations recorded so far.

Source

pub fn optimize_realtime( &mut self, latency_budget: Duration, ) -> Result<RTOptimizationResult>

Re-evaluate the real-time optimization level against latency_budget.

The returned figures are measurements, not estimates:

  • optimization_applied is true only when this call actually changed the optimization level.
  • performance_gain is baseline_avg / current_avg, where the baseline is the measured average at the moment the current level was entered — exactly 1.0 while nothing has been changed yet.
  • latency_reduction_ms is the corresponding measured difference, and is negative if the last change made things worse.

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<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

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

Initializes a with the given initializer. Read more
Source§

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

Dereferences the given pointer. Read more
Source§

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

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

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

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

Source§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
Source§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
Source§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
Source§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
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.
Source§

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

Source§

fn vzip(self) -> V