Struct reool::instrumentation::StateCounters

pub struct StateCounters { /* fields omitted */ }

Simply tracks the following values:

• number of existing connections
• number of idle connections
• number of in flight connections
• number of reservations
• number of tasks waiting before the lock

This is mostly useful for testing purposes only.

Call the instrumentation method to create an Instrumentation that can be put into a pool.

The logged or printed output might not be accurate since there are multiple race conditions possible inside the StateCounters. This is desired behaviour to not block threads. So the values you see in the output might already have changed to something different when logged.

Methods

impl StateCounters

pub fn new() -> Self

Create a new StateCounter.

This method checks the environment:

• If an env var "PRINT" is set, counter changes will be printed to stdout.
• If an env var "LOG" or "RUST_LOG" is set counter changes will be logged at info level

pub fn with_logging() -> Self

Log counter changes at info level

pub fn with_printing() -> Self

Print counter changes to stdout

pub fn state(&self) -> PoolState

pub fn connections(&self) -> usize

pub fn idle(&self) -> usize

pub fn in_flight(&self) -> usize

pub fn reservations(&self) -> usize

pub fn pools(&self) -> usize

pub fn instrumentation(&self) -> StateCountersInstrumentation

Create the Instrumentation to be put into the pool to instrument.

Trait Implementations

impl Clone for StateCounters

fn clone(&self) -> StateCounters

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for StateCounters

fn default() -> StateCounters

Returns the "default value" for a type.