aboutsummaryrefslogtreecommitdiff
path: root/kamon-core/src/main/scala/kamon/metric/TickSnapshot.scala
blob: 6aed1ab3e73e23146ad28ff4bfff725aeb1ccda0 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
package kamon.metric

import kamon.util.MeasurementUnit


/**
  *
  * @param interval
  * @param metrics
  */
case class TickSnapshot(interval: Interval, metrics: MetricsSnapshot)

case class Interval(from: Long, to: Long)

case class MetricsSnapshot(
  histograms: Seq[MetricDistribution],
  minMaxCounters: Seq[MetricDistribution],
  gauges: Seq[MetricValue],
  counters: Seq[MetricValue]
)

/**
  * Snapshot for instruments that internally track a single value. Meant to be used for counters and gauges.
  *
  */
case class MetricValue(name: String, tags: Map[String, String], measurementUnit: MeasurementUnit, value: Long)

/**
  * Snapshot for instruments that internally the distribution of values in a defined dynamic range. Meant to be used
  * with histograms and min max counters.
  */
case class MetricDistribution(name: String, tags: Map[String, String],  measurementUnit: MeasurementUnit,
  dynamicRange: DynamicRange, distribution: Distribution)


trait Distribution {
  def buckets: Seq[Bucket]
  def bucketsIterator: Iterator[Bucket]

  def min: Long
  def max: Long
  def sum: Long
  def count: Long
  def percentile(p: Double): Percentile

  def percentiles: Seq[Percentile]
  def percentilesIterator: Iterator[Percentile]
}

trait Bucket {
  def value: Long
  def frequency: Long
}

trait Percentile {
  def quantile: Double
  def value: Long
  def countUnderQuantile: Long
}


trait DistributionSnapshotInstrument {
  private[kamon] def snapshot(): MetricDistribution
}

trait SingleValueSnapshotInstrument {
  private[kamon] def snapshot(): MetricValue
}

trait SnapshotableHistogram extends Histogram with DistributionSnapshotInstrument
trait SnapshotableMinMaxCounter extends MinMaxCounter with DistributionSnapshotInstrument
trait SnapshotableCounter extends Counter with SingleValueSnapshotInstrument
trait SnapshotableGauge extends Gauge with SingleValueSnapshotInstrument