Struct KeyStats 

pub struct KeyStats {
    pub env_var: String,
    pub total_requests: u64,
    pub successes: u64,
    pub failures: u64,
    pub rate_limits: u64,
    pub total_latency_ms: u64,
    pub total_input_tokens: u64,
    pub total_output_tokens: u64,
    pub active_requests: u64,
    pub last_rate_limit_at: u64,
    pub last_success_at: u64,
}

Per-key performance statistics.

Fields

env_var: String

Which env var this key came from.

total_requests: u64

Total requests made with this key.

successes: u64

Total successful requests.

failures: u64

Total failed requests (non-429).

rate_limits: u64

Total 429 (rate-limit) responses.

total_latency_ms: u64

Cumulative latency in ms (for computing average).

total_input_tokens: u64

Total input tokens processed.

total_output_tokens: u64

Total output tokens produced.

active_requests: u64

Currently in-flight requests (not serialized).

last_rate_limit_at: u64

Unix timestamp of last rate-limit (0 = never).

last_success_at: u64

Unix timestamp of last successful request.

Implementations

impl KeyStats

pub fn avg_latency_ms(&self) -> f64

Average latency in ms. Returns 0 if no requests completed.

pub fn success_rate(&self) -> f64

Success rate (0.0 to 1.0). Returns 0.5 prior if no data.

pub fn is_rate_limited(&self) -> bool

Whether this key is in cooldown from a recent rate-limit.

pub fn estimated_cost(&self, input_per_mtok: f64, output_per_mtok: f64) -> f64

Estimated cost in USD based on token counts and per-million-token rates.

Trait Implementations

impl Clone for KeyStats

fn clone(&self) -> KeyStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KeyStats

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KeyStats

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for KeyStats

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.