Pass exemplar timestamp explicitly

This is a bit more expensive when you don't pass it:

```
histogram without exemplars
                        time:   [3.1824 ns 3.2017 ns 3.2235 ns]
                        change: [-3.6414% +0.1893% +3.1022%] (p = 0.92 > 0.05)
                        No change in performance detected.

histogram with exemplars (no exemplar passed)
                        time:   [6.2238 ns 6.2487 ns 6.2770 ns]
                        change: [+7.5129% +8.3245% +9.0265%] (p = 0.00 < 0.05)
                        Performance has regressed.

histogram with exemplars (some exemplar passed)
                        time:   [70.907 ns 71.667 ns 72.493 ns]
                        change: [+1.4206% +2.3509% +3.3463%] (p = 0.00 < 0.05)
                        Performance has regressed.
```

It should amortize as one passes the same timestamp in multiple observations.

Signed-off-by: Ivan Babrou <[email protected]>

Author: bobrik

benches/exemplars.rs

@@ -19,7 +19,7 @@ pub fn exemplars(c: &mut Criterion) {
         let histogram = HistogramWithExemplars::<Exemplar>::new(BUCKETS.iter().copied());
 
         b.iter(|| {
-            histogram.observe(1.0, None);
+            histogram.observe(1.0, None, None);
         });
     });
 
@@ -28,7 +28,7 @@ pub fn exemplars(c: &mut Criterion) {
         let exemplar = vec![("TraceID".to_owned(), "deadfeed".to_owned())];
 
         b.iter(|| {
-            histogram.observe(1.0, Some(exemplar.clone()));
+            histogram.observe(1.0, Some(exemplar.clone()), None);
         });
     });
 }

src/encoding/protobuf.rs

@@ -806,7 +806,7 @@ mod tests {
         let mut registry = Registry::default();
         let histogram = HistogramWithExemplars::new(exponential_buckets(1.0, 2.0, 10));
         registry.register("my_histogram", "My histogram", histogram.clone());
-        histogram.observe(1.0, Some(vec![("user_id".to_string(), 42u64)]));
+        histogram.observe(1.0, Some(vec![("user_id".to_string(), 42u64)]), None);
 
         histogram
             .inner

src/encoding/text.rs

@@ -978,7 +978,7 @@ mod tests {
         let mut registry = Registry::default();
         let histogram = HistogramWithExemplars::new(exponential_buckets(1.0, 2.0, 10));
         registry.register("my_histogram", "My histogram", histogram.clone());
-        histogram.observe(1.0, Some([("user_id".to_string(), 42u64)]));
+        histogram.observe(1.0, Some([("user_id".to_string(), 42u64)]), None);
 
         histogram
             .inner

src/metrics/exemplar.rs

@@ -178,7 +178,7 @@ where
 /// # use prometheus_client::metrics::exemplar::HistogramWithExemplars;
 /// # use prometheus_client::metrics::histogram::exponential_buckets;
 /// let histogram = HistogramWithExemplars::new(exponential_buckets(1.0, 2.0, 10));
-/// histogram.observe(4.2, Some(vec![("user_id".to_string(), "42".to_string())]));
+/// histogram.observe(4.2, Some(vec![("user_id".to_string(), "42".to_string())]), None);
 /// ```
 /// You can also use exemplars with families. Just wrap the exemplar in a Family.
 /// ```
@@ -210,6 +210,7 @@ where
 ///         Some(TraceLabel {
 ///             trace_id: "3a2f90c9f80b894f".to_owned(),
 ///         }),
+///         None,
 ///     );
 /// ```
 #[derive(Debug)]
@@ -250,7 +251,7 @@ impl<S> HistogramWithExemplars<S> {
 
     /// Observe the given value, optionally providing a label set and thus
     /// setting the [`Exemplar`] value.
-    pub fn observe(&self, v: f64, label_set: Option<S>) {
+    pub fn observe(&self, v: f64, label_set: Option<S>, timestamp: Option<SystemTime>) {
         let mut inner = self.inner.write();
         let bucket = inner.histogram.observe_and_bucket(v);
         if let (Some(bucket), Some(label_set)) = (bucket, label_set) {
@@ -259,7 +260,7 @@ impl<S> HistogramWithExemplars<S> {
                 Exemplar {
                     label_set,
                     value: v,
-                    time: SystemTime::now(),
+                    time: timestamp.unwrap_or_else(SystemTime::now),
                 },
             );
         }