otlp: Add DeltaTemporalitySelector

Author: svix-jplatte

opentelemetry-otlp/src/lib.rs

@@ -226,7 +226,7 @@ pub use crate::span::{
 
 #[cfg(feature = "metrics")]
 pub use crate::metric::{
-    MetricsExporter, MetricsExporterBuilder, OtlpMetricPipeline,
+    DeltaTemporalitySelector, MetricsExporter, MetricsExporterBuilder, OtlpMetricPipeline,
     OTEL_EXPORTER_OTLP_METRICS_COMPRESSION, OTEL_EXPORTER_OTLP_METRICS_ENDPOINT,
     OTEL_EXPORTER_OTLP_METRICS_HEADERS, OTEL_EXPORTER_OTLP_METRICS_TIMEOUT,
 };

opentelemetry-otlp/src/metric.rs

@@ -169,6 +169,16 @@ where
         }
     }
 
+    /// Build with [`DeltaTemporalitySelector`] as the temporality selector.
+    ///
+    /// This temporality selector is equivalent to OTLP Metrics Exporter's
+    /// `Delta` temporality preference (see [its documentation][exporter-docs]).
+    ///
+    /// [exporter-docs]: https://github.com/open-telemetry/opentelemetry-specification/blob/a1c13d59bb7d0fb086df2b3e1eaec9df9efef6cc/specification/metrics/sdk_exporters/otlp.md#additional-configuration
+    pub fn with_delta_temporality(self) -> Self {
+        self.with_temporality_selector(DeltaTemporalitySelector)
+    }
+
     /// Build with the given aggregation selector
     pub fn with_aggregation_selector<T: AggregationSelector + 'static>(self, selector: T) -> Self {
         OtlpMetricPipeline {
@@ -248,6 +258,36 @@ impl<RT, EB: Debug> Debug for OtlpMetricPipeline<RT, EB> {
     }
 }
 
+/// A temporality selector that returns [`Delta`][Temporality::Delta] for all
+/// instruments except `UpDownCounter` and `ObservableUpDownCounter`.
+///
+/// This temporality selector is equivalent to OTLP Metrics Exporter's
+/// `Delta` temporality preference (see [its documentation][exporter-docs]).
+///
+/// [exporter-docs]: https://github.com/open-telemetry/opentelemetry-specification/blob/a1c13d59bb7d0fb086df2b3e1eaec9df9efef6cc/specification/metrics/sdk_exporters/otlp.md#additional-configuration
+#[non_exhaustive]
+#[derive(Debug)]
+pub struct DeltaTemporalitySelector;
+
+impl TemporalitySelector for DeltaTemporalitySelector {
+    #[rustfmt::skip]
+    fn temporality(&self, kind: InstrumentKind) -> Temporality {
+        match kind {
+            InstrumentKind::Counter
+            | InstrumentKind::Histogram
+            | InstrumentKind::ObservableCounter
+            | InstrumentKind::Gauge
+            | InstrumentKind::ObservableGauge => {
+                Temporality::Delta
+            }
+            InstrumentKind::UpDownCounter
+            | InstrumentKind::ObservableUpDownCounter => {
+                Temporality::Cumulative
+            }
+        }
+    }
+}
+
 /// An interface for OTLP metrics clients
 #[async_trait]
 pub trait MetricsClient: fmt::Debug + Send + Sync + 'static {