jmx-dev RFR: 8335625: Update Javadoc for GetCpuLoad

Joakim Nordström jnordstrom at openjdk.org
Wed Aug 21 10:37:12 UTC 2024


Can I get a review of this documentation update to clarify the usage of GetCpuLoad (and inherently deprecated GetSystemCpuLoad) and GetProcessCpuLoad.

Calling either of these methods in quick succession can lead to unrepresentative results due to too few data points.

This behavior is easy to reproduce on at least Linux (Windows implementation enforces a 500 ticks duration); when calling GetCpuLoad repeatedly CPU load values of either 0, 0.5, or 1 will be returned.

double cpuLoad1 = getCpuLoad();
double cpuLoad2 = getCpuLoad();   // not enough ticks has passed to give representative values

Worth noting is that this holds true even if getSystemCpuLoad() is called. 

double cpuLoad1 = getCpuLoad();
double cpuLoad2 = getSystemCpuLoad();   // not enough ticks has passed to give representative values, since getSystemCpuLoad effectively calls getCpuLoad.

-------------

Commit messages:
 - 8335625: Update Javadoc for GetCpuLoad
 - 8335625: Update Javadoc for GetCpuLoad

Changes: https://git.openjdk.org/jdk/pull/20546/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=20546&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8335625
  Stats: 14 lines in 1 file changed: 14 ins; 0 del; 0 mod
  Patch: https://git.openjdk.org/jdk/pull/20546.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/20546/head:pull/20546

PR: https://git.openjdk.org/jdk/pull/20546


More information about the jmx-dev mailing list