Struct glean_core::UrlMetric

pub struct UrlMetric { /* private fields */ }

A URL metric.

Record an Unicode string value a URL content. The URL is length-limited to MAX_URL_LENGTH bytes.

Implementations

impl UrlMetric

pub fn new(meta: CommonMetricData) -> Self

Creates a new string metric.

pub fn set<S: Into<String>>(&self, value: S)

Sets to the specified stringified URL.

Arguments

• value - The stringified URL to set the metric to.

Notes

Truncates the value if it is longer than MAX_URL_LENGTH bytes and logs an error.

pub fn test_get_value(&self, ping_name: Option<String>) -> Option<String>

Test-only API (exported for FFI purposes).

Gets the currently stored value as a string.

This doesn’t clear the stored value.

pub fn test_get_num_recorded_errors(&self, error: ErrorType) -> i32

Exported for test purposes.

Gets the number of recorded errors for the given metric and error type.

Arguments

• error - The type of error
• ping_name - represents the optional name of the ping to retrieve the metric for. Defaults to the first value in send_in_pings.

Returns

The number of errors reported.

Trait Implementations

impl Clone for UrlMetric

fn clone(&self) -> UrlMetric

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UrlMetric

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

Formats the value using the given formatter.

impl MetricType for UrlMetric

fn meta(&self) -> &CommonMetricData

Access the stored metadata

fn with_name(&self, _name: String) -> Selfwhere
    Self: Sized,

Create a new metric from this with a new name.

fn with_dynamic_label(&self, _label: String) -> Selfwhere
    Self: Sized,

Create a new metric from this with a specific label.

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

Whether this metric should currently be recorded