Struct Checkpoints 

pub struct Checkpoints {
    pub interval_secs: Option<u64>,
    pub directory: Option<PathBuf>,
    pub keep: usize,
}

Taking a checkpoint on a schedule, and keeping the last few.

Run by the maintenance thread, beside the flush, compaction, rollup and retention passes — the deployments this is for have no scheduler of their own. Off unless interval_secs is set.

[database.checkpoints]
interval_secs = 21600      # every six hours
directory     = "/mnt/backup/chronix"
keep          = 4          # a day of history

Each run writes <directory>/<timestamp>; the oldest are removed once more than keep remain, and a run with no manifest is removed on sight. A failed run leaves the existing checkpoints alone and increments chronix_backup_failures_total.

directory must be outside the data directory’s segments/ tree. On the same filesystem the segments are hard-linked, so the checkpoint is not a second copy of the bytes — point it at a different volume if surviving that volume is the aim.

Fields

interval_secs: Option<u64>

How often to take one. None — the default — is off.

directory: Option<PathBuf>

Where they go. Required when interval_secs is set.

keep: usize

How many to keep. Default 3; 0 keeps only the newest.

Implementations

impl Checkpoints

pub fn interval(&self) -> Option<Duration>

The interval, when scheduled checkpoints are on.

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

Check the declaration is usable.

Errors

ConfigError::Validation if an interval is set without a directory — the one combination that reads as “on” and does nothing.

Trait Implementations

impl Clone for Checkpoints

fn clone(&self) -> Checkpoints

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Checkpoints

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

Formats the value using the given formatter.

impl Default for Checkpoints

fn default() -> Checkpoints

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Checkpoints

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Checkpoints

impl PartialEq for Checkpoints

fn eq(&self, other: &Checkpoints) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Checkpoints

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Checkpoints