Struct StatsHandle 

pub struct StatsHandle { /* private fields */ }

Tier-scoped wrapper around Stats. What crate::Client::with_stats and crate::Server::with_stats accept. Cheap to clone.

Implementations

impl StatsHandle

pub fn parent(&self) -> &Stats

The aggregator this handle is tied to.

pub fn tier(&self) -> Tier

The tier this handle bumps into.

pub fn broadcast(&self, path: impl AsPath) -> BroadcastStats

Returns a per-broadcast handle scoped to this tier.

Paths under the aggregator’s configured prefix return an empty handle whose bumps are no-ops. This keeps stats traffic from feeding back into the aggregator.

pub fn publisher_broadcasts(&self) -> SessionBroadcasts

Per-session egress (publisher) broadcast-subscription tracker. Construct one per session and call SessionBroadcasts::subscribe for each downstream subscription so broadcasts - broadcasts_closed counts the distinct sessions watching each broadcast.

pub fn subscriber_broadcasts(&self) -> SessionBroadcasts

Per-session ingress (subscriber) counterpart to Self::publisher_broadcasts.

pub fn session(&self, root: impl AsPath) -> SessionStats

Record a connected session authenticated under root on this tier. Hold the returned guard for the session’s lifetime; dropping it bumps sessions_closed. Counts presence regardless of any data flow, so a session that merely connects is still billable. Surfaced on the session track for this tier, keyed by root.

Trait Implementations

impl Clone for StatsHandle

fn clone(&self) -> StatsHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for StatsHandle

fn default() -> Self

A no-op handle backed by a Stats::default aggregator.