Struct DhtStats 

pub struct DhtStats {
    pub total_registrations: usize,
    pub unique_keys: usize,
    pub unique_trust_roots: usize,
    pub max_registrations_per_key: usize,
    pub avg_registrations_per_key: f64,
    pub path_depth_histogram: Vec<usize>,
    pub memory_bytes: usize,
}

Statistics about the DHT state.

Used for evaluation metrics and monitoring.

Fields

total_registrations: usize

Total number of active registrations.

unique_keys: usize

Number of unique DHT keys with registrations.

unique_trust_roots: usize

Number of unique trust roots.

max_registrations_per_key: usize

Maximum registrations at any single key.

This counts materialized copies, so the largest bucket is ordinarily an ancestor key holding a whole subtree. It is an observation and not a limit: nothing bounds it, and it routinely exceeds SimulationConfig::max_registrations_per_capability, which bounds only the key an agent registers at.

avg_registrations_per_key: f64

Average registrations per key.

path_depth_histogram: Vec<usize>

Histogram of path depths.

memory_bytes: usize

Estimated memory usage in bytes.

Implementations

impl DhtStats

pub fn new() -> Self

Creates empty stats.

pub const fn total_registrations(&self) -> usize

Returns the total registrations.

pub const fn unique_keys(&self) -> usize

Returns the unique keys count.

pub const fn unique_trust_roots(&self) -> usize

Returns the unique trust roots count.

pub const fn max_registrations_per_key(&self) -> usize

Returns the maximum registrations at any key.

See DhtStats::max_registrations_per_key for why this is not bounded by the configured capacity.

pub const fn avg_registrations_per_key(&self) -> f64

Returns the average registrations per key.

pub const fn memory_bytes(&self) -> usize

Returns the memory usage estimate.

Trait Implementations

impl Clone for DhtStats

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DhtStats

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

Formats the value using the given formatter.

impl Default for DhtStats

fn default() -> Self

Returns the “default value” for a type.