Struct Stats 

pub struct Stats { /* private fields */ }

Top-level stats aggregator. Cheap to clone (Arc inside). One instance per relay; sessions get tier-scoped handles via Stats::tier.

Implementations

impl Stats

pub fn new( prefix: impl Into<PathOwned>, levels: u32, node: impl Into<Option<String>>, origin: OriginProducer, ) -> Self

Build a new stats aggregator.

• prefix is the top-level path under which stats are published, e.g. .stats. The full advertised path is <prefix>/prefix/<level-path>/<node> (or <prefix>/prefix/<level-path> when node is None).
• levels is the maximum segment depth stats are bucketed by, which caps the number of aggregation buckets per broadcast. 0 disables stats entirely (no buckets, including no root bucket). 1 produces the root bucket plus a per-first-segment bucket. 2 adds a per-second-segment bucket, and so on. A broadcast within the configured depth also gets its own dedicated bucket; broadcasts deeper than levels are truncated.
• node disambiguates broadcasts published by different relays into a shared cluster origin. Set this on every node in multi-relay deployments. None omits the suffix, which is fine for single-relay deployments.
• origin is the OriginProducer that receives publish_broadcast calls for each stats broadcast.

pub fn disabled() -> Self

A no-op aggregator. Counter bumps are silently dropped and no snapshot task is ever spawned. Use this when stats are disabled so call sites can hold a Stats (or StatsHandle) unconditionally.

pub fn prefix(&self) -> &Path<'static>

Returns the configured top-level prefix.

pub fn tier(&self, tier: Tier) -> StatsHandle

Returns a tier-scoped handle. Bumps through this handle land in the tier’s counters.

Trait Implementations

impl Clone for Stats

fn clone(&self) -> Stats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Stats

fn default() -> Self

Returns the “default value” for a type.