Struct glean_core::metrics::CustomDistributionMetric

pub struct CustomDistributionMetric { /* private fields */ }

A custom distribution metric.

Memory distributions are used to accumulate and store memory sizes.

Implementations

impl CustomDistributionMetric

pub fn new(
    meta: CommonMetricData,
    range_min: u64,
    range_max: u64,
    bucket_count: u64,
    histogram_type: HistogramType
) -> Self

Creates a new memory distribution metric.

pub fn accumulate_samples_signed(&self, glean: &Glean, samples: Vec<i64>)

Accumulates the provided signed samples in the metric.

This is required so that the platform-specific code can provide us with 64 bit signed integers if no u64 comparable type is available. This will take care of filtering and reporting errors for any provided negative sample.

Arguments

• samples - The vector holding the samples to be recorded by the metric.

Notes

Discards any negative value in samples and report an ErrorType::InvalidValue for each of them.

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

Test-only API (exported for FFI purposes).

Gets the currently stored histogram.

This doesn’t clear the stored value.

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

Test-only API (exported for FFI purposes).

Gets the currently stored histogram as a JSON String of the serialized value.

This doesn’t clear the stored value.

Trait Implementations

impl Debug for CustomDistributionMetric

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

Formats the value using the given formatter.

impl MetricType for CustomDistributionMetric

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