Struct CaptureFailure 

#[non_exhaustive]
pub struct CaptureFailure<'a> { /* private fields */ }

Details of a terminal capture batch failure.

Fields are read through accessors; the struct is #[non_exhaustive].

Does not fire for shutdown-timeout, queue-full, or before_send drops — those are not delivery failures.

Implementations

impl<'a> CaptureFailure<'a>

pub fn error(&self) -> Option<&Error>

The batch-level cause: a permanent reject, exhausted transport/HTTP retries, or a serialization failure. Always present: every capture failure surfaced to the hook carries a cause.

pub fn status(&self) -> Option<u16>

The HTTP status of the final attempt, or None when no response was received (a transport error or a serialization failure before sending).

pub fn attempt(&self) -> u32

The failing attempt number (equals the configured maximum on exhaustion).

pub fn event_count(&self) -> usize

Number of events this failure dropped (lost).

pub fn historical_migration(&self) -> bool

Whether the batch was a historical-migration batch.

Trait Implementations

impl<'a> Debug for CaptureFailure<'a>

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

Formats the value using the given formatter.