Struct SystemHealth 

pub struct SystemHealth { /* private fields */ }

System health monitor with process introspection.

Owns a background sampler thread (unless constructed via SystemHealth::manual) that refreshes the cached values every update_interval_ms. All accessor methods are lock-free atomic loads.

Implementations

impl SystemHealth

pub fn new() -> Self

Create a new system health monitor with the default refresh interval of 1 second. A background sampler thread is spawned and joined on Drop.

pub fn with_interval(interval: Duration) -> Self

Create with a custom refresh interval. Uses HealthConfig::default for the health-score thresholds.

• interval == Duration::ZERO ⇒ no sampler thread is spawned; callers must use Self::update to refresh the cached values (equivalent to Self::manual).
• Intervals below 50 ms are clamped to 50 ms to prevent the sampler from becoming a CPU spin loop.

pub fn with_config(interval: Duration, config: HealthConfig) -> Self

Create with both a custom refresh interval and a custom HealthConfig (v0.9.5+). See Self::with_interval for interval semantics.

pub fn manual() -> Self

Construct a manual-mode instance with no sampler thread. Callers must invoke Self::update to refresh the cached values.

pub fn update_interval_ms(&self) -> u64

Configured refresh interval in milliseconds. 0 indicates manual mode (no sampler thread).

pub fn cpu_used(&self) -> f64

Get system CPU usage percentage. Lock-free atomic load.

pub fn cpu_free(&self) -> f64

Get system CPU free percentage.

pub fn mem_used_mb(&self) -> f64

Get system memory usage in MB. Lock-free atomic load.

pub fn mem_used_gb(&self) -> f64

Get system memory usage in GB.

pub fn process_cpu_used(&self) -> f64

Get process CPU usage percentage. Lock-free atomic load.

pub fn process_mem_used_mb(&self) -> f64

Get process memory usage in MB. Lock-free atomic load.

pub fn load_avg(&self) -> f64

Get system load average. Lock-free atomic load.

pub fn thread_count(&self) -> u32

Get process thread count. Lock-free atomic load.

pub fn fd_count(&self) -> u32

Get process file descriptor count. Lock-free atomic load.

pub fn health_score(&self) -> f64

Get overall system health score (0.0-100.0). Lock-free atomic load.

pub fn quick_check(&self) -> HealthStatus

Quick health check. Lock-free atomic load.

pub fn update(&self)

Force immediate (synchronous) refresh of every cached metric.

Bypasses the sampler interval — useful for tests, on-demand snapshots, or manual-mode operation. Safe to call from any thread.

pub fn snapshot(&self) -> SystemSnapshot

Get a detailed system snapshot. Lock-free atomic loads.

pub fn process(&self) -> ProcessStats

Get process-specific statistics. Lock-free atomic loads.

Trait Implementations

impl Debug for SystemHealth

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

Formats the value using the given formatter.

impl Default for SystemHealth

fn default() -> Self

Returns the “default value” for a type.

impl Display for SystemHealth

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

Formats the value using the given formatter.