Added a new Profiler for CPU/JVM CPU monitoring using (Sun/Oracle) Java7+ JMX Bean

AlejandroRivera commented 8 years ago

While the current CPU profiler focuses on breakdowns per thread, this new profiler obtains CPU load (in percentage) for the entire JVM and the system.

Here's the description taken from the modified README file:

JVM And System CPU Profiler: `JVMCPUProfiler`

This profiler will record the JVM's and the overall system's CPU load, if the JVM is capable of providing this information.

Assuming you use the default prefix of statsd-jvm-profiler, the JVM CPU load metrics will be under statsd-jvm-profiler.cpu.jvm, and the System CPU load wil be under statsd-jvm-profiler.cpu.system.

The reported metrics will be percentages in the range of [0, 100] with 1 decimal precision.

CPU load metrics are sampled and reported once every 10 seconds.

Important notes:

This Profiler is not enabled by default. To enable use the argument profilers=JVMCPUProfiler
This Profiler relies on Sun/Oracle-specific JVM implementations that offer a JMX bean that might not be available in other JVMs. Even if you are using the right JVM, there's no guarantee this JMX bean will remain there in the future.
The minimum required JVM version that offers support for this is for Java 7.
See com.sun.management.OperatingSystemMXBean for more information.
If the JVM doesn't support the required operations, the metrics above won't be reported at all.

ajsquared commented 8 years ago

Thanks, this is a really great new feature! I had a couple questions inline but overall this looks good.

AlejandroRivera commented 8 years ago

How about now? :)

ajsquared commented 8 years ago

Great, thanks for doing that renaming. This all looks good! I'll get 2.0 published this morning.

ajsquared commented 8 years ago

I've just published 2.0.0. It should be available from Maven Central shortly.

etsy / statsd-jvm-profiler