Struct sentry_core::metrics::MetricBuilder

pub struct MetricBuilder { /* private fields */ }

A builder for metrics.

Use one of the Metric constructors to create a new builder. See the struct-level docs for examples of how to build metrics.

Implementations

impl MetricBuilder

pub fn with_unit(self, unit: impl Into<MetricUnit>) -> Self

Sets the unit for the metric.

The unit augments the metric value by giving it a magnitude and semantics. Some units have special support when rendering metrics or their values in Sentry, such as for timings. See MetricUnit for more information on the supported units. The unit can be set to MetricUnit::None to indicate that the metric has no unit, or to MetricUnit::Custom to indicate a user-defined unit.

By default, the unit is set to MetricUnit::None.

pub fn with_tag( self, name: impl Into<MetricStr>, value: impl Into<MetricStr>, ) -> Self

Adds a tag to the metric.

Tags allow you to add dimensions to metrics. They are key-value pairs that can be filtered or grouped by in Sentry.

When sent to Sentry via MetricBuilder::send or when added to a Client, the client may add default tags to the metrics, such as the release or the environment from the Scope.

pub fn with_tags<T, K, V>(self, tags: T) -> Self

where T: IntoIterator<Item = (K, V)>, K: Into<MetricStr>, V: Into<MetricStr>,

Adds multiple tags to the metric.

Tags allow you to add dimensions to metrics. They are key-value pairs that can be filtered or grouped by in Sentry.

When sent to Sentry via MetricBuilder::send or when added to a Client, the client may add default tags to the metrics, such as the release or the environment from the Scope.

pub fn with_time(self, time: SystemTime) -> Self

Sets the timestamp for the metric.

By default, the timestamp is set to the current time when the metric is built or sent.

pub fn finish(self) -> Metric

Builds the metric.

pub fn send(self)

Sends the metric to the current client.

This is a shorthand for .finish().send(). If there is no client on the current Hub, the metric is dropped.

Trait Implementations

impl Debug for MetricBuilder

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

Formats the value using the given formatter.