B4J Library B4J - Oshi Monitor (CPU & RAM Usage)

Hello everyone,
This is a library I use all the time. My own personal monitoring app is built on it, and it lets me keep an eye on individual running processes and their resources with ease. I personally use this application to monitor CPU and RAM resources for the processes of large bespoke applications that I've developed for clients. I used to rely on another excellent B4J library, but unlike that one, this library does not require administrator privileges.

Oshi Monitor is a lightweight B4J library built on top of the OSHI hardware‑inspection framework. It gives your B4J apps real‑time access to system metrics such as CPU load, RAM usage, CPU temperature (where applicable), and per‑process resource consumption. The library runs its own background thread, raises regular update events, and includes optional smoothing, maximum value tracking, and multi-process aggregation (useful for apps like Chrome).

You can monitor the whole system or target a specific process by name, with events for CPU, RAM, temperature (where applicable), and process appearance or termination. It also exposes helper methods for listing running processes and retrieving total memory information.

This library is ideal for dashboards, diagnostics tools, performance monitors, or any B4J app that needs live system statistics with minimal overhead.

B4J library tab:

PLEASE NOTE:
To run the attached example, you will NEED to download and install Erel's jGuages library from HERE...

Monitoring all (idle) system resource usage:

Monitoring chrome 3 x 4K tabs resource usage:

Monitoring its own resources usage:

Monitoring B4J resources usage:

Selecting a currently running process:

SS_OshiMonitor

Author: Peter Simpson
Version: 1.0

• OshiMonitor
  OshiMonitor library for B4J.
  Uses the OSHI library to monitor CPU, RAM, and Temperature.
  • Events:
    • CpuTemp (Value As Double)
    • CpuUsage (Value As Double)
    • ProcessCpuUsage (Value As Double)
    • ProcessFound (Name As String)
    • ProcessRamUsage (Value As Double)
    • ProcessRamUsageMB (Value As Double)
    • ProcessTerminated (Name As String)
    • RamUsage (Value As Double)
    • RamUsageMB (Value As Double)
    • Updated (Stats As Map)
  • Fields:
    • Debug As Boolean
      Enables diagnostic logging.
      When true internal debug messages are written to the B4J log.
  • Functions:
    • hasCpuTemp As Boolean
      Returns true if CPU temperature monitoring is supported.
    • Initialize (EventName As String)
      Initializes the monitor and prepares OSHI hardware access.
    • IsInitialized As Boolean
      Returns true if the object has been initialized and not yet killed.
    • Kill
      Kills the ba object reference to free memory and stops the thread cleanly.
      After calling this, IsInitialized will return false.
    • ListProcesses As List
      Returns a List of unique running process names, sorted A–Z.
    • ResetMaximums
      Resets the tracked maximum CPU and RAM values for the system to zero.
    • ResetProcessMaximums
      Resets the tracked maximum CPU and RAM values for the target process to zero.
    • Start
      Starts the background monitoring thread.
      Raises Updated, CpuUsage, CpuTemp and RamUsage events at the configured interval.
    • Stop
      Stops the monitoring thread.
      The object remains initialized and can be restarted with Start.
  • Properties:
    • CpuTemp As Double [read only]
      Returns CPU temperature in °C.
    • CpuUsage As Double [read only]
      Returns CPU usage as a percentage.
    • IntervalMs As Int [write only]
      Sets the update interval in milliseconds.
      Values lower than 100ms are clamped to 100ms.
    • MaxCpuUsage As Double [read only]
      Returns the highest CPU usage recorded since start or reset.
    • MaxProcessCpuUsage As Double [read only]
      Returns the highest Process CPU usage recorded since the process was targeted or reset.
    • MaxProcessRamUsage As Double [read only]
      Returns the highest Process RAM usage percentage recorded.
    • MaxProcessRamUsageMB As Double [read only]
      Returns the highest Process RAM usage in megabytes recorded.
    • MaxRamUsage As Double [read only]
      Returns the highest RAM usage percentage recorded since start or reset.
    • MaxRamUsageMB As Double [read only]
      Returns the highest RAM usage in megabytes recorded since start or reset.
    • ProcessCpuUsage As Double [read only]
      Returns CPU usage for the configured target process as a percentage.
    • ProcessRamUsage As Double [read only]
      Returns RAM usage for the configured target process as a percentage of total system RAM.
    • ProcessRamUsageMB As Double [read only]
      Returns RAM usage for the configured target process in megabytes.
    • RamTotal As Long [read only]
      Returns total physical memory in bytes.
    • RamTotalGB As Double [read only]
      Returns total physical memory in gigabytes.
    • RamTotalMB As Double [read only]
      Returns total physical memory in megabytes.
    • RamUsage As Double [read only]
      Returns RAM usage as a percentage.
    • RamUsageMB As Double [read only]
      Returns used RAM in megabytes.
    • TargetProcessName As String
      Returns the current target process name.
      Returns an empty string if no process is configured.

PLEASE NOTE:
TO RUN THE ATTACHED EXAMPLE, YOU NEED TO DOWNLOAD THE THIRD-PARTY JAVA DEPENDENCIES LINKED BELOW, AS WELL AS USING THE ATTACHED POST LIBRARY.
CLICK HERE - Download Extra Libraries <<<<<<<<<<<<<<<<<<<<<<<<


Enjoy...