Struct AdaptiveBatchConfig 

pub struct AdaptiveBatchConfig {
    pub enabled: bool,
    pub controller: String,
    pub min: usize,
    pub max: usize,
    pub increase_step: usize,
    pub decrease_factor: f64,
    pub cooldown_batches: usize,
    pub target_latency_ms: Option<u64>,
    pub latency_window: usize,
    pub error_threshold: f64,
    pub respect_source_max: bool,
    pub log_every: usize,
}

Configuration for the adaptive batch-size controller. Lives under execution.adaptive_batch_size. Default enabled = false (opt-in); when disabled the pipeline writes each page exactly as before.

Fields

enabled: bool

Master switch. Default false.

controller: String

Controller algorithm. Only "aimd" is implemented in v1.

min: usize

Lower bound on the effective batch size.

max: usize

Upper bound. Under within-page reslicing the effective ceiling is min(max, page_len); values above the source page size are inert.

increase_step: usize

Additive growth per clean+fast batch.

decrease_factor: f64

Multiplicative shrink factor on error / high latency (0 < f < 1).

cooldown_batches: usize

Batches to wait after a shrink before allowing growth.

target_latency_ms: Option<u64>

Optional latency target in ms. None = react to errors only.

latency_window: usize

Rolling window size for the p50 batch-write latency.

error_threshold: f64

Per-batch error rate above which the controller shrinks.

respect_source_max: bool

Never grow the effective batch past the source page size. Only true is supported (the default) — false is rejected by validate, since cross-page buffering would have to hold records across source pages and break the pipeline’s O(batch_size) memory guarantee.

log_every: usize

Emit a tracing::info! summary every N adjustments.

Implementations

impl AdaptiveBatchConfig

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

Fail-fast validation, surfaced as FaucetError::Config at config load.

Trait Implementations

impl Clone for AdaptiveBatchConfig

fn clone(&self) -> AdaptiveBatchConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AdaptiveBatchConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AdaptiveBatchConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<AdaptiveBatchConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for AdaptiveBatchConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for AdaptiveBatchConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.