Struct FailoverProgressEvent 

#[non_exhaustive]
pub struct FailoverProgressEvent {
    pub phase: FailoverPhase,
    pub failed_addr: Endpoint,
    pub new_addr: Option<Endpoint>,
    pub new_server_info: Option<ServerInfo>,
    pub new_request_id: Option<i64>,
    pub attempt: u32,
    pub trigger: Error,
    pub elapsed: Duration,
    pub final_error: Option<Error>,
}

Notification delivered to the ReaderQuery::on_failover_progress callback at each transition of a mid-query failover lifecycle. See FailoverPhase for the per-variant semantics.

Several fields are populated only in certain phases — see the per-field docs. Marked #[non_exhaustive] so we can add fields without breaking downstream pattern matches.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

phase: FailoverPhase

Which lifecycle phase fired this event.

failed_addr: Endpoint

Endpoint that died. Set on every phase — even Reset keeps it so a single sink can correlate the failed/new pair without remembering state across calls.

new_addr: Option<Endpoint>

New endpoint the cursor is now bound to. Some only on FailoverPhase::Reset.

new_server_info: Option<ServerInfo>

SERVER_INFO of the new endpoint. Some only on FailoverPhase::Reset.

new_request_id: Option<i64>

Newly-allocated request_id. Some only on FailoverPhase::Reset.

attempt: u32

1-based attempt counter:

• 0 on Disconnected (no attempt yet).
• N ≥ 1 on Retrying for the Nth dial.
• On Reset, the attempt that landed.
• On GaveUp, the total number of attempts burned. May be 0 when the wall-clock deadline was already exhausted before any walk fired.

trigger: Error

The error that triggered the failover (the original cause-of-death of the previous connection). Preserved across every phase so subscribers see consistent context regardless of when they latch on.

elapsed: Duration

Wall-clock time since the disconnect was observed (the start of the failover cycle). Monotonically non-decreasing across phases of the same event.

final_error: Option<Error>

Final error returned to the caller. Some only on FailoverPhase::GaveUp; this is the value the next call to Cursor::next_batch (or add_credit) will surface.

Trait Implementations

impl Clone for FailoverProgressEvent

fn clone(&self) -> FailoverProgressEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FailoverProgressEvent

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

Formats the value using the given formatter.