Skip to main content

Stats

Struct Stats 

Source
#[non_exhaustive]
pub struct Stats {
Show 15 fields pub open: u64, pub accepted: u64, pub refused: u64, pub closed: u64, pub bytes_in: u64, pub bytes_out: u64, pub egress_denied: u64, pub killed: u64, pub slow_peers: u64, pub timeouts: u64, pub descriptor_pressure: u64, pub stale_completions: u64, pub session_panics: u64, pub workers_lost: u64, pub workers_detached: u64, /* private fields */
}
Expand description

Counters summed over the workers.

let server = net_io::serve("127.0.0.1:0", |_c| Ok(()))?;
let stats = server.stats();
println!("{} open, {} accepted", stats.open, stats.accepted);

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.
§open: u64

Connections open now.

§accepted: u64

Connections accepted.

§refused: u64

Connections refused.

§closed: u64

Connections closed.

§bytes_in: u64

Bytes received.

§bytes_out: u64

Bytes sent.

§egress_denied: u64

Writes the gate denied.

§killed: u64

Connections killed.

§slow_peers: u64

Connections closed for the minimum rate.

§timeouts: u64

Connections closed by a timeout.

§descriptor_pressure: u64

Times the process ran out of descriptors.

§stale_completions: u64

Completions for connections that had closed.

§session_panics: u64

Sessions that panicked.

§workers_lost: u64

Reactor workers whose loop ended on a panic or a failed wait. Such a worker takes no more connections (the others take them, and its own listening sockets, instead); its connections were closed when it ended.

§workers_detached: u64

Worker threads a stop left running: their connection was killed at the drain’s deadline, but its owner did not return within the grace after it (a blocking handler that never touches its socket). Each ends on its own.

Implementations§

Source§

impl Stats

Source

pub fn refused_for(&self, cause: RefusalCause) -> u64

Refusals with this cause (gate codes summed).

Source

pub fn closed_for(&self, reason: CloseReason) -> u64

Closes with this reason’s variant (inner values ignored).

Source

pub fn closes(&self) -> impl Iterator<Item = (CloseReason, u64)> + '_

Every close reason with a non-zero count, one entry per variant (inner values are not kept: Killed carries reason 0, Io class Other(0)).

let server = net_io::serve("127.0.0.1:0", |_c| Ok(()))?;
for (reason, n) in server.stats().closes() {
    println!("{}: {n}", reason.as_str());
}
Source

pub fn refusals(&self) -> impl Iterator<Item = (RefusalCause, u64)> + '_

Every refusal cause with a non-zero count (gate codes summed under Gate(0)).

Trait Implementations§

Source§

impl Clone for Stats

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 Stats

Source§

impl Debug for Stats

Source§

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

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

impl Default for Stats

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Eq for Stats

Source§

impl PartialEq for Stats

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 Stats

Auto Trait Implementations§

§

impl Forget for Stats

§

impl Freeze for Stats

§

impl Move for Stats

§

impl RefUnwindSafe for Stats

§

impl Send for Stats

§

impl Sync for Stats

§

impl Unpin for Stats

§

impl UnsafeUnpin for Stats

§

impl UnwindSafe for Stats

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.