use core::fmt;
use crate::counter::Counter;
use crate::value::Value;
#[cfg(feature = "consistent-histograms")]
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct HistogramSnapshot<'a> {
pub buckets: &'a [u64],
pub sum: Value,
pub count: u64,
}
#[cfg(feature = "consistent-histograms")]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct HistogramSnapshotError {
pub required: usize,
pub capacity: usize,
}
#[cfg(feature = "consistent-histograms")]
pub(crate) fn snapshot_bucket_prefix(
buckets: &mut [u64],
required: usize,
) -> Result<&mut [u64], HistogramSnapshotError> {
let capacity = buckets.len();
buckets
.get_mut(..required)
.ok_or(HistogramSnapshotError { required, capacity })
}
#[doc(hidden)]
pub trait ErasedCounterVec: Sync {
fn series_count(&self) -> usize;
fn write_labels(&self, s: usize, out: &mut dyn fmt::Write) -> fmt::Result;
fn value(&self, s: usize) -> u64;
}
#[doc(hidden)]
pub trait ErasedGaugeVec: Sync {
fn series_count(&self) -> usize;
fn write_labels(&self, s: usize, out: &mut dyn fmt::Write) -> fmt::Result;
fn value(&self, s: usize) -> Value;
}
#[doc(hidden)]
pub trait ErasedHistogram: Sync {
fn bucket_count(&self) -> usize;
fn bound(&self, b: usize) -> Value;
fn bucket(&self, b: usize) -> u64;
fn total_count(&self) -> u64;
fn sum(&self) -> Value;
#[cfg(feature = "consistent-histograms")]
fn snapshot<'a>(
&self,
buckets: &'a mut [u64],
) -> Result<HistogramSnapshot<'a>, HistogramSnapshotError>;
}
#[doc(hidden)]
pub trait ErasedHistogramVec: Sync {
fn bucket_count(&self) -> usize;
fn bound(&self, b: usize) -> Value;
fn series_count(&self) -> usize;
fn write_labels(&self, s: usize, out: &mut dyn fmt::Write) -> fmt::Result;
fn bucket(&self, s: usize, b: usize) -> u64;
fn total_count(&self, s: usize) -> u64;
fn sum(&self, s: usize) -> Value;
#[cfg(feature = "consistent-histograms")]
fn snapshot<'a>(
&self,
s: usize,
buckets: &'a mut [u64],
) -> Result<HistogramSnapshot<'a>, HistogramSnapshotError>;
}
#[doc(hidden)]
pub enum MetricRef<'a> {
Counter(&'a Counter),
Gauge(Value),
Histogram {
h: &'a dyn ErasedHistogram,
},
CounterVec(&'a dyn ErasedCounterVec),
GaugeVec(&'a dyn ErasedGaugeVec),
HistogramVec {
h: &'a dyn ErasedHistogramVec,
},
}
#[doc(hidden)]
pub struct MetricDesc<'a> {
pub namespace: &'static str,
pub name: &'static str,
pub help: &'static str,
pub metric: MetricRef<'a>,
}
#[doc(hidden)]
pub trait MetricGroup: core::any::Any + Sync {
fn group_name(&self) -> &'static str;
fn len(&self) -> usize;
fn get(&self, index: usize) -> Option<MetricDesc<'_>>;
fn is_empty(&self) -> bool {
self.len() == 0
}
}
#[cfg(test)]
mod tests {
use super::*;
mod fixture {
crate::metrics! {
namespace = "fixture";
requests: Counter,
temperature: Gauge,
}
}
#[test]
fn dynamic_dispatch_over_metric_group() {
let g = fixture::get();
g.temperature.set(21);
g.requests.inc_by(3);
let group: &dyn MetricGroup = g;
assert_eq!(group.len(), 2);
assert!(!group.is_empty());
let d0 = group.get(0).unwrap();
assert_eq!(d0.name, "requests");
match d0.metric {
MetricRef::Counter(c) => assert_eq!(c.get(), 3),
_ => panic!("expected Counter"),
}
let d1 = group.get(1).unwrap();
match d1.metric {
MetricRef::Gauge(Value::I64(v)) => assert_eq!(v, 21),
_ => panic!("expected Gauge(I64)"),
}
assert!(group.get(2).is_none());
}
}