Process Metrics #

Available Metrics #

Kamon will automatically detect and start the Process metrics module when it is in your classpath and the following metrics will become available:

process.cpu.usage histogram

Samples the Process CPU usage.

Tags included by default:

mode: Whether the CPU usage is on user, system or combined mode.

process.ulimit.file-descriptors.max gauge

Tracks the max number of file descriptors that can be used by the process.

process.ulimit.file-descriptors.used gauge

Tracks the number of file descriptors used by the process.

process.hiccups timer

Tracks the process hiccups generated by either garbage collection or OS noise.

Disabling the Module #

This module is enabled by default, but you can explicitly enable/disable it by changing the enabled setting in your application configuration:

kamon.modules {
  process-metrics {
    enabled = no
  }
}

Kamon will still recognize that the module is available, but will not automatically start it when Kamon.init() or Kamon.loadModules() are called.

Manual Installation #

In case you are not using the Kamon Bundle, add the dependency below to your build (the Process metrics module is distributed as part of the system metrics module).


libraryDependencies += "io.kamon" %% "kamon-system-metrics" % "2.5.9"


    <dependency>
      <groupId>io.kamon</groupId>
      <artifactId>kamon-system-metrics_2.13</artifactId>
      <version>2.5.9</version>
    </dependency>


implementation 'io.kamon:kamon-system-metrics_2.13:2.5.9'

On this article