Struct UsageStats 

pub struct UsageStats {
    pub daily_active_installs_7d: Option<u64>,
    pub hits_24h: u64,
    pub misses_24h: u64,
    pub hit_rate_24h: f64,
    pub cpu_hours_saved_30d: f64,
    pub top_crates_30d: Vec<UsageStatEntry>,
    pub targets_30d: Vec<UsageStatEntry>,
    pub cli_versions_30d: Vec<UsageStatEntry>,
}

Public aggregate usage statistics served by GET /api/v1/stats.

Every count is derived from anonymized Analytics Engine events: hit events are sampled at one in ten and their published counts are scaled by the stored sample weight, so the numbers are approximate by design. Fields that could publish a dangerously small count are suppressed (None) rather than reported.

Fields

daily_active_installs_7d: Option<u64>

Average number of distinct installs served a cache hit per day over the last 7 days, counted by daily-salted unlinkable install hash (a hash cannot be joined across days, so the figure is per-day, and hits are sampled, so it is a lower bound). None below the minimum publication threshold — stow never reports small counts.

hits_24h: u64

Cache hits served in the last 24 hours (sample-scaled estimate).

misses_24h: u64

Cache misses served in the last 24 hours.

hit_rate_24h: f64

hits_24h / (hits_24h + misses_24h); 0.0 when nothing was served.

cpu_hours_saved_30d: f64

CPU-hours of rustc compilation saved in the last 30 days: the recorded compile time of every artifact served, sample-scaled.

top_crates_30d: Vec<UsageStatEntry>

Most-served crates over the last 30 days.

targets_30d: Vec<UsageStatEntry>

Hits per compilation target over the last 30 days.

cli_versions_30d: Vec<UsageStatEntry>

Hits per CLI version over the last 30 days; requests that sent no stow-cli user agent are not counted under any version.

Trait Implementations

impl Clone for UsageStats

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for UsageStats

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Debug for UsageStats

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UsageStats

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for UsageStats

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for UsageStats

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UsageStats

impl ToSchema for UsageStats

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference utoipa::openapi::schema::Schemas for this type.