Struct ProviderHealthMonitor 

pub struct ProviderHealthMonitor { /* private fields */ }

A thread-safe, cloneable monitor that tracks per-provider health.

All public methods are async and acquire an internal RwLock for the minimum duration necessary.

Clone semantics

Cloning shares the same underlying Arc-wrapped state, so all clones observe the same data.

Implementations

impl ProviderHealthMonitor

pub fn new(window_size: usize) -> Self

Create a new monitor with the given rolling-window size.

window_size is the maximum number of samples (requests) retained per provider when computing percentiles and error rate. Older samples are evicted when the window is full (FIFO). A minimum of 1 is enforced.

Panics

Never panics.

pub async fn record(&self, provider_id: &str, latency_ms: u64, success: bool)

Record the outcome of a single completed request for provider_id.

• latency_ms — round-trip time in milliseconds. Ignored (not added to the latency window) when success is false.
• success — true for a 2xx response, false for any error.

Panics

Never panics.

pub async fn get_health(&self, provider_id: &str) -> Option<ProviderHealth>

Return a ProviderHealth snapshot for provider_id, or None if no data has been recorded for that provider yet.

Panics

Never panics.

pub async fn ranked_providers(&self) -> Vec<ProviderHealth>

Return all known providers sorted by health score, best first.

Panics

Never panics.

pub async fn best_provider<'a>( &self, candidates: &'a [String], ) -> Option<&'a String>

Return the healthiest provider from the given candidates list.

Returns None if candidates is empty or none of the candidates have recorded data.

Panics

Never panics.

pub async fn is_usable(&self, provider_id: &str) -> bool

Returns true if provider_id has a health score above the “healthy” threshold (> 0.5) and is not in a hard-failure state.

Providers with no recorded data are considered usable (optimistic default) so new providers are tried immediately.

Panics

Never panics.

Trait Implementations

impl Clone for ProviderHealthMonitor

fn clone(&self) -> ProviderHealthMonitor

Returns a duplicate of the value.

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

Performs copy-assignment from source.