Khronus is an open source, distributed and reactive time series database designed to store, retrieve, analyze and process a large amount of custom metrics.

Kamon khronus module is currently available for Scala 2.10, 2.11 and 2.12.

Supported releases and dependencies are shown below.

To get started with SBT, simply add the following to your build.sbt file:

libraryDependencies += "io.kamon" %% "kamon-khronus" % "0.6.7"

Set kamon.khronus.host to point to your Khronus instance using a host:port value like 11.22.33.44:1173. Most likely, you will also want to set kamon.khronus.app-name to the application name you wish to report metric as.

These are the configuration keys available and their default values (taken from the reference.conf file supplied with this module):

kamon {
  khronus {
    host = "127.0.0.1:1173"
    app-name = "kamon-khronus"
    # Time interval in milliseconds to flush the buffer and send the accumulated metrics.
    # It must be less than the smallest time window configured in Khronus.
    interval = 3000
    # Maximum number of measures to hold in memory within intervals.
    # Past this threshold, metrics will be discarded.
    max-measures = 500000
  }
}

This reporter will automatically subscribe itself to the following categories:

• counter.
• histogram.
• gauge.
• trace.
• executor-service.

The other important categories like akka-*, system-metrics, and http-server were not included in this initial version due to time constraints. Also, there are no facilities for filtering categories. Please feel free to jump in!