Struct GpuMonitor 

pub struct GpuMonitor { /* private fields */ }

GPU Monitor for real-time metrics collection (TRUENO-SPEC-010)

Provides both on-demand and background metric collection with configurable polling intervals and history retention.

Example

use trueno::monitor::{GpuMonitor, MonitorConfig};

// Create monitor for device 0
let monitor = GpuMonitor::new(0, MonitorConfig::default())?;

// Get latest metrics
let metrics = monitor.latest()?;
println!("GPU usage: {}%", metrics.utilization.gpu_percent);

// Get history (ring buffer)
let history = monitor.history();
println!("Samples: {}", history.len());

Implementations

impl GpuMonitor

pub fn new( device_index: u32, config: MonitorConfig, ) -> Result<Self, MonitorError>

Create a new GPU monitor for the specified device

Errors

Returns error if device is not found or initialization fails.

pub fn mock(device_info: GpuDeviceInfo, config: MonitorConfig) -> Self

Create a mock monitor for testing (no GPU required)

pub fn device_info(&self) -> &GpuDeviceInfo

Get device info

pub fn config(&self) -> &MonitorConfig

Get current configuration

pub fn collect(&self) -> Result<GpuMetrics, MonitorError>

Collect metrics sample now

This performs an immediate collection and adds to history.

pub fn latest(&self) -> Result<GpuMetrics, MonitorError>

Get the latest metrics snapshot (without collecting)

pub fn history(&self) -> Vec<GpuMetrics>

Get history buffer (read-only snapshot)

pub fn sample_count(&self) -> usize

Get number of samples in history

pub fn clear_history(&self)

Clear history buffer

pub fn is_collecting(&self) -> bool

Check if background collection is active

pub fn stop(&self)

Stop background collection (if running)

Trait Implementations

impl Drop for GpuMonitor

fn drop(&mut self)

Executes the destructor for this type.