Struct SamplingConfig 

pub struct SamplingConfig {
    pub large_allocation_rate: f64,
    pub medium_allocation_rate: f64,
    pub small_allocation_rate: f64,
    pub large_threshold: usize,
    pub medium_threshold: usize,
    pub frequency_threshold: u64,
}

Sampling configuration for intelligent allocation tracking

Uses dual-dimension sampling (size + frequency) to balance performance with data completeness. Large allocations and high-frequency patterns receive priority sampling.

Fields

large_allocation_rate: f64

Sample rate for large allocations - usually 100% to catch memory leaks

medium_allocation_rate: f64

Sample rate for medium allocations - balanced approach

small_allocation_rate: f64

Sample rate for small allocations - low to reduce overhead

large_threshold: usize

Size threshold for large allocations (bytes)

medium_threshold: usize

Size threshold for medium allocations (bytes)

frequency_threshold: u64

Frequency threshold for sampling boost

Implementations

impl SamplingConfig

pub fn high_precision() -> Self

Creates high-precision configuration for debugging scenarios

Higher sampling rates for more complete data capture at the cost of increased performance overhead.

pub fn performance_optimized() -> Self

Creates performance-optimized configuration for production

Minimal sampling to reduce overhead while still capturing the most critical allocation patterns.

pub fn leak_detection() -> Self

Creates configuration for memory leak detection

Optimized to catch large allocations and allocation patterns that might indicate memory leaks.

pub fn demo() -> Self

Creates configuration for demonstrations and testing

Maximum sampling rates to ensure all data is visible in demos and tests. Not suitable for production due to very high performance overhead.

pub fn validate(&self) -> Result<(), String>

Validates configuration parameters

Ensures all rates are between 0.0 and 1.0 and thresholds are reasonable.

pub fn base_sampling_rate(&self, size: usize) -> f64

Calculates expected sampling rate for given allocation size

Returns the base sampling rate before frequency adjustments.

pub fn frequency_multiplier(&self, frequency: u64) -> f64

Calculates frequency multiplier for sampling boost

High-frequency allocations get increased sampling rates to identify performance hotspots.

Trait Implementations

impl Clone for SamplingConfig

fn clone(&self) -> SamplingConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SamplingConfig

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

Formats the value using the given formatter.

impl Default for SamplingConfig

fn default() -> Self

Default configuration optimized for typical applications

Captures all large allocations, moderate sampling of medium allocations, and light sampling of small allocations to maintain performance.