Enum opentelemetry::sdk::metrics::Aggregation

#[non_exhaustive]
pub enum Aggregation {
    Drop,
    Default,
    Sum,
    LastValue,
    ExplicitBucketHistogram {
        boundaries: Vec<f64>,
        record_min_max: bool,
    },
}

The way recorded measurements are summarized.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Drop

An aggregation that drops all recorded data.

Default

An aggregation that uses the default instrument kind selection mapping to select another aggregation.

A metric reader can be configured to make an aggregation selection based on instrument kind that differs from the default. This aggregation ensures the default is used.

See the DefaultAggregationSelector for information about the default instrument kind selection mapping.

Sum

An aggregation that summarizes a set of measurements as their arithmetic sum.

LastValue

An aggregation that summarizes a set of measurements as the last one made.

ExplicitBucketHistogram

Fields

boundaries: Vec<f64>

The increasing bucket boundary values.

Boundary values define bucket upper bounds. Buckets are exclusive of their lower boundary and inclusive of their upper bound (except at positive infinity). A measurement is defined to fall into the greatest-numbered bucket with a boundary that is greater than or equal to the measurement. As an example, boundaries defined as:

vec![0.0, 5.0, 10.0, 25.0, 50.0, 75.0, 100.0, 250.0, 500.0, 1000.0];

Will define these buckets:

(-∞, 0], (0, 5.0], (5.0, 10.0], (10.0, 25.0], (25.0, 50.0], (50.0, 75.0], (75.0, 100.0], (100.0, 250.0], (250.0, 500.0], (500.0, 1000.0], (1000.0, +∞)

record_min_max: bool

Indicates whether to not record the min and max of the distribution.

By default, these values are recorded.

Recording these values for cumulative data is expected to have little value, they will represent the entire life of the instrument instead of just the current collection cycle. It is recommended to set this to false for that type of data to avoid computing the low-value instances.

An aggregation that summarizes a set of measurements as an histogram with explicitly defined buckets.

Implementations

impl Aggregation

pub fn validate(&self) -> Result<(), MetricsError>

Validate that this aggregation has correct configuration

Trait Implementations

impl Clone for Aggregation

fn clone(&self) -> Aggregation

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Aggregation

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

Formats the value using the given formatter.

impl Display for Aggregation

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

Formats the value using the given formatter.

impl PartialEq for Aggregation

fn eq(&self, other: &Aggregation) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Aggregation