Struct HostTelemetry 

pub struct HostTelemetry {
    pub max_samples: usize,
    pub ttl: Option<u8>,
    pub distance_hops: Option<u8>,
    /* private fields */
}

Performance and discovery metrics for a specific network host.

HostTelemetry maintains a sliding window of Round-Trip Time (RTT) measurements and performs statistical analysis (Averaging and Jitter) used for network health assessment.

Fields

max_samples: usize

The maximum number of RTT samples to maintain. If this limit is reached, adding a new sample will purge the oldest one.

ttl: Option<u8>

The Time-to-Live (TTL) value from the most recently received response.

distance_hops: Option<u8>

The calculated network distance in hops, derived from TTL or traceroute probes.

Implementations

impl HostTelemetry

pub fn new(max_samples: usize) -> Self

Creates a new HostTelemetry instance with a specific sample window size.

pub fn history(&self) -> &VecDeque<(Instant, Duration)>

Returns a read-only view of the RTT sample history.

pub fn add_rtt(&mut self, rtt: Duration)

Adds a new RTT measurement at the current system time.

pub fn add_rtt_at(&mut self, time: Instant, rtt: Duration)

Adds a timed RTT measurement to the history, enforcing the sliding window cap.

pub fn lartt(&self) -> Option<Duration>

Returns the Last-Added Round-Trip Time (LARTT).

pub fn min_rtt(&self) -> Option<Duration>

Returns the minimum (fastest) RTT recorded in the current window.

pub fn max_rtt(&self) -> Option<Duration>

Returns the maximum (slowest) RTT recorded in the current window.

pub fn average_rtt(&self) -> Option<Duration>

Calculates the arithmetic mean RTT from all samples in the window.

pub fn jitter(&self) -> Option<Duration>

Calculates the network jitter as the Average Absolute Difference between consecutive RTT samples.

Jitter provides a measure of network stability. A high jitter relative to the average RTT often indicates network congestion or bufferbloat.

pub fn merge(&mut self, other: HostTelemetry)

Merges telemetry from another record, Ensuring chronological sortedness and prioritizing the newest data points.

If the incoming record has a larger max_samples configuration, this telemetry container will upgrade its own window size to match.

Trait Implementations

impl Clone for HostTelemetry

fn clone(&self) -> HostTelemetry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostTelemetry

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

Formats the value using the given formatter.

impl Default for HostTelemetry

fn default() -> Self

Returns the “default value” for a type.

impl Display for HostTelemetry

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

Formats the value using the given formatter.

impl Eq for HostTelemetry

impl PartialEq for HostTelemetry

fn eq(&self, other: &HostTelemetry) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for HostTelemetry