Struct CheckpointConfig 

pub struct CheckpointConfig {
    pub interval: Duration,
    pub warn_pages: u64,
    pub high_water_pages: u64,
}

Configuration for the WAL checkpoint background task.

All fields default to conservative production values. Override via the environment variables documented on each field.

Fields

interval: Duration

How often to run a passive checkpoint when there is no active write.

Overridable via KHIVE_CHECKPOINT_INTERVAL_MS (milliseconds). Default: 500 ms.

warn_pages: u64

WAL page count above which a warning is logged.

Overridable via KHIVE_WAL_WARN_PAGES. Default: 2000 pages (~8 MB at 4 KiB page size).

high_water_pages: u64

WAL page count above which a high-pressure WARNING is logged.

The periodic task always runs PASSIVE regardless; this threshold signals that a long-lived reader may be pinning an old WAL snapshot that PASSIVE cannot reclaim. An operator can then schedule a blocking TRUNCATE at a safe moment outside normal write traffic.

Overridable via KHIVE_WAL_HIGH_WATER_PAGES. Default: 6000 pages (~24 MB at 4 KiB page size).

Implementations

impl CheckpointConfig

pub fn from_env() -> CheckpointConfig

Build a CheckpointConfig from the environment.

Unset or unparseable variables fall back to the compiled-in defaults.

Trait Implementations

impl Clone for CheckpointConfig

fn clone(&self) -> CheckpointConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CheckpointConfig

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

Formats the value using the given formatter.

impl Default for CheckpointConfig

fn default() -> CheckpointConfig

Returns the “default value” for a type.