Eine aufbereitete Darstellung der Quelle

 
     
 
 
Anforderungen  |   Konzepte  |   Entwurf  |   Entwicklung  |   Qualitätssicherung  |   Lebenszyklus  |   Steuerung
 
 
 
 

Benutzer

Quelle  histogram.rs

  Sprache: Rust
 

use crate::util::metric_atomics::MetricAtomicU64;
use std::sync::atomic::Ordering::Relaxed;

use std::cmp;
use std::ops::Range;

#[derive(Debug)]
pub(cratestruct Histogram {
    /// The histogram buckets
    buckets: Box<[MetricAtomicU64]>,

    /// Bucket scale, linear or log
    scale: HistogramScale,

    /// Minimum resolution
    resolution: u64,
}

#[derive(Debug, Clone)]
pub(cratestruct HistogramBuilder {
    /// Histogram scale
    pub(crate) scale: HistogramScale,

    /// Must be a power of 2
    pub(crate) resolution: u64,

    /// Number of buckets
    pub(crate) num_buckets: usize,
}

#[derive(Debug)]
pub(cratestruct HistogramBatch {
    buckets: Box<[u64]>,
    scale: HistogramScale,
    resolution: u64,
}

cfg_unstable! {
    /// Whether the histogram used to aggregate a metric uses a linear or
    /// logarithmic scale.
    #[derive(Debug, Copy, Clone, Eq, PartialEq)]
    #[non_exhaustive]
    pub enum HistogramScale {
        /// Linear bucket scale
        Linear,

        /// Logarithmic bucket scale
        Log,
    }
}

impl Histogram {
    pub(cratefn num_buckets(&self) -> usize {
        self.buckets.len()
    }

    cfg_64bit_metrics! {
        pub(cratefn get(&self, bucket: usize) -> u64 {
            self.buckets[bucket].load(Relaxed)
        }
    }

    pub(cratefn bucket_range(&self, bucket: usize) -> Range<u64> {
        match self.scale {
            HistogramScale::Log => Range {
                start: if bucket == 0 {
                    0
                } else {
                    self.resolution << (bucket - 1)
                },
                end: if bucket == self.buckets.len() - 1 {
                    u64::MAX
                } else {
                    self.resolution << bucket
                },
            },
            HistogramScale::Linear => Range {
                start: self.resolution * bucket as u64,
                end: if bucket == self.buckets.len() - 1 {
                    u64::MAX
                } else {
                    self.resolution * (bucket as u64 + 1)
                },
            },
        }
    }
}

impl HistogramBatch {
    pub(cratefn from_histogram(histogram: &Histogram) -> HistogramBatch {
        let buckets = vec![0; histogram.buckets.len()].into_boxed_slice();

        HistogramBatch {
            buckets,
            scale: histogram.scale,
            resolution: histogram.resolution,
        }
    }

    pub(cratefn measure(&mut self, value: u64, count: u64) {
        self.buckets[self.value_to_bucket(value)] += count;
    }

    pub(cratefn submit(&self, histogram: &Histogram) {
        debug_assert_eq!(self.scale, histogram.scale);
        debug_assert_eq!(self.resolution, histogram.resolution);
        debug_assert_eq!(self.buckets.len(), histogram.buckets.len());

        for i in 0..self.buckets.len() {
            histogram.buckets[i].store(self.buckets[i], Relaxed);
        }
    }

    fn value_to_bucket(&self, value: u64) -> usize {
        match self.scale {
            HistogramScale::Linear => {
                let max = self.buckets.len() - 1;
                cmp::min(value / self.resolution, max as u64) as usize
            }
            HistogramScale::Log => {
                let max = self.buckets.len() - 1;

                if value < self.resolution {
                    0
                } else {
                    let significant_digits = 64 - value.leading_zeros();
                    let bucket_digits = 64 - (self.resolution - 1).leading_zeros();
                    cmp::min(significant_digits as usize - bucket_digits as usize, max)
                }
            }
        }
    }
}

impl HistogramBuilder {
    pub(cratefn new() -> HistogramBuilder {
        HistogramBuilder {
            scale: HistogramScale::Linear,
            // Resolution is in nanoseconds.
            resolution: 100_000,
            num_buckets: 10,
        }
    }

    pub(cratefn build(&self) -> Histogram {
        let mut resolution = self.resolution;

        assert!(resolution > 0);

        if matches!(self.scale, HistogramScale::Log) {
            resolution = resolution.next_power_of_two();
        }

        Histogram {
            buckets: (0..self.num_buckets)
                .map(|_| MetricAtomicU64::new(0))
                .collect::<Vec<_>>()
                .into_boxed_slice(),
            resolution,
            scale: self.scale,
        }
    }
}

impl Default for HistogramBuilder {
    fn default() -> HistogramBuilder {
        HistogramBuilder::new()
    }
}

#[cfg(all(test, target_has_atomic = "64"))]
mod test {
    use super::*;

    macro_rules! assert_bucket_eq {
        ($h:expr, $bucket:expr, $val:expr) => {{
            assert_eq!($h.buckets[$bucket], $val);
        }};
    }

    #[test]
    fn log_scale_resolution_1() {
        let h = HistogramBuilder {
            scale: HistogramScale::Log,
            resolution: 1,
            num_buckets: 10,
        }
        .build();

        assert_eq!(h.bucket_range(0), 0..1);
        assert_eq!(h.bucket_range(1), 1..2);
        assert_eq!(h.bucket_range(2), 2..4);
        assert_eq!(h.bucket_range(3), 4..8);
        assert_eq!(h.bucket_range(9), 256..u64::MAX);

        let mut b = HistogramBatch::from_histogram(&h);

        b.measure(01);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 10);

        b.measure(11);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 11);
        assert_bucket_eq!(b, 20);

        b.measure(21);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 11);
        assert_bucket_eq!(b, 21);

        b.measure(31);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 11);
        assert_bucket_eq!(b, 22);

        b.measure(41);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 11);
        assert_bucket_eq!(b, 22);
        assert_bucket_eq!(b, 31);

        b.measure(1001);
        assert_bucket_eq!(b, 71);

        b.measure(1281);
        assert_bucket_eq!(b, 81);

        b.measure(40961);
        assert_bucket_eq!(b, 91);
    }

    #[test]
    fn log_scale_resolution_2() {
        let h = HistogramBuilder {
            scale: HistogramScale::Log,
            resolution: 2,
            num_buckets: 10,
        }
        .build();

        assert_eq!(h.bucket_range(0), 0..2);
        assert_eq!(h.bucket_range(1), 2..4);
        assert_eq!(h.bucket_range(2), 4..8);
        assert_eq!(h.bucket_range(3), 8..16);
        assert_eq!(h.bucket_range(9), 512..u64::MAX);

        let mut b = HistogramBatch::from_histogram(&h);

        b.measure(01);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 10);

        b.measure(11);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 10);

        b.measure(21);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 11);
        assert_bucket_eq!(b, 20);

        b.measure(31);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 20);

        b.measure(41);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 21);

        b.measure(51);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 22);

        b.measure(61);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 23);

        b.measure(71);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 24);

        b.measure(81);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 24);
        assert_bucket_eq!(b, 31);

        b.measure(1001);
        assert_bucket_eq!(b, 61);

        b.measure(1281);
        assert_bucket_eq!(b, 71);

        b.measure(40961);
        assert_bucket_eq!(b, 91);

        for bucket in h.buckets.iter() {
            assert_eq!(bucket.load(Relaxed), 0);
        }

        b.submit(&h);

        for i in 0..h.buckets.len() {
            assert_eq!(h.buckets[i].load(Relaxed), b.buckets[i]);
        }

        b.submit(&h);

        for i in 0..h.buckets.len() {
            assert_eq!(h.buckets[i].load(Relaxed), b.buckets[i]);
        }
    }

    #[test]
    fn linear_scale_resolution_1() {
        let h = HistogramBuilder {
            scale: HistogramScale::Linear,
            resolution: 1,
            num_buckets: 10,
        }
        .build();

        assert_eq!(h.bucket_range(0), 0..1);
        assert_eq!(h.bucket_range(1), 1..2);
        assert_eq!(h.bucket_range(2), 2..3);
        assert_eq!(h.bucket_range(3), 3..4);
        assert_eq!(h.bucket_range(9), 9..u64::MAX);

        let mut b = HistogramBatch::from_histogram(&h);

        b.measure(01);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 10);

        b.measure(11);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 11);
        assert_bucket_eq!(b, 20);

        b.measure(21);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 11);
        assert_bucket_eq!(b, 21);
        assert_bucket_eq!(b, 30);

        b.measure(31);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 11);
        assert_bucket_eq!(b, 21);
        assert_bucket_eq!(b, 31);

        b.measure(51);
        assert_bucket_eq!(b, 51);

        b.measure(40961);
        assert_bucket_eq!(b, 91);

        for bucket in h.buckets.iter() {
            assert_eq!(bucket.load(Relaxed), 0);
        }

        b.submit(&h);

        for i in 0..h.buckets.len() {
            assert_eq!(h.buckets[i].load(Relaxed), b.buckets[i]);
        }

        b.submit(&h);

        for i in 0..h.buckets.len() {
            assert_eq!(h.buckets[i].load(Relaxed), b.buckets[i]);
        }
    }

    #[test]
    fn linear_scale_resolution_100() {
        let h = HistogramBuilder {
            scale: HistogramScale::Linear,
            resolution: 100,
            num_buckets: 10,
        }
        .build();

        assert_eq!(h.bucket_range(0), 0..100);
        assert_eq!(h.bucket_range(1), 100..200);
        assert_eq!(h.bucket_range(2), 200..300);
        assert_eq!(h.bucket_range(3), 300..400);
        assert_eq!(h.bucket_range(9), 900..u64::MAX);

        let mut b = HistogramBatch::from_histogram(&h);

        b.measure(01);
        assert_bucket_eq!(b, 01);
        assert_bucket_eq!(b, 10);

        b.measure(501);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 10);

        b.measure(1001);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 11);
        assert_bucket_eq!(b, 20);

        b.measure(1011);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 20);

        b.measure(2001);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 21);

        b.measure(2991);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 22);

        b.measure(2221);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 23);

        b.measure(3001);
        assert_bucket_eq!(b, 02);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 23);
        assert_bucket_eq!(b, 31);

        b.measure(8881);
        assert_bucket_eq!(b, 81);

        b.measure(40961);
        assert_bucket_eq!(b, 91);

        for bucket in h.buckets.iter() {
            assert_eq!(bucket.load(Relaxed), 0);
        }

        b.submit(&h);

        for i in 0..h.buckets.len() {
            assert_eq!(h.buckets[i].load(Relaxed), b.buckets[i]);
        }

        b.submit(&h);

        for i in 0..h.buckets.len() {
            assert_eq!(h.buckets[i].load(Relaxed), b.buckets[i]);
        }
    }

    #[test]
    fn inc_by_more_than_one() {
        let h = HistogramBuilder {
            scale: HistogramScale::Linear,
            resolution: 100,
            num_buckets: 10,
        }
        .build();

        let mut b = HistogramBatch::from_histogram(&h);

        b.measure(03);
        assert_bucket_eq!(b, 03);
        assert_bucket_eq!(b, 10);

        b.measure(505);
        assert_bucket_eq!(b, 08);
        assert_bucket_eq!(b, 10);

        b.measure(1002);
        assert_bucket_eq!(b, 08);
        assert_bucket_eq!(b, 12);
        assert_bucket_eq!(b, 20);

        b.measure(10119);
        assert_bucket_eq!(b, 08);
        assert_bucket_eq!(b, 121);
        assert_bucket_eq!(b, 20);

        for bucket in h.buckets.iter() {
            assert_eq!(bucket.load(Relaxed), 0);
        }

        b.submit(&h);

        for i in 0..h.buckets.len() {
            assert_eq!(h.buckets[i].load(Relaxed), b.buckets[i]);
        }

        b.submit(&h);

        for i in 0..h.buckets.len() {
            assert_eq!(h.buckets[i].load(Relaxed), b.buckets[i]);
        }
    }
}

Messung V0.5 in Prozent
C=95 H=99 G=96

¤ Dauer der Verarbeitung: 0.10 Sekunden  (vorverarbeitet am  2026-06-27) ¤

*© Formatika GbR, Deutschland






Wurzel

Suchen

PVS Prover

Isabelle Prover

NIST Cobol Testsuite

Cephes Mathematical Library

Vienna Development Method

Haftungshinweis

Die Informationen auf dieser Webseite wurden nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit, noch Qualität der bereit gestellten Informationen zugesichert.

Bemerkung:

Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.






                                                                                                                                                                                                                                                                                                                                                                                                     


Neuigkeiten

     Aktuelles
     Motto des Tages

Software

     Quellcodebibliothek
     Eigene Quellcodes
     Fremde Quellcodes
     Suchen

Aktivitäten

     Artikel über Sicherheit
     Anleitung zur Aktivierung von SSL

Muße

     Gedichte
     Musik
     Bilder

Jenseits des Üblichen ....

Besucherstatistik

Besucherstatistik