hyperi-rustlib 2.5.4

Opinionated Rust framework for high-throughput data pipelines at PB scale. Auto-wiring config, logging, metrics, tracing, health, and graceful shutdown — built from many years of production infrastructure experience.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

// Project:   hyperi-rustlib
// File:      src/metrics/dfe_groups/backpressure.rs
// Purpose:   DFE backpressure metrics group
// Language:  Rust
//
// License:   FSL-1.1-ALv2
// Copyright: (c) 2026 HYPERI PTY LIMITED

//! Backpressure metrics.

use metrics::Counter;

use super::super::MetricsManager;

/// Backpressure event tracking.
///
/// Counts backpressure activations and cumulative pause duration.
#[derive(Clone)]
pub struct BackpressureMetrics {
    pub events: Counter,
    pub duration: Counter,
}

impl BackpressureMetrics {
    #[must_use]
    pub fn new(manager: &MetricsManager) -> Self {
        Self {
            events: manager.counter_with_labels(
                "backpressure_events_total",
                "Backpressure activation events",
                &[],
                "backpressure",
            ),
            duration: manager.counter_with_labels(
                "backpressure_duration_seconds_total",
                "Cumulative time paused by backpressure",
                &[],
                "backpressure",
            ),
        }
    }

    #[inline]
    pub fn record_event(&self) {
        self.events.increment(1);
    }

    /// Record backpressure pause duration in seconds.
    #[inline]
    pub fn record_duration(&self, seconds: f64) {
        // Duration is always non-negative and fits in u64 for practical values.
        #[allow(clippy::cast_sign_loss, clippy::cast_possible_truncation)]
        self.duration.increment(seconds as u64);
    }
}