Struct BufferStats 

#[non_exhaustive]
pub struct BufferStats {
    pub pending_count: u64,
    pub latest_sequence: u64,
    pub head_sequence: u64,
    pub next_sequence: u64,
    pub approx_disk_bytes: u64,
    pub segment_count: u64,
    pub max_size_bytes: u64,
    pub store_pressure: f32,
}

Point-in-time snapshot of buffer state, captured atomically under a single lock acquisition so all fields are mutually consistent.

Returned by SegmentBuffer::stats. Useful for metrics endpoints or dashboards that need to observe multiple values without paying for several lock/unlock round-trips (and risking a torn read between calls).

This struct is #[non_exhaustive]: new fields may be added in any release without breaking semver. It is constructed internally by SegmentBuffer::stats; callers read fields via dot-syntax or pattern-match with .. only.

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.

pending_count: u64

Items waiting in the buffer (on-disk + in-memory pending). Same value as SegmentBuffer::pending_count.

latest_sequence: u64

Highest sequence number assigned (or 0 if the buffer is empty). Same value as SegmentBuffer::latest_sequence.

head_sequence: u64

Oldest unacknowledged sequence number (head_seq).

next_sequence: u64

Next sequence number that will be assigned by the next successful SegmentBuffer::append (next_seq).

approx_disk_bytes: u64

Approximate total bytes used by segment files on disk. Decreases when SegmentBuffer::delete_acked removes files.

segment_count: u64

Number of segment files currently on disk. Incremented by SegmentBuffer::flush, decremented by SegmentBuffer::delete_acked, and recalibrated by SegmentBuffer::sync_disk_bytes. Unlike RecoveryReport::segment_count (a one-time open-time snapshot), this value is live — call SegmentBuffer::stats to observe it.

max_size_bytes: u64

Configured ceiling on disk usage (max_size_bytes). 0 disables the limit; in that case store_pressure is 0.0.

store_pressure: f32

approx_disk_bytes / max_size_bytes, clamped to [0.0, 1.0]. 0.0 when no limit is configured.

Trait Implementations

impl Clone for BufferStats

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BufferStats

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

Formats the value using the given formatter.

impl Display for BufferStats

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

Human-readable single-line summary suitable for logging.

The format is compact and stable across releases. All eight fields appear in a fixed order matching the struct declaration. Byte values (approx_disk_bytes, max_size_bytes) use binary units for readability (4.0KB, 1.0MB); all other fields are raw numbers.