Skip to main content

Crate ironmonitor

Crate ironmonitor 

Source
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 TUI
  • full - All features enabled

§Platform Support

PlatformCPUMemoryDiskGPU (NVIDIA)GPU (AMD)GPU (Intel)NetworkProcesses
Linux✅✅✅✅✅✅✅✅
Windows✅✅✅✅🚧🚧🚧🚧
macOS✅✅✅❌❌❌🚧🚧

§Examples

See the examples/ directory for comprehensive examples:

  • gpu_monitor.rs - Multi-vendor GPU monitoring
  • process_monitor.rs - Process tracking with GPU attribution
  • network_monitor.rs - Network interface statistics
  • tui.rs - Interactive terminal UI
  • all_gpus.rs - Unified multi-vendor GPU example
  • ai_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::grab_banner;
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::parallel_scan_with_banners;
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::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::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§

UnifiedMonitor
Main entry point for unified silicon monitoring.

Constants§

VERSION
Library version

Type Aliases§

GpuInterfaceDeprecated