Struct HostStats 

pub struct HostStats {
    pub total_requests: u64,
    pub successful_requests: u64,
    pub rate_limited: u64,
    pub server_errors: u64,
    pub client_errors: u64,
    pub last_success: Option<Instant>,
    pub last_rate_limit: Option<Instant>,
    pub request_times: Vec<Duration>,
    pub status_codes: HashMap<u16, u64>,
    pub cache_hits: u64,
    pub cache_misses: u64,
}

Record and report statistics for a crate::ratelimit::Host

Fields

total_requests: u64

Total number of requests made to this host

successful_requests: u64

Number of successful requests (2xx status)

rate_limited: u64

Number of requests that received rate limit responses (429)

server_errors: u64

Number of server error responses (5xx)

client_errors: u64

Number of client error responses (4xx, excluding 429)

last_success: Option<Instant>

Timestamp of the last successful request

last_rate_limit: Option<Instant>

Timestamp of the last rate limit response

request_times: Vec<Duration>

Request times for median calculation

status_codes: HashMap<u16, u64>

Status code counts

cache_hits: u64

Number of cache hits

cache_misses: u64

Number of cache misses

Implementations

impl HostStats

pub fn record_response(&mut self, status_code: u16, request_time: Duration)

Record a response with status code and request duration

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

Get median request time

pub fn error_rate(&self) -> f64

Get error rate (percentage)

pub fn success_rate(&self) -> f64

Get the current success rate (0.0 to 1.0)

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

Get average request time

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

Get the most recent request time

pub fn is_currently_rate_limited(&self) -> bool

Check if this host has been experiencing rate limiting recently

pub const fn record_cache_hit(&mut self)

Record a cache hit

pub const fn record_cache_miss(&mut self)

Record a cache miss

pub fn cache_hit_rate(&self) -> f64

Get cache hit rate (0.0 to 1.0)

pub fn summary(&self) -> String

Get human-readable summary of the stats

Trait Implementations

impl Clone for HostStats

fn clone(&self) -> HostStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostStats

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

Formats the value using the given formatter.

impl Default for HostStats

fn default() -> HostStats

Returns the “default value” for a type.

impl Serialize for HostStats

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.