# What System Metrics Are Collected by Vorssaint-Utils: Technical Breakdown

> Explore system metrics collected by Vorssaint-Utils, including CPU, GPU, memory, and battery. Discover real-time macOS data with zero off-device telemetry.

- Repository: [vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils)
- Tags: deep-dive
- Published: 2026-09-09

---

**Vorssaint-Utils collects eight categories of real‑time system metrics—including CPU, GPU, memory, temperature, battery, network, and fan data—using native macOS APIs with zero off‑device telemetry.**

Vorssaint-Utils is a macOS system utility that powers its System Monitor through comprehensive local data collection. The vorssaint/vorssaint-utils repository implements the system metrics collected by Vorssaint-Utils via Swift modules that interface directly with **IOKit**, **HostStatistics**, and **ProcessInfo** on Apple Silicon devices running macOS 14+. All processing remains on‑device to ensure user privacy while providing real‑time visualization.

## Hardware Performance Metrics

The core hardware monitoring capabilities track processor utilization and thermal states through dedicated provider classes in the `VorssaintCore` module.

### CPU and GPU Utilization

In [`Sources/VorssaintCore/SystemInfo.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/SystemInfo.swift), the `SystemInfo` class aggregates real‑time processor metrics. The implementation exposes current CPU usage as a percentage value and captures GPU utilization when hardware sensors are available.

Access these metrics through the shared instance:

```swift
import VorssaintCore

let cpuUsage = SystemInfo.shared.cpuUsage          // Float (0‑100 %)
let memoryInfo = SystemInfo.shared.memoryInfo      // (used: UInt64, total: UInt64)

print("CPU \(cpuUsage)% – Memory \(memoryInfo.used)/\(memoryInfo.total) bytes")

```

### Thermal Monitoring

The same `SystemInfo` provider reads CPU temperature, GPU temperature (where exposed by the hardware), and other system sensor values through IOKit interfaces. These readings enable the System Monitor to display thermal throttling risks before performance degradation occurs.

## Power and Battery Analytics

Battery metrics are isolated in a dedicated provider to handle the complexity of modern power management circuits.

### Battery Health and Cycle Tracking

[`Sources/VorssaintCore/BatteryInfo.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/BatteryInfo.swift) implements the `BatteryInfo` class, which queries charge level, health status, time remaining, cycle count, power draw, and temperature. These metrics expose long‑term battery degradation patterns alongside real‑time power consumption.

Retrieve battery statistics using:

```swift
let battery = BatteryInfo.shared
print("Charge:", battery.chargePercent, "%")
print("Health:", battery.healthStatus)
print("Temperature:", battery.temperatureCelsius, "°C")

```

## Memory and Process Management

Vorssaint-Utils distinguishes between system‑wide memory pressure and per‑application consumption patterns.

### System Memory Tracking

The `SystemInfo.shared.memoryInfo` interface returns total memory in use, swap utilization, and memory pressure levels through HostStatistics API calls. This data identifies physical RAM saturation before the system invokes aggressive swap compression.

### Process Energy Consumption

The utility maintains a live list of applications currently consuming significant energy, sourced from ProcessInfo queries. Users can trigger shortcuts to macOS’s full process inspector directly from this list to terminate runaway processes.

## Network Performance Monitoring

[`Sources/VorssaintCore/NetworkMonitor.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/NetworkMonitor.swift) implements the `NetworkMonitor` class to track live upload and download rates, session totals, and built‑in speed test capabilities. The implementation uses network interface counters to calculate throughput without requiring elevated privileges.

Monitor network activity programmatically:

```swift
let net = NetworkMonitor.shared
print("Down:", net.currentDownloadRate, "KB/s")
print("Up:",   net.currentUploadRate,   "KB/s")

```

## Fan Control and Custom Curves (Beta)

[`Sources/VorssaintCore/FanControl.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/FanControl.swift) provides optional manual control over cooling systems on supported hardware. The implementation reads current fan speeds in RPM and allows custom temperature curves or manual speed overrides when the beta feature is enabled.

## Alert System and Thresholds

[`Sources/VorssaintCore/Alerts.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/Alerts.swift) implements proactive monitoring that triggers user‑visible notifications based on configurable thresholds:

- **CPU load spikes** exceeding sustained utilization limits
- **High temperature warnings** for CPU or battery components
- **Memory pressure warnings** indicating imminent swap thrashing
- **Low disk space warnings** for system volume capacity
- **Low battery warnings** at user‑defined charge percentages

These alerts are generated locally without network dependencies, ensuring immediate notification even in offline environments.

## Core Implementation Files

According to the vorssaint/vorssaint-utils source code, the metric collection architecture is partitioned across five primary files:

- **[`Sources/VorssaintCore/SystemInfo.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/SystemInfo.swift)** – Central provider aggregating CPU, GPU, memory, and temperature data from IOKit and HostStatistics.
- **[`Sources/VorssaintCore/BatteryInfo.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/BatteryInfo.swift)** – Battery‑specific queries including charge cycles, health algorithms, and thermal readings.
- **[`Sources/VorssaintCore/NetworkMonitor.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/NetworkMonitor.swift)** – Real‑time traffic accounting and speed test orchestration.
- **[`Sources/VorssaintCore/FanControl.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/FanControl.swift)** – Hardware fan RPM monitoring and manual control interfaces (beta).
- **[`Sources/VorssaintCore/Alerts.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/Alerts.swift)** – Threshold evaluation engine generating user notifications.

## Summary

- Vorssaint-Utils collects **eight distinct metric categories**: CPU/GPU utilization, memory pressure, thermal sensors, battery health, network throughput, fan speeds, process energy, and alert conditions.
- All data is sourced via **native macOS APIs** (IOKit, HostStatistics, ProcessInfo) on macOS 14+ Apple Silicon systems.
- The implementation uses **five core Swift files** in the `VorssaintCore` module to aggregate and expose system state.
- **Zero telemetry** is transmitted off‑device; metrics remain local for on‑screen visualization and user‑triggered actions.
- **Programmatic access** is available through shared singleton interfaces like `SystemInfo.shared`, `BatteryInfo.shared`, and `NetworkMonitor.shared`.

## Frequently Asked Questions

### Does Vorssaint-Utils send system metrics to external servers?

No. According to the vorssaint/vorssaint-utils source code, all system metrics collected by Vorssaint-Utils are processed locally using native macOS APIs. The architecture explicitly avoids network transmission to preserve user privacy, functioning entirely on‑device for visualization and alerting purposes.

### Which macOS versions support all metric categories?

The complete metric suite requires **macOS 14 or later** running on **Apple Silicon** hardware. Earlier versions or Intel‑based Macs may lack access to specific GPU temperature sensors, battery health details, or fan control capabilities exposed through modern IOKit interfaces.

### How does the fan control feature work?

The optional beta feature implemented in [`Sources/VorssaintCore/FanControl.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/VorssaintCore/FanControl.swift) reads current RPM values from hardware tachometers and allows manual speed overrides or custom temperature curves. This requires direct IOKit communication with the System Management Controller (SMC) on supported devices.

### Can developers access these metrics programmatically?

Yes. The repository exposes public Swift interfaces through the `VorssaintCore` module, providing singleton instances like `SystemInfo.shared` and `BatteryInfo.shared` with properties for usage percentages, memory statistics, and thermal readings suitable for integration into third‑party macOS applications.