Struct AnnHealth 

pub struct AnnHealth {
    pub vectors: u64,
    pub clusters_nonempty: u32,
    pub clusters_total: u32,
    pub runs: u32,
    pub largest_cluster: u32,
    pub largest_cluster_vectors: u64,
    pub imbalance: f64,
    pub payload_bytes: u64,
}

Cheap structural health of one ANN payload, computed from the in-memory run directory in O(runs) — payload bytes are never touched.

Two production failure modes motivated every field here (see docs/diagnostics.md): a 31%-of-vectors leaf built from degenerate embeddings, and probe read-amplification from byte-copy merges that leave one logical cluster scattered across many physical extents.

Fields

vectors: u64

Vectors across all runs.

clusters_nonempty: u32

Distinct cluster IDs holding at least one posting.

clusters_total: u32

Codebook size (num_clusters from the header).

runs: u32

Run-directory entries; each is one physical extent on disk.

largest_cluster: u32

Vectors in the most populated cluster, with its ID.

largest_cluster_vectors: u64

imbalance: f64

Faiss imbalance_factor over non-empty clusters: K · Σ nᵢ² / N². 1.0 is perfectly balanced; a value of γ means a fixed-nprobe probe computes γ× the distances of the balanced baseline in expectation.

payload_bytes: u64

Bytes of the codes columns (what a probe of every leaf would read).

Implementations

impl AnnHealth

pub fn fragmentation(&self) -> f64

Physical extents per non-empty cluster. 1.0 after a rebuild; each byte-copy merge multiplies it, and every extent is a potential seek when the index is cold.

pub fn largest_cluster_share(&self) -> f64

Share of all vectors held by the single largest cluster.

Trait Implementations

impl Clone for AnnHealth

fn clone(&self) -> AnnHealth

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AnnHealth

impl Debug for AnnHealth

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

Formats the value using the given formatter.

impl PartialEq for AnnHealth

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AnnHealth