Struct AgentStats 

#[non_exhaustive]
pub struct AgentStats {

    pub session_duration_ns: u64,
    pub lookups: u64,
    pub unconsulted: u64,
    pub hits: u64,
    pub stores: u64,
    pub stored_bytes: u64,
    pub verifications: u64,
    pub divergences: u64,
    pub downloaded_bytes: u64,
    pub uploaded_bytes: u64,
    pub prefetched_actions: u64,
    pub bypasses: BTreeMap<String, u64>,
    pub avoided_compiler_duration_ns: u64,
    pub compiler: BTreeMap<String, CompilerStats>,
    pub slow_compilations: BTreeMap<String, u64>,
    pub remote_failures: u64,
    pub remote_manifest_lookups: u64,
    pub remote_manifest_lookup_duration_ns: u64,
    pub remote_action_lookups: u64,
    pub remote_action_lookup_duration_ns: u64,
    pub remote_blob_requests: u64,
    pub remote_blob_pack_requests: u64,
    pub remote_blob_pack_blobs: u64,
    pub remote_blob_transfer_duration_ns: u64,
    pub local_cas_write_duration_ns: u64,
    pub prefetch_runs: u64,
    pub prefetch_duration_ns: u64,
    pub materialization_duration_ns: u64,
    pub restored_output_files: u64,
    pub restored_output_bytes: u64,
    pub reflinked_output_files: u64,
    pub reflinked_output_bytes: u64,
    pub copied_output_files: u64,
    pub copied_output_bytes: u64,
}

Aggregate cache activity for one task session.

The agent produces these; nothing outside this crate has cause to build one. Saying so keeps a new counter from being a breaking change, which is what this type exists to accumulate – reach for AgentStats::default and assign the fields a test needs.

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.

session_duration_ns: u64

End-to-end lifetime of the task-scoped cache session.

lookups: u64

Number of action-result lookups.

unconsulted: u64

Compilations no action-result lookup was possible for, because no usable action key was available.

Counted separately from a miss, which is a lookup that found nothing. Both compile, but only a miss says a lookup happened.

hits: u64

Number of lookups that found a valid local action result.

stores: u64

Number of newly stored content-addressed objects.

stored_bytes: u64

Total size of newly stored objects.

verifications: u64

Number of cache hits compiled again for qualification.

divergences: u64

Number of qualification builds that diverged from the cached result.

downloaded_bytes: u64

CAS payload bytes downloaded from the remote cache.

uploaded_bytes: u64

CAS payload bytes uploaded to the remote cache.

prefetched_actions: u64

Complete actions staged before an adapter requested them.

bypasses: BTreeMap<String, u64>

Compilations that were not cacheable, counted by reason.

avoided_compiler_duration_ns: u64

Estimated compiler time avoided by restored action hits.

compiler: BTreeMap<String, CompilerStats>

Real compiler work performed in this session, grouped by outcome.

slow_compilations: BTreeMap<String, u64>

Cumulative real compiler time by crate name.

remote_failures: u64

Remote cache operations that failed and were degraded to a local result.

A remote cache that cannot be reached, or that answers in a way this client refuses, costs hit rate rather than correctness, so every one of these is recovered from rather than raised. Counting them is what keeps a remote that is failing every request from reading as one that merely had nothing to offer.

remote_manifest_lookups: u64

Number of task manifest requests made to the remote cache.

remote_manifest_lookup_duration_ns: u64

Cumulative time spent requesting remote task manifests.

remote_action_lookups: u64

Number of action-result requests made to the remote cache.

remote_action_lookup_duration_ns: u64

Cumulative time spent requesting remote action results.

remote_blob_requests: u64

Number of blob requests made to the remote cache.

remote_blob_pack_requests: u64

Number of packed blob requests made to the remote cache.

remote_blob_pack_blobs: u64

Number of verified blobs received through packed responses.

remote_blob_transfer_duration_ns: u64

Cumulative time spent downloading and verifying remote blobs.

local_cas_write_duration_ns: u64

Cumulative time spent ingesting downloaded blobs into the local CAS.

prefetch_runs: u64

Number of speculative prefetch runs started for task manifests.

prefetch_duration_ns: u64

Cumulative wall time of speculative task-manifest prefetch runs.

materialization_duration_ns: u64

Cumulative time spent staging or materializing and validating cached outputs.

restored_output_files: u64

Number of compiler output files restored from action hits.

restored_output_bytes: u64

Declared size of compiler output files restored from action hits.

reflinked_output_files: u64

Number of restored output files materialized with filesystem reflinks.

reflinked_output_bytes: u64

Declared size of outputs materialized with filesystem reflinks.

copied_output_files: u64

Number of restored output files materialized by copying their bytes.

copied_output_bytes: u64

Declared size of outputs materialized by copying their bytes.

Trait Implementations

impl Clone for AgentStats

fn clone(&self) -> AgentStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentStats

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

Formats the value using the given formatter.

impl Default for AgentStats

fn default() -> AgentStats

Returns the “default value” for a type.

impl Eq for AgentStats

impl PartialEq for AgentStats

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AgentStats