Skip to main content

Pressure

Struct Pressure 

Source
#[non_exhaustive]
pub struct Pressure { pub level: PressureLevel, pub some: Stall, pub full: Option<Stall>, pub total: Option<Duration>, }
Expand description

How much work is stalled waiting for a resource (CPU, memory, or I/O).

The best single sign that a machine, or a container, is overloaded: it measures waiting rather than busyness. A CPU at 100% with nothing stalled is doing its job; with 30% of the time stalled it is turning work away. cpu::pressure, mem::pressure, and disk::pressure return it.

On Linux it is the kernel’s pressure-stall information (PSI, kernel 4.20 and later), read from the process’s own cgroup when it has one, so a container sees its own pressure, and from /proc/pressure/ otherwise. Where an OS reports only a level (macOS and Windows memory), the stall shares are zero and total is None.

use sys_lib::{self as sys, PressureLevel};

if let Some(p) = sys::cpu::pressure()? {
    if p.level >= PressureLevel::Warning {
        println!("tasks waited for a CPU {} of the last 10 s", p.some.avg10);
    }
}

Fields (Non-exhaustive)§

This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.
§level: PressureLevel

The level the stall shares amount to (see the thresholds).

§some: Stall

The share of time at least one task was stalled.

§full: Option<Stall>

The share of time every non-idle task was stalled at once (None for CPU at the host level, where the kernel does not report it).

§total: Option<Duration>

The cumulative time tasks were stalled (some), when reported.

Implementations§

Source§

impl Pressure

Source

pub const WARNING_SOME_AVG10: f32 = 10.0

some.avg10 at or above this is PressureLevel::Warning.

Source

pub const CRITICAL_SOME_AVG10: f32 = 40.0

some.avg10 at or above this is PressureLevel::Critical.

Source

pub const CRITICAL_FULL_AVG10: f32 = 10.0

full.avg10 above this is PressureLevel::Critical.

Trait Implementations§

Source§

impl Clone for Pressure

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for Pressure

Source§

impl Debug for Pressure

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for Pressure

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Pressure

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.

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> 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 = !

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

fn try_from(value: U) -> Result<T, !>

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.