OperatingSystemMXBean Platform MBean: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 2: Line 2:


* http://docs.oracle.com/javase/8/docs/api/java/lang/management/OperatingSystemMXBean.html
* http://docs.oracle.com/javase/8/docs/api/java/lang/management/OperatingSystemMXBean.html
* System and Process CPU Load Monitoring from Java https://www.java.net/community-item/hidden-java-7-features-%E2%80%93-system-and-process-cpu-load-monitoring


=Internal=
=Internal=
Line 10: Line 9:
=java.lang.management.OperatingSystemMXBean=
=java.lang.management.OperatingSystemMXBean=


Operating system on which the Java virtual machine is running. The ObjectName registered under is "java.lang:type=OperatingSystem". To get an instance:  
The MBean exposes runtime statistics gathered from the underlying O/S. To get an instance, use <tt>ManagementFactory.getOperatingSystemMXBean()</tt> or lookup the ObjectName:


<pre>
<pre>
ManagementFactory.getOperatingSystemMXBean();
java.lang:type=OperatingSystem
</pre>
</pre>


==Interesting Parameters==
==Metrics==


===SystemLoadAverage===
====SystemLoadAverage====


<pre>
<pre>
Line 26: Line 25:
Returns the system load average for the last minute. The system load average is the sum of the number of runnable entities queued to the available processors and the number of runnable entities running on the available processors averaged over a period of time. The way in which the load average is calculated is operating system specific but is typically a damped time-dependent average. If the load average is not available, a negative value is returned. This method is designed to provide a hint about the system load and may be queried frequently. The load average may be unavailable on some platform where it is expensive to implement this method.
Returns the system load average for the last minute. The system load average is the sum of the number of runnable entities queued to the available processors and the number of runnable entities running on the available processors averaged over a period of time. The way in which the load average is calculated is operating system specific but is typically a damped time-dependent average. If the load average is not available, a negative value is returned. This method is designed to provide a hint about the system load and may be queried frequently. The load average may be unavailable on some platform where it is expensive to implement this method.


=Java 7 com.sun.management.OperatingSystemMXBean=
====ProcessCpuLoad====
====SystemCpuLoad====
====ProcessCpuTime====
====OpenFileDescriptorCount====
====MaxFileDescriptorCount====
====AvailableProcessors====
====TotalPhysicalMemorySize====
====FreePhysicalMemorySize====
====CommittedVirtualMemorySize====
====TotalSwapSpaceSize====
====FreeSwapSpaceSize====
 
=java 7 com.sun.management.OperatingSystemMXBean=


To get an instance:
To get an instance:
Line 42: Line 53:
Returns the load as a double value in the [0.0,1.0] interval, with 0.0 representing no load to 1.0 representing 100% CPU load for the whole system.
Returns the load as a double value in the [0.0,1.0] interval, with 0.0 representing no load to 1.0 representing 100% CPU load for the whole system.


<pre>
double getProcessCpuLoad();
</pre>


Returns the load as a double value in the [0.0,1.0] interval, with 0.0 representing no load to 1.0 representing 100% CPU load for the current JVM process.


{{{
<pre>
long getProcessCpuTime();
long getCommittedVirtualMemorySize();
long getTotalSwapSpaceSize();
long getFreeSwapSpaceSize();
long getFreePhysicalMemorySize();
long getTotalPhysicalMemorySize();
</pre>


    double getProcessCpuLoad();
==To Investigate==


}}}
<pre>
 
public interface UnixOperatingSystemMXBean extends com.sun.management.OperatingSystemMXBean {
Returns the load as a double value in the [[0.0,1.0] interval, with 0.0 representing no load to 1.0 representing 100% CPU load for the current JVM process.
 
{{{
 
    long getProcessCpuTime();
 
}}}
 
 
{{{
 
    long getCommittedVirtualMemorySize();
 
    long getTotalSwapSpaceSize();
 
    long getFreeSwapSpaceSize();
 
    long getFreePhysicalMemorySize();
 
    long getTotalPhysicalMemorySize();
 
}}}
 
 
<font color=red>
 
!!!To Investigate
 
{{{
public interface UnixOperatingSystemMXBean extends com.sun.management.OperatingSystemMXBean  
{
     long getOpenFileDescriptorCount();
     long getOpenFileDescriptorCount();
     long getMaxFileDescriptorCount();
     long getMaxFileDescriptorCount();
}
}
}}}
</pre>
 
</font>

Latest revision as of 14:56, 11 May 2017

External

Internal

java.lang.management.OperatingSystemMXBean

The MBean exposes runtime statistics gathered from the underlying O/S. To get an instance, use ManagementFactory.getOperatingSystemMXBean() or lookup the ObjectName:

java.lang:type=OperatingSystem

Metrics

SystemLoadAverage

double getSystemLoadAverage();

Returns the system load average for the last minute. The system load average is the sum of the number of runnable entities queued to the available processors and the number of runnable entities running on the available processors averaged over a period of time. The way in which the load average is calculated is operating system specific but is typically a damped time-dependent average. If the load average is not available, a negative value is returned. This method is designed to provide a hint about the system load and may be queried frequently. The load average may be unavailable on some platform where it is expensive to implement this method.

ProcessCpuLoad

SystemCpuLoad

ProcessCpuTime

OpenFileDescriptorCount

MaxFileDescriptorCount

AvailableProcessors

TotalPhysicalMemorySize

FreePhysicalMemorySize

CommittedVirtualMemorySize

TotalSwapSpaceSize

FreeSwapSpaceSize

java 7 com.sun.management.OperatingSystemMXBean

To get an instance:

ManagementFactory.getPlatformMXBean(com.sun.management.OperatingSystemMXBean.class);

Provides access to:

double getSystemCpuLoad();

Returns the load as a double value in the [0.0,1.0] interval, with 0.0 representing no load to 1.0 representing 100% CPU load for the whole system.

double getProcessCpuLoad();

Returns the load as a double value in the [0.0,1.0] interval, with 0.0 representing no load to 1.0 representing 100% CPU load for the current JVM process.

long getProcessCpuTime();
long getCommittedVirtualMemorySize();
long getTotalSwapSpaceSize();
long getFreeSwapSpaceSize();
long getFreePhysicalMemorySize();
long getTotalPhysicalMemorySize();

To Investigate

public interface UnixOperatingSystemMXBean extends com.sun.management.OperatingSystemMXBean {
    long getOpenFileDescriptorCount();
    long getMaxFileDescriptorCount();
}