Struct glean_core::metrics::RateMetric

pub struct RateMetric { /* fields omitted */ }

A rate metric.

Used to determine the proportion of things via two counts:

• A numerator defining the amount of times something happened,
• A denominator counting the amount of times someting could have happened.

Both numerator and denominator can only be incremented, not decremented.

Implementations

impl RateMetric

pub fn new(meta: CommonMetricData) -> Self

Creates a new rate metric.

pub fn add_to_numerator(&self, glean: &Glean, amount: i32)

Increases the numerator by amount.

Arguments

• glean - The Glean instance this metric belongs to.
• amount - The amount to increase by. Should be non-negative.

Notes

Logs an error if the amount is negative.

pub fn add_to_denominator(&self, glean: &Glean, amount: i32)

Increases the denominator by amount.

Arguments

• glean - The Glean instance this metric belongs to.
• amount - The amount to increase by. Should be non-negative.

Notes

Logs an error if the amount is negative.

pub fn test_get_value(
    &self,
    glean: &Glean,
    storage_name: &str
) -> Option<(i32, i32)>

Test-only API (exported for FFI purposes).

Gets the currently stored value as a pair of integers.

This doesn’t clear the stored value.

Trait Implementations

impl Clone for RateMetric

fn clone(&self) -> RateMetric

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RateMetric

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

Formats the value using the given formatter.

impl MetricType for RateMetric

fn meta(&self) -> &CommonMetricData

Access the stored metadata

fn meta_mut(&mut self) -> &mut CommonMetricData

Access the stored metadata mutable

fn should_record(&self, glean: &Glean) -> bool

Whether this metric should currently be recorded