confluent_kafka/common/metrics/stats/
simple_rate.rs1use crate::common::metrics::TimeUnit;
18use crate::common::metrics::internals::MetricsUtils;
19use crate::common::metrics::stats::Rate;
20use crate::common::metrics::{Measurable, MetricConfig, Stat};
21
22#[derive(Debug)]
33#[doc(alias = "org.apache.kafka.common.metrics.stats.SimpleRate")]
34pub struct SimpleRate {
37 rate: Rate,
38}
39
40impl SimpleRate {
41 #[doc(alias = "org.apache.kafka.common.metrics.stats.SimpleRate#SimpleRate")]
43 pub fn new() -> Self {
44 Self { rate: Rate::new() }
45 }
46
47 #[doc(alias = "org.apache.kafka.common.metrics.stats.SimpleRate#windowSize")]
59 pub fn window_size(&self, config: &MetricConfig, now: i64) -> i64 {
60 let stat = self.rate.stat();
61 stat.purge_obsolete_samples(config, now);
62 let elapsed = now - stat.oldest_start_time_ms(now);
63 elapsed.max(config.time_window_ms())
64 }
65}
66
67impl Default for SimpleRate {
68 fn default() -> Self {
69 Self::new()
70 }
71}
72
73impl Stat for SimpleRate {
74 fn record(&self, config: &MetricConfig, value: f64, time_ms: i64) {
75 self.rate.record(config, value, time_ms);
76 }
77}
78
79impl Measurable for SimpleRate {
80 fn measure(&self, config: &MetricConfig, now: i64) -> f64 {
81 let value = self.rate.stat().measure(config, now);
84 value / MetricsUtils::convert(self.window_size(config, now), TimeUnit::Seconds)
85 }
86}
87
88impl std::fmt::Display for SimpleRate {
89 fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
91 std::fmt::Display::fmt(&self.rate, f)
92 }
93}
94
95#[cfg(test)]
96mod tests {
97 use super::*;
98
99 #[test]
100 fn to_string_follows_java() {
101 assert_eq!(
102 SimpleRate::new().to_string(),
103 "Rate(unit=SECONDS, stat=SampledStat(initialValue=0.0, current=0, samples=[]))"
104 );
105 }
106 use crate::common::utils::MockTime;
107 use crate::common::utils::Time;
108
109 fn record(rate: &SimpleRate, config: &MetricConfig, time: &MockTime, value: f64) {
110 rate.record(config, value, time.milliseconds());
111 }
112 fn measure(rate: &SimpleRate, config: &MetricConfig, time: &MockTime) -> f64 {
113 rate.measure(config, time.milliseconds())
114 }
115
116 #[test]
118 fn test_simple_rate() {
119 let rate = SimpleRate::new();
120 let config = MetricConfig::new().set_time_window(1, TimeUnit::Seconds).set_samples(10);
121 let time = MockTime::new();
122
123 record(&rate, &config, &time, 1000.0);
127 assert_eq!(1000.0, measure(&rate, &config, &time)); time.sleep(100);
129 assert_eq!(1000.0, measure(&rate, &config, &time)); time.sleep(100);
131 assert_eq!(1000.0, measure(&rate, &config, &time)); time.sleep(200);
133 assert_eq!(1000.0, measure(&rate, &config, &time)); time.sleep(600);
138 assert_eq!(1000.0, measure(&rate, &config, &time)); time.sleep(200);
140 assert_eq!(1000.0 / 1.2, measure(&rate, &config, &time)); time.sleep(200);
142 assert_eq!(1000.0 / 1.4, measure(&rate, &config, &time)); record(&rate, &config, &time, 1000.0);
146 assert_eq!(2000.0 / 1.4, measure(&rate, &config, &time)); time.sleep(1100);
150 assert_eq!(2000.0 / 2.5, measure(&rate, &config, &time)); record(&rate, &config, &time, 1000.0);
152 assert_eq!(3000.0 / 2.5, measure(&rate, &config, &time)); time.sleep(6500);
156 assert!((3000.0 / 9.0 - measure(&rate, &config, &time)).abs() <= 1.0); record(&rate, &config, &time, 1000.0);
158 assert!((4000.0 / 9.0 - measure(&rate, &config, &time)).abs() <= 1.0); time.sleep(1500);
164 assert!(((4000.0 - 1000.0) / (10.5 - 1.4) - measure(&rate, &config, &time)).abs() <= 1.0);
165 record(&rate, &config, &time, 1000.0);
166 assert!(((5000.0 - 1000.0) / (10.5 - 1.4) - measure(&rate, &config, &time)).abs() <= 1.0);
167 }
168}