Struct WorkCounters 

pub struct WorkCounters {

    pub authority_records_read: u64,
    pub authority_records_appended: u64,
    pub authority_bytes_read: u64,
    pub authority_bytes_written: u64,
    pub object_probes: u64,
    pub backend_read_operations: u64,
    pub backend_write_operations: u64,
    pub durability_operations: u64,
    pub page_reads: u64,
    pub page_writes: u64,
    pub object_bytes_read: u64,
    pub object_bytes_written: u64,
    pub bytes_hashed: u64,
    pub bytes_copied: u64,
    pub bytes_encoded: u64,
    pub source_bytes_read: u64,
    pub source_path_components: u64,
    pub source_entries_visited: u64,
    pub output_bytes: u64,
    pub items_examined: u64,
    pub items_returned: u64,
    pub allocation_operations: u64,
    pub peak_allocation_bytes: u64,
    pub materializations: u64,
}

Exact backend and memory work performed by one filesystem operation.

Fields

authority_records_read: u64

Authority records read.

authority_records_appended: u64

Authority records appended.

authority_bytes_read: u64

Canonical authority payload bytes read.

authority_bytes_written: u64

Canonical authority payload bytes appended.

object_probes: u64

Immutable-object metadata probes.

backend_read_operations: u64

Backend read calls, independent of bytes returned.

backend_write_operations: u64

Backend write calls, independent of bytes admitted.

durability_operations: u64

Durability barriers such as file or authority-log synchronization.

page_reads: u64

Authenticated tree, extent, or file-table pages read.

page_writes: u64

Authenticated pages created.

object_bytes_read: u64

Canonical object bytes read.

object_bytes_written: u64

Canonical object bytes written.

bytes_hashed: u64

Bytes supplied to cryptographic hashes.

bytes_copied: u64

Bytes copied between owned buffers.

bytes_encoded: u64

Canonical bytes produced by encoders.

source_bytes_read: u64

Bytes consumed from an import, capture, or application source.

source_path_components: u64

Components in requested source paths.

source_entries_visited: u64

Source entries observed by demand or native capture requests.

output_bytes: u64

Bytes returned to an application or export sink.

items_examined: u64

Canonical items examined by searches, filters, diffs, or merges.

items_returned: u64

Canonical items returned by bounded APIs.

allocation_operations: u64

Owned allocation operations attributable to the request.

peak_allocation_bytes: u64

Peak simultaneously owned allocation bytes attributable to the operation.

materializations: u64

Files or extents physically materialized.

Implementations

impl WorkCounters

pub const UNBOUNDED: Self

An explicit unbounded permit for tests and administrative tooling.

pub fn checked_add(self, other: Self) -> Result<Self, WorkError>

Adds one receipt while failing closed on accounting overflow.

Errors

Returns WorkError::Overflow if any exact counter cannot be represented.

pub fn verify(self, budget: WorkBudget) -> Result<(), WorkError>

Verifies every counter against an admitted hard budget.

Errors

Returns the first stable counter name that exceeded its bound.

pub fn remaining(self, budget: WorkBudget) -> Result<WorkBudget, WorkError>

Returns the remaining additive budget after this spent receipt. Peak allocation is an operation-wide maximum, so its remaining limit is unchanged and each backend allocation is checked against the same cap.

Errors

Returns the exact exceeded counter when already-spent work is outside the admitted budget.

Trait Implementations

impl Clone for WorkCounters

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 WorkCounters

impl Debug for WorkCounters

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

Formats the value using the given formatter.

impl Default for WorkCounters

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for WorkCounters

where WorkCounters: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for WorkCounters

impl PartialEq for WorkCounters

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for WorkCounters

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for WorkCounters