Struct CgroupStats 

#[non_exhaustive]
pub struct CgroupStats {
    pub cpu: CgroupCpuStats,
    pub memory: CgroupMemoryStats,
    pub pids: CgroupPidsStats,
    pub psi: Psi,
}

Per-cgroup enrichment record attached to CtprofSnapshot.

Populated from the cgroup v2 filesystem at capture time. The shape mirrors the kernel’s per-controller file layout: CgroupCpuStats holds the cpu.* files, CgroupMemoryStats holds the memory.* files, CgroupPidsStats holds the pids.* files, and Psi holds the <resource>.pressure files. These are aggregate-over-the-cgroup values — NOT summable from per-thread data — so the capture layer reads them directly from cgroupfs rather than deriving.

Nested-struct shape (rather than a flat ~50-field struct) mirrors the kernel’s controller-by-controller exposure: a reader who knows the kernel layout can map directly between cgroupfs files and Rust fields, and the merge policy in crate::ctprof_compare::flatten_cgroup_stats applies per-domain (max for limits, min for floors, saturating_add for counters) without conflating across domains.

Schema note: the previous flat shape (4 fields: cpu_usage_usec, nr_throttled, throttled_usec, memory_current) is gone. Snapshots written by older versions deserialize via serde’s defaulting — old fields land on the new nested fields’ zero defaults rather than migrating, so a baseline-vs-candidate compare against an old snapshot produces “every counter went from N to 0”. Re-capture both sides with the current build to compare faithfully. Per the project’s pre-1.0 disposable-sidecar policy this is intentional.

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.

cpu: CgroupCpuStats

memory: CgroupMemoryStats

pids: CgroupPidsStats

psi: Psi

Pressure Stall Information for this cgroup, per resource. Populated from <cgroup>/cpu.pressure, <cgroup>/memory.pressure, <cgroup>/io.pressure, and <cgroup>/irq.pressure (cgroup v2 files declared in cgroup_psi_files[] (kernel/cgroup/cgroup.c)). Defaults to all-zero when the kernel has CONFIG_PSI off, when PSI is disabled at runtime via the psi=0 boot param, or when individual resource files are absent (older kernels missing irq.pressure).

Trait Implementations

impl Clone for CgroupStats

fn clone(&self) -> CgroupStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CgroupStats

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

Formats the value using the given formatter.

impl Default for CgroupStats

fn default() -> CgroupStats

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CgroupStats

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CgroupStats

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

where __S: Serializer,

Serialize this value into the given Serde serializer.