From 1860d08fdc3fde314e18c74f745c2861178388a7 Mon Sep 17 00:00:00 2001 From: Ivan Topolnjak Date: Tue, 12 Dec 2017 00:33:36 +0100 Subject: rename TickSnapshot to PeriodSnapshot, use Instant instead of plain Longs --- .../main/scala/kamon/metric/PeriodSnapshot.scala | 75 ++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 kamon-core/src/main/scala/kamon/metric/PeriodSnapshot.scala (limited to 'kamon-core/src/main/scala/kamon/metric/PeriodSnapshot.scala') diff --git a/kamon-core/src/main/scala/kamon/metric/PeriodSnapshot.scala b/kamon-core/src/main/scala/kamon/metric/PeriodSnapshot.scala new file mode 100644 index 00000000..50a5f778 --- /dev/null +++ b/kamon-core/src/main/scala/kamon/metric/PeriodSnapshot.scala @@ -0,0 +1,75 @@ +/* ========================================================================================= + * Copyright © 2013-2017 the kamon project + * + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the + * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, + * either express or implied. See the License for the specific language governing permissions + * and limitations under the License. + * ========================================================================================= + */ + +package kamon +package metric + +import java.time.Instant + + +/** + * Contains immutable snapshots of all metrics recorded since from and until to. + * + * @param from + * @param to + * @param metrics + */ +case class PeriodSnapshot(from: Instant, to: Instant, metrics: MetricsSnapshot) + +case class MetricsSnapshot( + histograms: Seq[MetricDistribution], + rangeSamplers: 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: Tags, unit: 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: Tags, unit: 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 +} + -- cgit v1.2.3