oshi/oshi
Oshi
OSHI is a Java system information library and cross-platform hardware monitor used to extract real-time performance data and specifications from processors, memory, disks, network interfaces, and system firmware. It serves as an operating system metadata provider, querying system boot times, uptime, and detailed version information across various desktop and server distributions.
The library integrates with observability pipelines by exporting system and process metrics to external monitoring backends using the Micrometer standard. It also supports connecting to vendor libraries to extract advanced graphics processing unit metrics from supported hardware.
Its capabilities cover hardware inventory management, operating system introspection, and system resource analysis. This includes tracking processor topology and load, monitoring global and virtual memory statistics, analyzing disk partitions and logical volumes, and inspecting active process details such as thread IDs and memory footprints. It further provides network statistics tracking for interface status, subnet masks, and active connection lists.
Features
- Hardware Monitoring Tools - Extracts real-time performance telemetry and specifications from physical hardware components across multiple operating systems.
- System Monitoring Platforms - Collects real-time hardware and operating system metrics across multiple platforms to monitor system performance.
- Operating System Introspection - Fetches software versions, boot times, and kernel metadata to verify the host environment.
- Processor Metrics Collection - Provides detailed collection of CPU usage, load averages, cache information, and hybrid processor topology.
- Java Utility Libraries - Provides a general-purpose Java utility library for retrieving hardware and operating system metrics across platforms.
- Native Access Libraries - Uses JNA to map Java interfaces to native C libraries for accessing operating system APIs.
- Hardware Abstraction Layers - Provides a consistent API for hardware data retrieval across different operating system implementations.
- Provider Patterns - Implements platform-independent interfaces through specialized provider classes for Windows, Linux, and macOS.
- Pseudo-Filesystem Parsing - Extracts hardware and kernel metrics by parsing structured text files from procfs and sysfs directories.
- Memory Performance Monitors - Retrieves global and virtual memory statistics, physical memory serial numbers, and node assignments.
- Cross-Platform Monitors - Collects system data for processors, memory, disks, and network interfaces across multiple operating systems.
- Hardware Asset Auditing - Retrieves detailed specifications and unique identifiers for processors, GPUs, and network interfaces to audit system assets.
- System Metrics Collection - Provides comprehensive gathering of native system-level performance metrics including CPU, memory, disk, and network statistics.
- Network Statistics Tracking - Collects network interface status, subnet masks, dropped packets, and active connection lists.
- Process State Inspection - Retrieves and analyzes the current status, memory footprints, and CPU usage of active processes.
- Resource Usage Troubleshooting - Inspects active processes, thread usage, and memory footprints to diagnose resource consumption bottlenecks.
- Device and Hardware Identification - Looks up hardware identifiers to determine specific processor microarchitectures and unique system IDs.
- Hardware Enumeration - Lists connected bluetooth peripherals, printers, battery statistics, and firmware information.
- Storage Layout Analysis - Identifies disk types, hardware identifiers, logical volume groups, and partition details.
- OS Metadata Providers - Queries system boot times, uptime, and detailed version information across various desktop and server distributions.
- Global Metric Registries - Binds hardware snapshots to external monitoring registries using standardized semantic conventions for observability.
- System Environment Retrievers - Fetches static system environment metadata including boot time, uptime, and operating system versions.
- Metrics Exporters - Exposes system performance data using the Micrometer standard for external monitoring and analysis.
- Observability Pipelines - Exports raw system and hardware metrics to external monitoring backends using the Micrometer framework.
- GPU Performance Monitoring - Extracts graphics card specifications and real-time performance metrics.
- System Observability - Integrates system and process metrics into observability pipelines for performance diagnosis.
- OS and Hardware Data Queries - Retrieves detailed software versions and configurations for various desktop and server distributions.
