Struct EventMetric

pub struct EventMetric { /* private fields */ }

An event metric.

Events allow recording of e.g. individual occurences of user actions, say every time a view was open and from where. Each time you record an event, it records a timestamp, the event’s name and a set of custom values.

Implementations

impl EventMetric

pub fn new(meta: CommonMetricData, allowed_extra_keys: Vec<String>) -> Self

Creates a new event metric.

pub fn record(&self, extra: HashMap<String, String>)

Records an event.

Arguments

• extra - A HashMap of (key, value) pairs. Keys must be one of the allowed extra keys. If any key is not allowed, an error is reported and no event is recorded.

pub fn record_with_time(&self, timestamp: u64, extra: HashMap<String, String>)

Record a new event with a provided timestamp.

It’s the caller’s responsibility to ensure the timestamp comes from the same clock source.

Arguments

• timestamp - The event timestamp, in milliseconds.
• extra - A HashMap of (key, value) pairs. Keys must be one of the allowed extra keys. If any key is not allowed, an error is reported and no event is recorded.

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

Test-only API (exported for FFI purposes).

Get the vector of currently stored events for this event metric.

This doesn’t clear the stored value.

Arguments

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

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

Returns

The number of errors reported.

Trait Implementations

impl Clone for EventMetric

fn clone(&self) -> EventMetric

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for EventMetric

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

Formats the value using the given formatter.

impl<UT> LiftRef<UT> for EventMetric

type LiftType = Arc<EventMetric>

impl<UT> LowerError<UT> for EventMetric

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for EventMetric

type ReturnType = <Arc<EventMetric> as LowerReturn<UniFfiTag>>::ReturnType

The type that should be returned by scaffolding functions for this type.

fn lower_return(obj: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl MetricType for EventMetric

fn meta(&self) -> &CommonMetricDataInternal

Access the stored metadata

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

where Self: Sized,

Create a new metric from this with a new name.

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

where 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

impl<UT> TypeId<UT> for EventMetric

const TYPE_ID_META: MetadataBuffer