Check out the New Service Map! Check out the all-new Kamon APM Service Map!

Host 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:

Samples the CPU usage percentage on different modes.

Instruments are tagged with:

  • mode: Mode on which CPU usage is being tracked (e.g. user, system, wait, stolen, etc.)
Tracks the amount of used memory.
Tracks the amount of free memory.
Tracks the total memory available.
Tracks the free Swap space.
Tracks the used Swap space.
Tracks the total Swap space.
Tracks the system load average.

Instruments are tagged with:

  • period: Whether the load average represents a 1m, 5m or 15m period.
Tracks the used space on a file system mount/volume.

Instruments are tagged with:

  • mount: Name of the file system mount being measured.
Tracks the free space on a file system mount/volume.

Instruments are tagged with:

  • mount: Name of the file system mount being measured.
Tracks the total space on a file system mount/volume.

Instruments are tagged with:

  • mount: Name of the file system mount being measured.
Counts the amount of byes that have been read from a storage device.

Instruments are tagged with:

  • device: Name of the storage device being measured.
Counts the amount of byes that have been written to a storage device.

Instruments are tagged with:

  • device: Name of the storage device being measured.
Counts the number of read operations executed on a storage device.

Instruments are tagged with:

  • device: Name of the storage device being measured.
Counts the number of write operations executed on a storage device.

Instruments are tagged with:

  • device: Name of the storage device being measured.
Counts how many packets have been read from a network interface.

Instruments are tagged with:

  • interface: Name of the network interface being measured.
Counts how many packets failed to be read from a network interface.

Instruments are tagged with:

  • interface: Name of the network interface being measured.
Counts how many packets have been written to a network interface.

Instruments are tagged with:

  • interface: Name of the network interface being measured.
Counts how many packets failed to be written to a network interface.

Instruments are tagged with:

  • interface: Name of the network interface being measured.
Counts how many bytes have been read from a network interface.

Instruments are tagged with:

  • interface: Name of the network interface being measured.
Counts how many bytes have been written to a network interface.

Instruments are tagged with:

  • interface: Name of the network interface being measured.

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 {
  host-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.1.13"



    <dependency>
      <groupId>io.kamon</groupId>
      <artifactId>kamon-system-metrics_2.12</artifactId>
      <version>2.1.13</version>
    </dependency>


implementation 'io.kamon:kamon-system-metrics_2.12:2.1.13'