Struct CleanupConfig 

pub struct CleanupConfig {

    pub base_interval: Duration,
    pub min_interval: Duration,
    pub max_interval: Duration,
    pub high_utilization_threshold: f64,
    pub low_utilization_threshold: f64,
    pub utilization_hysteresis: f64,
    pub drop_some_threshold: f64,
    pub drop_most_threshold: f64,
    pub block_new_threshold: f64,
    pub target_cleanup_duration: Duration,
    pub high_load_message_rate: f64,
    pub rate_window: Duration,
    pub batch_size_smoothing: f64,
    pub ttl_divisor: f64,
    pub efficiency_weight: f64,
    pub efficiency_smoothing: f64,
    pub min_cycles_for_efficiency: u64,
    pub max_ttl_interval_factor: f64,
}

Configuration for dynamic cleanup tuning.

Fields

base_interval: Duration

Base cleanup interval (when utilization is moderate).

min_interval: Duration

Minimum cleanup interval (under high utilization).

max_interval: Duration

Maximum cleanup interval (under low utilization).

high_utilization_threshold: f64

Cache utilization threshold for aggressive cleanup (0.0-1.0).

low_utilization_threshold: f64

Cache utilization threshold for relaxed cleanup (0.0-1.0).

utilization_hysteresis: f64

Hysteresis for utilization thresholds (prevents flapping). Applied as ± adjustment to thresholds when already in a state.

drop_some_threshold: f64

Utilization threshold for DropSome backpressure (0.0-1.0). Default: 0.93

drop_most_threshold: f64

Utilization threshold for DropMost backpressure (0.0-1.0). Default: 0.96

block_new_threshold: f64

Utilization threshold for BlockNew backpressure (0.0-1.0). Default: 0.98

target_cleanup_duration: Duration

Target cleanup duration (try to keep cleanup under this).

high_load_message_rate: f64

Message rate threshold for high load (messages per second).

rate_window: Duration

Window size for calculating message rate.

batch_size_smoothing: f64

Batch size smoothing factor (0.0-1.0). Higher = more responsive to changes. Recommended: 0.1-0.2 for production stability.

ttl_divisor: f64

Cleanup interval should be at least TTL divided by this value. Default is 4, meaning cleanup runs at least 4 times per TTL period. Valid range: 2.0-20.0 (enforced at construction).

efficiency_weight: f64

Weight for removal efficiency in batch size calculation (0.0-1.0). Higher values make batch size more responsive to how many entries are actually being removed vs just scanned.

efficiency_smoothing: f64

Smoothing factor for efficiency EMA (0.0-1.0). Lower = smoother/slower to respond, higher = more responsive.

min_cycles_for_efficiency: u64

Minimum cleanup cycles before efficiency data is trusted. Prevents wild adjustments during startup.

max_ttl_interval_factor: f64

Maximum TTL-based interval multiplier to prevent huge intervals. If TTL is very large, interval is capped at max_interval * this factor.

Implementations

impl CleanupConfig

pub fn new() -> Self

Create a new cleanup config with default values.

pub fn high_throughput() -> Self

Configuration for high-throughput scenarios.

More aggressive cleanup to prevent memory pressure.

pub fn low_latency() -> Self

Configuration for low-latency scenarios.

Smaller, more frequent cleanups to minimize impact.

pub const fn with_base_interval(self, interval: Duration) -> Self

Set the base cleanup interval (builder pattern).

pub const fn with_min_interval(self, interval: Duration) -> Self

Set the minimum cleanup interval (builder pattern).

pub const fn with_max_interval(self, interval: Duration) -> Self

Set the maximum cleanup interval (builder pattern).

pub fn with_high_utilization_threshold(self, threshold: f64) -> Self

Set the high utilization threshold (builder pattern).

pub fn with_low_utilization_threshold(self, threshold: f64) -> Self

Set the low utilization threshold (builder pattern).

pub fn with_ttl_divisor(self, divisor: f64) -> Self

Set the TTL divisor (builder pattern).

pub fn with_backpressure_thresholds( self, drop_some: f64, drop_most: f64, block_new: f64, ) -> Self

Set backpressure thresholds (builder pattern).

pub fn with_efficiency_smoothing(self, smoothing: f64) -> Self

Set efficiency smoothing factor (builder pattern).

Trait Implementations

impl Clone for CleanupConfig

fn clone(&self) -> CleanupConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CleanupConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CleanupConfig

fn default() -> Self

Returns the “default value” for a type.