Struct InstallSnapshotBackoffPolicy 

pub struct InstallSnapshotBackoffPolicy {
    pub max_retries: usize,
    pub timeout_ms: u64,
    pub base_delay_ms: u64,
    pub max_delay_ms: u64,
    pub per_chunk_timeout_ms: u64,
    pub min_timeout_ms: u64,
    pub max_timeout_ms: u64,
    pub between_chunk_timeout_ms: u64,
    pub push_failure_alert_threshold: u32,
    pub push_backoff_max_delay_ms: u64,
}

Configuration for exponential backoff retry strategy

Fields

max_retries: usize

Maximum number of retries (0 means unlimited retries)

timeout_ms: u64

Single operation timeout (unit: milliseconds)

base_delay_ms: u64

Backoff base (unit: milliseconds)

max_delay_ms: u64

Maximum backoff time (unit: milliseconds)

per_chunk_timeout_ms: u64

Timeout per chunk during transfer (milliseconds)

min_timeout_ms: u64

Minimum overall timeout for snapshot RPC (milliseconds)

max_timeout_ms: u64

Maximum overall timeout for snapshot RPC (milliseconds)

between_chunk_timeout_ms: u64

Timeout between chunks on receiver side (milliseconds)

push_failure_alert_threshold: u32

Number of consecutive leader-initiated snapshot push failures before emitting an error-level alert (tracing::error! + metrics counter).

Protecting the leader’s replication throughput is the highest priority. A value of 5 avoids alert storms from brief network partitions while still surfacing persistent peer failures (disk full, crashed node) within seconds.

push_backoff_max_delay_ms: u64

Maximum backoff interval between consecutive leader-initiated snapshot push attempts for the same peer (milliseconds).

Intentionally higher than max_delay_ms (chunk-level RPC retry cap): once the chunk-level retries are exhausted, the leader should wait a full 30 s before re-attempting the entire transfer. This prevents a permanently unreachable peer from consuming I/O bandwidth on every heartbeat cycle and starving healthy followers’ AppendEntries. Leader protection is the highest priority.

Implementations

impl InstallSnapshotBackoffPolicy

pub fn validate(&self, policy_name: &str) -> Result<()>

Validates snapshot backoff policy parameters

Errors

Returns Error::InvalidConfig when:

• Inherited backoff parameters fail validation (see BackoffPolicy)
• Timeouts for snapshot chunks/transfers are invalid
• Snapshot RPC timeout constraints are violated

Trait Implementations

impl Clone for InstallSnapshotBackoffPolicy

fn clone(&self) -> InstallSnapshotBackoffPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstallSnapshotBackoffPolicy

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

Formats the value using the given formatter.

impl Default for InstallSnapshotBackoffPolicy

fn default() -> InstallSnapshotBackoffPolicy

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for InstallSnapshotBackoffPolicy

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InstallSnapshotBackoffPolicy

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for InstallSnapshotBackoffPolicy