[−][src]Enum opentelemetry_otlp::proto::metrics::v1::AggregationTemporality
AggregationTemporality defines how a metric aggregator reports aggregated values. It describes how those values relate to the time interval over which they are aggregated.
Variants
UNSPECIFIED is the default AggregationTemporality, it MUST not be used.
DELTA is an AggregationTemporality for a metric aggregator which reports changes since last report time. Successive metrics contain aggregation of values from continuous and non-overlapping intervals.
The values for a DELTA metric are based only on the time interval associated with one measurement cycle. There is no dependency on previous measurements like is the case for CUMULATIVE metrics.
For example, consider a system measuring the number of requests that it receives and reports the sum of these requests every second as a DELTA metric:
- The system starts receiving at time=t_0.
- A request is received, the system measures 1 request.
- A request is received, the system measures 1 request.
- A request is received, the system measures 1 request.
- The 1 second collection cycle ends. A metric is exported for the number of requests received over the interval of time t_0 to t_0+1 with a value of 3.
- A request is received, the system measures 1 request.
- A request is received, the system measures 1 request.
- The 1 second collection cycle ends. A metric is exported for the number of requests received over the interval of time t_0+1 to t_0+2 with a value of 2.
CUMULATIVE is an AggregationTemporality for a metric aggregator which reports changes since a fixed start time. This means that current values of a CUMULATIVE metric depend on all previous measurements since the start time. Because of this, the sender is required to retain this state in some form. If this state is lost or invalidated, the CUMULATIVE metric values MUST be reset and a new fixed start time following the last reported measurement time sent MUST be used.
For example, consider a system measuring the number of requests that it receives and reports the sum of these requests every second as a CUMULATIVE metric:
- The system starts receiving at time=t_0.
- A request is received, the system measures 1 request.
- A request is received, the system measures 1 request.
- A request is received, the system measures 1 request.
- The 1 second collection cycle ends. A metric is exported for the number of requests received over the interval of time t_0 to t_0+1 with a value of 3.
- A request is received, the system measures 1 request.
- A request is received, the system measures 1 request.
- The 1 second collection cycle ends. A metric is exported for the number of requests received over the interval of time t_0 to t_0+2 with a value of 5.
- The system experiences a fault and loses state.
- The system recovers and resumes receiving at time=t_1.
- A request is received, the system measures 1 request.
- The 1 second collection cycle ends. A metric is exported for the number of requests received over the interval of time t_1 to t_0+1 with a value of 1.
Note: Even though, when reporting changes since last report time, using CUMULATIVE is valid, it is not recommended. This may cause problems for systems that do not use start_time to determine when the aggregation value was reset (e.g. Prometheus).
Implementations
impl AggregationTemporality
[src]
pub fn is_valid(value: i32) -> bool
[src]
Returns true
if value
is a variant of AggregationTemporality
.
pub fn from_i32(value: i32) -> Option<AggregationTemporality>
[src]
Converts an i32
to a AggregationTemporality
, or None
if value
is not a valid variant.
Trait Implementations
impl Clone for AggregationTemporality
[src]
pub fn clone(&self) -> AggregationTemporality
[src]
pub fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl Copy for AggregationTemporality
[src]
impl Debug for AggregationTemporality
[src]
impl Default for AggregationTemporality
[src]
pub fn default() -> AggregationTemporality
[src]
impl Eq for AggregationTemporality
[src]
impl From<ExportKind> for AggregationTemporality
[src]
pub fn from(kind: ExportKind) -> Self
[src]
impl Hash for AggregationTemporality
[src]
pub fn hash<__H: Hasher>(&self, state: &mut __H)
[src]
pub fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
impl Ord for AggregationTemporality
[src]
pub fn cmp(&self, other: &AggregationTemporality) -> Ordering
[src]
#[must_use]pub fn max(self, other: Self) -> Self
1.21.0[src]
#[must_use]pub fn min(self, other: Self) -> Self
1.21.0[src]
#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self
1.50.0[src]
impl PartialEq<AggregationTemporality> for AggregationTemporality
[src]
pub fn eq(&self, other: &AggregationTemporality) -> bool
[src]
#[must_use]pub fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
impl PartialOrd<AggregationTemporality> for AggregationTemporality
[src]
pub fn partial_cmp(&self, other: &AggregationTemporality) -> Option<Ordering>
[src]
#[must_use]pub fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]pub fn le(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]pub fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]pub fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
impl StructuralEq for AggregationTemporality
[src]
impl StructuralPartialEq for AggregationTemporality
[src]
Auto Trait Implementations
impl RefUnwindSafe for AggregationTemporality
[src]
impl Send for AggregationTemporality
[src]
impl Sync for AggregationTemporality
[src]
impl Unpin for AggregationTemporality
[src]
impl UnwindSafe for AggregationTemporality
[src]
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<Q, K> Equivalent<K> for Q where
K: Borrow<Q> + ?Sized,
Q: Eq + ?Sized,
[src]
K: Borrow<Q> + ?Sized,
Q: Eq + ?Sized,
pub fn equivalent(&self, key: &K) -> bool
[src]
impl<T> From<T> for T
[src]
impl<T> FutureExt for T
[src]
pub fn with_context(self, otel_cx: Context) -> WithContext<Self>
[src]
pub fn with_current_context(self) -> WithContext<Self>
[src]
impl<T> Instrument for T
[src]
pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T> Instrument for T
[src]
pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> IntoRequest<T> for T
[src]
pub fn into_request(self) -> Request<T>
[src]
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
V: MultiLane<T>,
pub fn vzip(self) -> V
impl<T> WithSubscriber for T
[src]
pub fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
[src]
S: Into<Dispatch>,