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.
| kamon-khronus | status | jdk | scala | akka |
|---|---|---|---|---|
| 0.6.7 | stable | 1.7+, 1.8+ | 2.10, 2.11, 2.12 | 2.3.x, 2.4.x |
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!