Expand description
§IronMonitor (ironmon)
A comprehensive, cross-platform Rust library for hardware monitoring. IronMonitor provides a unified API for monitoring CPUs, GPUs (NVIDIA/AMD/Intel), memory, disks, motherboards, processes, and network interfaces across Windows, Linux, and macOS.
§Features
- Multi-Vendor GPU Support: NVIDIA (NVML), AMD (sysfs), Intel (i915/xe)
- Process Monitoring: System-wide process tracking with GPU attribution
- Network Monitoring: Interface statistics with bandwidth rate calculation
- Cross-Platform: Unified API across Windows, Linux, and macOS
- Zero-Cost Abstractions: Built in Rust for maximum performance and safety
- Terminal UI: Beautiful TUI for real-time monitoring
§Quick Start
§GPU Monitoring
use ironmonitor::gpu::GpuCollection;
// Auto-detect all available GPUs
let gpus = GpuCollection::auto_detect()?;
// Get snapshot of all GPUs
for (idx, info) in gpus.snapshot_all()?.iter().enumerate() {
println!("GPU {}: {} ({})",
idx,
info.static_info.name,
info.static_info.vendor
);
if let Some(util) = info.dynamic_info.utilization {
println!(" Utilization: {}%", util);
}
// `None` where the device reported no figure, which is why these are
// `Option` -- an adapter with no readable memory is not one with none.
if let (Some(used), Some(total)) =
(info.dynamic_info.memory.used, info.dynamic_info.memory.total)
{
println!(" Memory: {} / {} MB", used / 1024 / 1024, total / 1024 / 1024);
}
if let Some(temp) = info.dynamic_info.thermal.temperature {
println!(" Temperature: {}°C", temp);
}
if let Some(power) = info.dynamic_info.power.draw {
println!(" Power: {:.1}W", power as f32 / 1000.0);
}
}§Process Monitoring with GPU Attribution
use ironmonitor::{ProcessMonitor, GpuCollection};
let gpus = GpuCollection::auto_detect()?;
let mut monitor = ProcessMonitor::with_gpus(gpus)?;
// Get processes sorted by GPU memory usage
let gpu_procs = monitor.processes_by_gpu_memory()?;
for proc in gpu_procs.iter().take(10) {
println!("{} (PID {}): {} MB GPU memory",
proc.name,
proc.pid,
proc.gpu_memory_mb()
.map_or_else(|| "n/a".to_string(), |mb| format!("{mb:.0}"))
);
}§Network Monitoring
use ironmonitor::NetworkMonitor;
let mut monitor = NetworkMonitor::new()?;
// Get all active interfaces
for iface in monitor.active_interfaces()? {
// `None` on the first call for an interface: a rate is a difference
// between two samples, and this is the first.
if let Some((rx_rate, tx_rate)) = monitor.bandwidth_rate(&iface.name, &iface) {
println!("{}: ↓{:.2} MB/s ↑{:.2} MB/s",
iface.name,
rx_rate / 1_000_000.0,
tx_rate / 1_000_000.0
);
}
}§AI Data API - Tool-Based System Access
The AI Data API provides a comprehensive tool-based interface for AI systems to query hardware monitoring data:
use ironmonitor::ai_api::{AiDataApi, ToolCategory};
let mut api = AiDataApi::new()?;
// List available tools (35+ tools across 8 categories)
for tool in api.list_tools_by_category(ToolCategory::Gpu) {
println!("{}: {}", tool.name, tool.description);
}
// Call a tool
let result = api.call_tool("get_gpu_status", serde_json::json!({}))?;
if result.success {
println!("{}", serde_json::to_string_pretty(&result.data)?);
}
// Get tools in OpenAI function calling format
let openai_tools = api.tools_as_openai_functions();
// Get tools in Anthropic tools format
let anthropic_tools = api.tools_as_anthropic_tools();§Feature Flags
nvidia- NVIDIA GPU support via NVML (requires CUDA toolkit or NVIDIA driver)amd- AMD GPU support via sysfs/DRM (Linux only, requires amdgpu driver)intel- Intel GPU support via i915/xe drivers (Linux only)cli- Command-line interface and TUIfull- All features enabled
§Platform Support
| Platform | CPU | Memory | Disk | GPU (NVIDIA) | GPU (AMD) | GPU (Intel) | Network | Processes |
|---|---|---|---|---|---|---|---|---|
| Linux | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Windows | ✅ | ✅ | ✅ | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
| macOS | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | 🚧 | 🚧 |
§Examples
See the examples/ directory for comprehensive examples:
gpu_monitor.rs- Multi-vendor GPU monitoringprocess_monitor.rs- Process tracking with GPU attributionnetwork_monitor.rs- Network interface statisticstui.rs- Interactive terminal UIall_gpus.rs- Unified multi-vendor GPU exampleai_api_demo.rs- AI Data API demonstration with tool-based system access
Re-exports§
pub use tui::AcceleratorInfo;pub use tui::AcceleratorType;pub use audio::AudioDevice;pub use audio::AudioDeviceType;pub use audio::AudioMonitor;pub use audio::AudioState;pub use bluetooth::BluetoothAdapter;pub use bluetooth::BluetoothDevice;pub use bluetooth::BluetoothDeviceType;pub use bluetooth::BluetoothEvent;pub use bluetooth::BluetoothMonitor;pub use bluetooth::BluetoothState;pub use display::DisplayConnection;pub use display::DisplayInfo;pub use display::DisplayMonitor;pub use display::HdrMode;pub use usb::UsbDevice;pub use usb::UsbDeviceClass;pub use usb::UsbEvent;pub use usb::UsbMonitor;pub use usb::UsbSpeed;pub use core::cpu::CpuStats;pub use core::engine::EngineInfo;pub use core::engine::EngineStats;pub use core::fan::FanStats;pub use core::gpu::GpuInfo as CoreGpuInfo;pub use core::gpu::GpuStats;pub use core::gpu::GpuType;pub use core::memory::MemoryStats;pub use core::power::PowerStats;pub use core::process::ProcessInfo;pub use core::process::ProcessStats;pub use core::temperature::TemperatureStats;pub use error::Error;pub use error::IronError;pub use error::Result;pub use stats::IronMonitor;pub use stats::Snapshot;pub use gpu::Gpu;pub use gpu::GpuClocks;pub use gpu::GpuCollection;pub use gpu::GpuDynamicInfo;pub use gpu::GpuEngines;pub use gpu::GpuInfo;pub use gpu::GpuMemory;pub use gpu::GpuPower;pub use gpu::GpuProcess as LegacyGpuProcess;pub use gpu::GpuProcessType;pub use gpu::GpuStaticInfo;pub use gpu::GpuThermal;pub use gpu::GpuVendor;pub use gpu::PcieLinkInfo;pub use gpu::traits;pub use gpu::Clocks;pub use gpu::Device;pub use gpu::Memory;pub use gpu::Power;pub use gpu::Temperature;pub use gpu::Utilization;pub use gpu::Vendor;pub use process_monitor::CategoryStats;pub use process_monitor::ProcessCategory;pub use process_monitor::ProcessGpuType;pub use process_monitor::ProcessMonitor;pub use process_monitor::ProcessMonitorInfo;pub use network_monitor::NetworkInterfaceInfo;pub use network_monitor::NetworkMonitor;pub use connections::ConnectionInfo;pub use connections::ConnectionMonitor;pub use connections::ConnectionState;pub use connections::Protocol;pub use ai_workload::AiFramework;pub use ai_workload::AiWorkload;pub use ai_workload::AiWorkloadMonitor;pub use ai_workload::CloudProvider;pub use ai_workload::DistributedConfig;pub use ai_workload::InferenceMetrics;pub use ai_workload::TpuConfig;pub use ai_workload::TrainingMetrics;pub use ai_workload::WorkloadType;pub use ai_api::AiDataApi;pub use ai_api::ToolCall;pub use ai_api::ToolCategory;pub use ai_api::ToolDefinition;pub use ai_api::ToolResult;pub use observability::ApiConfig;pub use observability::ApiKey;pub use observability::ApiResponse;pub use observability::Capability;pub use observability::EventCategory;pub use observability::EventFilter;pub use observability::EventManager;pub use observability::EventSeverity;pub use observability::HardwareContext;pub use observability::HttpRequest;pub use observability::HttpResponse;pub use observability::MetricCollector;pub use observability::MetricSnapshot;pub use observability::MetricStats;pub use observability::MetricValue;pub use observability::MinimalContext;pub use observability::ObservabilityApi;pub use observability::ObservabilityError;pub use observability::OpenApiSpec;pub use observability::Permission;pub use observability::PermissionChecker;pub use observability::RequestContext;pub use observability::RequestHandler;pub use observability::ResponseMeta;pub use observability::Scope;pub use observability::ServerConfig;pub use observability::SoftwareContext;pub use observability::StreamChannel;pub use observability::StreamManager;pub use observability::StreamMessage;pub use observability::Subscription;pub use observability::SystemContext;pub use observability::SystemContextBuilder;pub use observability::SystemEvent;pub use agent::Agent;pub use agent::AgentConfig;pub use agent::AgentResponse;pub use agent::ModelSize;pub use agent::Query;pub use agent::QueryType;pub use agent::SystemState;pub use config::ChartConfig;pub use config::Config;pub use config::GeneralConfig;pub use config::GpuConfig;pub use config::ProcessConfig;pub use consent::is_offline_mode;pub use consent::is_telemetry_disabled;pub use consent::ConsentConfig;pub use consent::ConsentManager;pub use consent::ConsentRecord;pub use consent::ConsentScope;pub use sandbox::SandboxDetector;pub use sandbox::SandboxInfo;pub use system_stats::CpuTime;pub use system_stats::LoadAverage;pub use system_stats::SystemStats;pub use system_stats::VmStats;pub use network_tools::capture_dns;pub use network_tools::capture_http;pub use network_tools::capture_packets;pub use network_tools::capture_tcp;pub use network_tools::check_connectivity;pub use network_tools::check_port;pub use network_tools::common_ports;pub use network_tools::dns_lookup;pub use network_tools::full_scan;pub use network_tools::get_service_name;pub use network_tools::is_capture_available;pub use network_tools::latency_test;pub use network_tools::list_capture_interfaces;pub use network_tools::nmap_scan;pub use network_tools::parallel_scan;pub use network_tools::ping;pub use network_tools::quick_capture;pub use network_tools::quick_scan;pub use network_tools::reverse_dns;pub use network_tools::scan_port_range;pub use network_tools::scan_ports;pub use network_tools::scan_ports_with_timeout;pub use network_tools::traceroute;pub use network_tools::CaptureConfig;pub use network_tools::CaptureProtocol;pub use network_tools::CaptureResult;pub use network_tools::CapturedPacket;pub use network_tools::NetworkTools;pub use network_tools::NmapScanResult;pub use network_tools::OsFingerprint;pub use network_tools::PingResult;pub use network_tools::PortScanResult;pub use network_tools::PortStatus;pub use network_tools::ServiceInfo;pub use network_tools::TracerouteHop;pub use network_tools::TracerouteResult;pub use profile::active::active_profiles_for_processes;pub use profile::active::matched_active_profiles;pub use profile::active::ActiveAppProfile;pub use profile::apply::apply_setting;pub use profile::apply::writable_setting_ids;pub use profile::apply::ApplyOutcome;pub use profile::apply::ApplyStatus;pub use profile::cache::CachedProfileInspector;pub use profile::cache::CACHE_STATS as PROFILE_CACHE_STATS;pub use profile::deviation::deviations_from_default;pub use profile::deviation::Deviation;pub use profile::diff::diff_snapshots;pub use profile::diff::DiffChange;pub use profile::diff::DiffEntry;pub use profile::diff::DiffGroup;pub use profile::diff::ProfileDiff;pub use profile::explain::candidates as explain_candidates;pub use profile::explain::explain;pub use profile::explain::SettingExplanation;pub use profile::ProfileGroup;pub use profile::ProfileInspector;pub use profile::ProfileProvider;pub use profile::ProfileSnapshot;pub use profile::Setting;pub use profile::SettingRisk;pub use profile::SettingValue;pub use profile::Subsystem as ProfileSubsystem;pub use power_supply::battery_percent;pub use power_supply::is_on_ac_power;pub use power_supply::is_on_battery;pub use power_supply::power_summary;pub use power_supply::BatteryHealth;pub use power_supply::ChargingStatus;pub use power_supply::PowerSupplyInfo;pub use power_supply::PowerSupplyMonitor;pub use power_supply::PowerSupplyType;pub use health::has_critical_issues;pub use health::health_score;pub use health::quick_health_check;pub use health::HealthCheck;pub use health::HealthStatus;pub use health::HealthThresholds;pub use health::SystemHealth;pub use bandwidth::bandwidth_test;pub use bandwidth::loopback_test;pub use bandwidth::memory_bandwidth_test;pub use bandwidth::quick_bandwidth_estimate;pub use bandwidth::BandwidthConfig;pub use bandwidth::BandwidthResult;pub use bandwidth::MemoryBandwidthResult;pub use bandwidth::DEFAULT_BUFFER_SIZE;pub use bandwidth::DEFAULT_PORT;pub use fan_control::fan_summary;pub use fan_control::list_fans;pub use fan_control::list_thermal_zones;pub use fan_control::FanControlMode;pub use fan_control::FanCurve;pub use fan_control::FanCurvePoint;pub use fan_control::FanInfo;pub use fan_control::FanMonitor;pub use fan_control::FanProfile;pub use fan_control::FanSummary;pub use fan_control::FanType;pub use fan_control::ThermalZone;pub use fan_control::TripPoint;pub use cpufreq::available_governors;pub use cpufreq::cpufreq_summary;pub use cpufreq::list_cpus;pub use cpufreq::CpuFreqInfo;pub use cpufreq::CpuFreqMonitor;pub use cpufreq::CpuFreqPolicy;pub use cpufreq::CpuFreqSummary;pub use cpufreq::CpuIdleState;pub use cpufreq::EnergyPreference;pub use cpufreq::Governor;pub use cpufreq::TurboStatus;pub use services::common_services;pub use services::get_services_status;pub use services::is_service_running;pub use services::service_summary;pub use services::ServiceInfo as SystemServiceInfo;pub use services::ServiceMonitor;pub use services::ServiceStatus;pub use services::ServiceSummary;pub use services::ServiceType;pub use services::StartupType;pub use memory_management::format_bytes;pub use memory_management::memory_summary;pub use memory_management::MemoryInfo;pub use memory_management::MemoryMonitor;pub use memory_management::MemoryPressure;pub use memory_management::MemorySummary;pub use memory_management::ProcessMemory;pub use memory_management::SwapDevice;pub use memory_management::SwapInfo;pub use memory_management::SwapType;pub use memory_management::ZramInfo;pub use anomaly::Anomaly;pub use anomaly::AnomalyConfig;pub use anomaly::AnomalyDetector;pub use anomaly::AnomalyReport;pub use anomaly::AnomalySeverity;pub use anomaly::AnomalySummary;pub use anomaly::CheckGap;pub use anomaly::NotChecked;pub use anomaly::Recommendation;pub use process_tree::CgroupAttribution;pub use process_tree::ContainerRuntime;pub use process_tree::ProcessNode;pub use process_tree::ProcessTree;pub use process_tree::ProcessTreeSummary;pub use boot_config::boot_summary;pub use boot_config::format_uptime;pub use boot_config::BootInfo;pub use boot_config::BootMonitor;pub use boot_config::BootSummary;pub use boot_config::BootTime;pub use boot_config::BootType;pub use boot_config::KernelParams;pub use boot_config::StartupItem;pub use boot_config::StartupItemStatus;pub use boot_config::StartupItemType;pub use backend::AcceleratorState;pub use backend::BackendConfig;pub use backend::CpuState;pub use backend::DiskState;pub use backend::FullSystemState;pub use backend::HistoryBuffer;pub use backend::MemoryState;pub use backend::MonitoringBackend;pub use backend::NetworkState;pub use backend::ProcessState;pub use backend::SystemInfoState;pub use backend::DEFAULT_HISTORY_SIZE;pub use backend::DEFAULT_UPDATE_INTERVAL;pub use tsdb::format_size;pub use tsdb::parse_size;pub use tsdb::DatabaseStats;pub use tsdb::MetricSample;pub use tsdb::MetricsRecorder;pub use tsdb::ProcessSnapshot;pub use tsdb::SystemSnapshot;pub use tsdb::TimeSeriesDb;pub use datacenter::ChassisInfo;pub use datacenter::ChassisType;pub use datacenter::DatacenterError;pub use datacenter::DatacenterMonitor;pub use datacenter::DatacenterSnapshot;pub use datacenter::FormFactor;pub use datacenter::IpmiController;pub use datacenter::IpmiSensor;pub use datacenter::RackInfo;pub use virtualization::ContainerEngine;pub use virtualization::ContainerInfo;pub use virtualization::CpuVirtCapability;pub use virtualization::GuestResources;pub use virtualization::Hypervisor;pub use virtualization::HypervisorInfo;pub use virtualization::VirtMonitor;pub use virtualization::VirtPlatform;pub use virtualization::VirtSnapshot;pub use fleet::AlertCategory;pub use fleet::AlertSeverity;pub use fleet::FleetAlert;pub use fleet::FleetConfig;pub use fleet::FleetManager;pub use fleet::FleetSnapshot;pub use fleet::FleetThresholds;pub use fleet::HostInfo;pub use fleet::HostMetrics;pub use fleet::HostStatus;pub use fleet::HostSummary;pub use daemon::DaemonConfig;pub use daemon::DaemonError;pub use daemon::MonitoringDaemon;pub use camera::CameraCapability;pub use camera::CameraConnection;pub use camera::CameraInfo;pub use camera::CameraMonitor;pub use cpu_cache::CacheLevel;pub use cpu_cache::CacheType;pub use cpu_cache::CpuCacheInfo;pub use cpu_cache::CpuCacheMonitor;pub use cpu_cache::CpuCacheTopology;pub use input::InputDevice;pub use input::InputDeviceType;pub use input::InputInterface;pub use input::InputMonitor;pub use os_info::BootMode;pub use os_info::KernelModule;pub use os_info::OsFamily;pub use os_info::OsInfo;pub use os_info::OsInfoMonitor;pub use printer::PrinterConnection;pub use printer::PrinterInfo;pub use printer::PrinterMonitor;pub use printer::PrinterStatus;pub use printer::PrinterType;pub use storage_controller::NvmeControllerInfo;pub use storage_controller::RaidArrayInfo;pub use storage_controller::RaidLevel;pub use storage_controller::RaidStatus;pub use storage_controller::StorageControllerInfo;pub use storage_controller::StorageControllerMonitor;pub use storage_controller::StorageInterface;pub use tpm::TpmInfo;pub use tpm::TpmMonitor;pub use tpm::TpmStatus;pub use tpm::TpmVersion;pub use codec::BitDepth;pub use codec::CapabilitySource;pub use codec::CodecCapability;pub use codec::CodecDirection;pub use codec::CodecMonitor;pub use codec::ComputeCapability;pub use codec::MaxResolution;pub use codec::VideoCodec;pub use firmware::BootMode as FirmwareBootMode;pub use firmware::FirmwareComponent;pub use firmware::FirmwareEntry;pub use firmware::FirmwareInventory;pub use firmware::SecureBootStatus;pub use hardware_ai::AnomalySeverity as HwAnomalySeverity;pub use hardware_ai::Bottleneck;pub use hardware_ai::BottleneckType;pub use hardware_ai::HardwareAge;pub use hardware_ai::HardwareAnalysisReport;pub use hardware_ai::HardwareAnomaly;pub use hardware_ai::HardwareInferenceEngine;pub use hardware_ai::PerformanceTier;pub use hardware_ai::SystemClass;pub use hardware_ai::ThermalEnvelope;pub use hardware_ai::ThermalHeadroom;pub use hardware_ai::UpgradeRecommendation;pub use hardware_ai::Workload;pub use hardware_ai::WorkloadSuitability;pub use numa::NumaDistanceMatrix;pub use numa::NumaMonitor;pub use numa::NumaNode;pub use numa::NumaSummary;pub use pci_devices::PciClass;pub use pci_devices::PciDeviceInfo;pub use pci_devices::PciDeviceMonitor;pub use pci_devices::PciLinkInfo;pub use power_profile::ChargePolicy;pub use power_profile::CpuFreqConfig;pub use power_profile::CpuGovernor;pub use power_profile::InferredPowerBehavior;pub use power_profile::PowerPlanInfo;pub use power_profile::PowerProfile;pub use power_profile::PowerProfileMonitor;pub use sensors::SensorInfo;pub use sensors::SensorMonitor;pub use sensors::SensorType;pub use sensors::SensorValue;pub use smart::DiskHealth;pub use smart::DriveMediaType;pub use smart::SmartAttribute;pub use smart::SmartDiskInfo;pub use smart::SmartMonitor;pub use cgroup_monitor::CgroupCpu;pub use cgroup_monitor::CgroupInfo;pub use cgroup_monitor::CgroupMemory;pub use cgroup_monitor::CgroupMonitor;pub use cgroup_monitor::CgroupOverview;pub use cgroup_monitor::CgroupVersion;pub use cpu_microarch::CpuMicroarchMonitor;pub use cpu_microarch::CpuMicroarchReport;pub use cpu_microarch::CpuVendor as MicroarchVendor;pub use cpu_microarch::InferredPerformance;pub use cpu_microarch::IsaExtension;pub use cpu_microarch::Microarchitecture;pub use crypto_accel::CryptoAccelMonitor;pub use crypto_accel::CryptoAccelReport;pub use crypto_accel::CryptoCategory;pub use crypto_accel::CryptoFeature;pub use crypto_accel::HardwareRng;pub use crypto_accel::TpmCrypto;pub use drm_monitor::ConnectorStatus;pub use drm_monitor::ConnectorType;pub use drm_monitor::DrmClient;pub use drm_monitor::DrmConnector;pub use drm_monitor::DrmDevice;pub use drm_monitor::DrmMonitor;pub use drm_monitor::DrmOverview;pub use interconnect::ChipletTopology;pub use interconnect::CoherenceProtocol;pub use interconnect::InterconnectLink;pub use interconnect::InterconnectMonitor;pub use interconnect::InterconnectTopology;pub use interconnect::InterconnectType;pub use interrupt_map::InterruptAnalysis;pub use interrupt_map::InterruptInfo;pub use interrupt_map::InterruptMapMonitor;pub use interrupt_map::InterruptType;pub use memory_bandwidth::BandwidthAnalysis;pub use memory_bandwidth::BandwidthEstimate;pub use memory_bandwidth::ChannelConfig;pub use memory_bandwidth::MemoryBandwidthMonitor;pub use memory_bandwidth::MemoryGeneration;pub use memory_topology::DimmInfo;pub use memory_topology::FormFactor as DimmFormFactor;pub use memory_topology::MemoryAnalysis;pub use memory_topology::MemoryTopologyMonitor;pub use memory_topology::MemoryType as DimmMemoryType;pub use rapl::EnergyReading;pub use rapl::PowerDomain;pub use rapl::PowerEfficiency;pub use rapl::PowerSnapshot;pub use rapl::RaplMonitor;pub use security_mitigations::CpuVulnerability;pub use security_mitigations::KernelHardening;pub use security_mitigations::MitigationStatus;pub use security_mitigations::SecurityMitigationsMonitor;pub use security_mitigations::SecurityModule;pub use security_mitigations::SecurityPosture;pub use dma_engine::DmaCapabilities;pub use dma_engine::DmaChannel;pub use dma_engine::DmaController;pub use dma_engine::DmaEngineMonitor;pub use dma_engine::DmaEngineType;pub use dma_engine::DmaOverview;pub use edac::EdacCsRow;pub use edac::EdacMemType;pub use edac::EdacMemoryController;pub use edac::EdacMonitor;pub use edac::EdacOverview;pub use gpu_topology::GpuInterconnectType;pub use gpu_topology::GpuLink;pub use gpu_topology::GpuTopologyMonitor;pub use gpu_topology::GpuTopologyNode;pub use gpu_topology::GpuTopologyOverview;pub use io_scheduler::BlockDeviceIo;pub use io_scheduler::IoSchedulerMonitor;pub use io_scheduler::IoSchedulerOverview;pub use io_scheduler::IoSchedulerType;pub use io_scheduler::IoStats;pub use iommu::IommuDevice;pub use iommu::IommuGroup;pub use iommu::IommuMonitor;pub use iommu::IommuOverview;pub use iommu::IommuType;pub use kernel_params::KernelParam;pub use kernel_params::KernelParamsMonitor;pub use kernel_params::KernelParamsReport;pub use kernel_params::ParamCategory;pub use scheduler::CpuSchedStats;pub use scheduler::PressureInfo;pub use scheduler::SchedPolicy;pub use scheduler::SchedTuning;pub use scheduler::SchedulerAnalysis;pub use scheduler::SchedulerMonitor;pub use thermal_zone::CoolingDeviceInfo;pub use thermal_zone::ThermalZoneInfo;pub use thermal_zone::ThermalZoneMonitor;pub use thermal_zone::ThermalZoneOverview;pub use thermal_zone::ThermalZoneType;pub use thermal_zone::TripPoint as ThermalTripPoint;pub use thermal_zone::TripPointType;pub use voltage_regulator::RegulatorMode;pub use voltage_regulator::RegulatorState;pub use voltage_regulator::VoltageRegulatorInfo;pub use voltage_regulator::VoltageRegulatorMonitor;pub use voltage_regulator::VoltageRegulatorOverview;pub use watchdog::PreTimeoutGovernor;pub use watchdog::WatchdogInfo;pub use watchdog::WatchdogMonitor;pub use watchdog::WatchdogOverview;pub use watchdog::WatchdogType;
Modules§
- agent
- AI Agent for System Analysis and Predictions
- agents
- Agent activity: what local coding agents, workflows and inference requests did.
- ai_api
- AI Data API - Full System Visibility for AI Agents
- ai_
workload - AI Training and Inference Workload Monitoring
- anomaly
- Anomaly Detection and System Optimization
- audio
- Audio device monitoring module
- backend
- Unified monitoring backend for CLI, TUI, and GUI modes
- bandwidth
- Bandwidth Testing (iperf-style)
- battery
- Battery monitoring module
- bluetooth
- Bluetooth device monitoring module
- boot_
config - camera
- Camera and webcam device monitoring.
- cgroup_
monitor - Cgroup v1/v2 resource monitoring.
- codec
- Hardware codec and media capability detection — video encode/decode, GPU compute.
- config
- Configuration management for IronMonitor
- connections
- Network Connection Monitoring (netstat-like)
- consent
- User Consent Management
- core
- Core monitoring modules
- cpu_
cache - CPU cache topology detection — L1/L2/L3 sizes, line sizes, associativity.
- cpu_
microarch - CPU microarchitecture detection and feature inference.
- cpufreq
- CPU Frequency Scaling and Governor Control
- crypto_
accel - Cryptographic hardware acceleration detection and monitoring.
- daemon
- Monitoring daemon for headless/remote operation
- datacenter
- Datacenter infrastructure monitoring
- disk
- Disk Monitoring Module
- display
- Display/Monitor monitoring module
- dma_
engine - DMA engine monitoring.
- drm_
monitor - DRM (Direct Rendering Manager) / KMS (Kernel Mode Setting) subsystem monitor.
- edac
- Error Detection and Correction (EDAC) monitoring.
- error
- Error types for IronMonitor
- fan_
control - Advanced Fan Monitoring and Control
- fetch
- A neofetch-style summary: logo on the left, the machine on the right.
- firmware
- Firmware inventory — BIOS, UEFI, EC, ME, NIC firmware, storage firmware.
- fleet
- Fleet-level multi-host monitoring and aggregation
- gpu
- Unified GPU abstraction layer
- gpu_
topology - Multi-GPU topology and interconnect monitoring.
- gui
- IronMonitor GUI - Cyber-themed hardware monitoring dashboard
- hardware_
ai - Hardware AI inference engine — system classification, bottleneck detection, performance estimation, and workload suitability analysis.
- health
- System Health Scoring and Alerts
- http_
server - HTTP Server for IronMonitor REST API
- hwmon
- ids
- Intrusion detection over the network and the filesystem.
- inference
- Inference engines as the Inference tab sees them.
- input
- Input device monitoring — keyboards, mice, touchpads, game controllers, tablets.
- interconnect
- CPU interconnect topology monitoring.
- interrupt_
map - Interrupt topology and IRQ mapping monitor.
- io_
scheduler - Block I/O scheduler monitoring and analysis.
- iommu
- IOMMU (Input-Output Memory Management Unit) monitoring.
- kernel_
params - Kernel runtime parameters monitoring.
- legacy_
paths - Adoption of files left behind by the
simon→ IronMonitor rename. - memory_
bandwidth - Memory bandwidth monitoring and estimation.
- memory_
management - memory_
topology - Physical memory topology monitoring.
- motherboard
- net_
context - Where this machine sits on the network: each adapter’s addresses and driver, the default gateways and their link-layer addresses, the DNS servers, and the Wi-Fi connection – SSID, BSSID, radio, security, signal and rates.
- network_
monitor - Network Interface Monitoring
- network_
tools - Network Diagnostic Tools (nmap, traceroute, ping, tcpdump, netcat style)
- numa
- NUMA topology and memory affinity monitoring.
- observability
- Observability API - Full System Visibility with MCP-like Permissions
- ontology
- Machine-readable ontology over everything IronMonitor can report.
- os_info
- OS and kernel information — kernel version, hostname, boot time, loaded modules.
- pci_
devices - PCI device enumeration — all PCI/PCIe devices with class, vendor, driver info.
- pcie
- PCIe Bandwidth Monitoring
- pipeline
- Lock-free snapshot pipeline: decouples hardware collection from rendering.
- platform
- Platform-specific implementations
- power_
profile - Power profile and energy management monitoring.
- power_
supply - Power Supply and Battery Monitoring
- predictive
- Predictive Maintenance Alerts
- printer
- Printer and print queue monitoring — connected printers, status, drivers.
- process_
monitor - Unified Process Monitoring with GPU Attribution
- process_
tree - Process Tree Visualization and Container/Cgroup Awareness
- profile
- Hardware Profile Inspector — read-only inspection of vendor driver settings, application profiles, and tunable hardware parameters.
- prometheus
- Prometheus Metrics Exporter
- rapl
- Intel RAPL and AMD power capping energy monitoring.
- sandbox
- Sandbox Detection Module
- scheduler
- Linux process scheduler monitoring and tuning analysis.
- security_
mitigations - CPU vulnerability mitigations and kernel security monitoring.
- sensors
- Environmental sensor monitoring — accelerometer, gyroscope, light, proximity.
- services
- System Service Monitoring and Control
- silicon
- Unified silicon monitoring module
- smart
- S.M.A.R.T. disk health monitoring — drive health, temperature, wear, predictions.
- stats
- Main statistics collection and management
- storage_
controller - Storage controller monitoring — RAID arrays, HBAs, NVMe controllers.
- system_
stats - System-wide statistics (Linux/BSD style)
- thermal_
zone - Thermal zone monitoring.
- tpm
- Trusted Platform Module (TPM) monitoring.
- tsdb
- Time-Series Database (TSDB) for recording system metrics over time
- tui
- Terminal User Interface (TUI) for IronMonitor
- tuning
- Use-case detection and hardware profile recommendations.
- usb
- USB device monitoring module
- virtualization
- Virtualization and container detection and monitoring
- voltage_
regulator - Voltage regulator monitoring.
- watchdog
- Hardware and software watchdog timer monitoring.
- wsl
- WSL2 GPU Passthrough Detection
Structs§
- Unified
Monitor - Main entry point for unified silicon monitoring.
Constants§
- VERSION
- Library version
Type Aliases§
- GpuInterface
Deprecated