Struct WriterStats 

pub struct WriterStats {
    pub unattributed: u64,
    pub attribution_unreported_batches: u64,
    pub counter_overflow: bool,
    pub accepted: u64,
    pub duplicate: u64,
    pub rejected: u64,
    pub lost: u64,
    pub unresolved: u64,
}

Terminal accounting of a writer’s lifetime, returned by UsageWriter::shutdown. lost counts events a final flush could not deliver; unresolved counts permits still outstanding when the drain deadline expired — both reported, never silent.

Deliberately not Default: a zeroed report must never be conjurable from a failure (unwrap_or_default on a dead task’s JoinError is the bug this type’s history records — issue GL-41). Use WriterStats::ZERO when a starting value is genuinely meant.

Fields

unattributed: u64

Confirmed unattributed newly accepted events. Lost acknowledgements followed by duplicate replies cannot reconstruct historical counts.

attribution_unreported_batches: u64

Acknowledged batches whose sink did not report attribution support.

counter_overflow: bool

At least one cumulative outcome exceeded u64; its value is saturated.

accepted: u64

Events the sink newly recorded: billed.

duplicate: u64

Events whose request id the sink had already recorded, from a retried batch whose acknowledgement was lost. Ingest is idempotent (INVARIANTS.md 7), so these are not double charges; a steady rate points at acknowledgements lost to timeouts.

rejected: u64

Events the sink refused: unknown lease, lease-capability mismatch, no remaining accounting capacity, or units outside its storage domain. Bounded billing loss that has already happened, left for reconciliation. Normal is zero; a trickle usually means events land after their lease settled, so the drain deadline sits too close to expiry_safety_margin + reclaim_grace.

lost: u64

Events that will never reach the ledger: batches the sink refused with a non-retryable error, and events the final flush could not deliver before its deadline. Any nonzero value is committed charges that went unbilled. A healthy but unreachable sink leaves this at zero until shutdown, so alert on WriterHealth::ingest_age instead.

unresolved: u64

Permits (in-flight requests or committed guards) that neither sent nor dropped before the drain deadline. Their charges are locally committed but unbilled; TTL reclaim bounds them (INVARIANTS.md GL-9).

Implementations

impl WriterStats

pub const ZERO: WriterStats

A writer that has accounted for nothing yet.

Trait Implementations

impl Clone for WriterStats

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for WriterStats

impl Debug for WriterStats

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

Formats the value using the given formatter.

impl Eq for WriterStats

impl PartialEq for WriterStats

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WriterStats