Change to metrics to keep track of when the metric value was first set

This CL also adds IncrementableMetric#reset() methods to allow resetting the
value and start timestamp of IncrementableMetrics.

This is necessary because some backends, like Stackdriver, use non-monotonic
changes in cumulative metric values to detect timeseries restarts. Tracking and
re-setting the start timestamp allows users to track mostly monotonic metrics
which may have non-monotonic discontinuities.

See https://cloud.google.com/monitoring/api/ref_v3/rest/v3/TimeSeries#Point for
more details.

-------------
Created by MOE: https://github.com/google/moe
MOE_MIGRATED_REVID=130795229
This commit is contained in:
shikhman 2016-08-19 14:56:35 -07:00 committed by Ben McIlwain
parent b6eaba08eb
commit 91f8b6da38
7 changed files with 192 additions and 26 deletions

View file

@ -24,8 +24,8 @@ import com.google.common.collect.ImmutableList;
public interface Metric<V> {
/**
* Returns the list of the latest {@link MetricPoint} instances for every label-value combination
* tracked for this metric.
* Returns the latest {@link MetricPoint} instances for every label-value combination tracked for
* this metric.
*/
ImmutableList<MetricPoint<V>> getTimestampedValues();