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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
/*
* Copyright 2018, OpenCensus Authors
*
* 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 io.opencensus.metrics.export;
import com.google.auto.value.AutoValue;
import io.opencensus.common.ExperimentalApi;
import io.opencensus.internal.Utils;
import io.opencensus.metrics.export.Value.ValueDistribution;
import io.opencensus.metrics.export.Value.ValueDouble;
import io.opencensus.metrics.export.Value.ValueLong;
import io.opencensus.metrics.export.Value.ValueSummary;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import javax.annotation.concurrent.Immutable;
/**
* A {@link Metric} with one or more {@link TimeSeries}.
*
* @since 0.17
*/
@ExperimentalApi
@Immutable
@AutoValue
public abstract class Metric {
Metric() {}
/**
* Creates a {@link Metric}.
*
* @param metricDescriptor the {@link MetricDescriptor}.
* @param timeSeriesList the {@link TimeSeries} list for this metric.
* @return a {@code Metric}.
* @since 0.17
*/
public static Metric create(MetricDescriptor metricDescriptor, List<TimeSeries> timeSeriesList) {
Utils.checkListElementNotNull(
Utils.checkNotNull(timeSeriesList, "timeSeriesList"), "timeSeries");
return createInternal(
metricDescriptor, Collections.unmodifiableList(new ArrayList<TimeSeries>(timeSeriesList)));
}
/**
* Creates a {@link Metric}.
*
* @param metricDescriptor the {@link MetricDescriptor}.
* @param timeSeries the single {@link TimeSeries} for this metric.
* @return a {@code Metric}.
* @since 0.17
*/
public static Metric createWithOneTimeSeries(
MetricDescriptor metricDescriptor, TimeSeries timeSeries) {
return createInternal(
metricDescriptor, Collections.singletonList(Utils.checkNotNull(timeSeries, "timeSeries")));
}
/**
* Creates a {@link Metric}.
*
* @param metricDescriptor the {@link MetricDescriptor}.
* @param timeSeriesList the {@link TimeSeries} list for this metric.
* @return a {@code Metric}.
* @since 0.17
*/
private static Metric createInternal(
MetricDescriptor metricDescriptor, List<TimeSeries> timeSeriesList) {
Utils.checkNotNull(metricDescriptor, "metricDescriptor");
checkTypeMatch(metricDescriptor.getType(), timeSeriesList);
return new AutoValue_Metric(metricDescriptor, timeSeriesList);
}
/**
* Returns the {@link MetricDescriptor} of this metric.
*
* @return the {@code MetricDescriptor} of this metric.
* @since 0.17
*/
public abstract MetricDescriptor getMetricDescriptor();
/**
* Returns the {@link TimeSeries} list for this metric.
*
* <p>The type of the {@link TimeSeries#getPoints()} must match {@link MetricDescriptor.Type}.
*
* @return the {@code TimeSeriesList} for this metric.
* @since 0.17
*/
public abstract List<TimeSeries> getTimeSeriesList();
private static void checkTypeMatch(MetricDescriptor.Type type, List<TimeSeries> timeSeriesList) {
for (TimeSeries timeSeries : timeSeriesList) {
for (Point point : timeSeries.getPoints()) {
Value value = point.getValue();
String valueClassName = "";
if (value.getClass().getSuperclass() != null) { // work around nullness check
// AutoValue classes should always have a super class.
valueClassName = value.getClass().getSuperclass().getSimpleName();
}
switch (type) {
case GAUGE_INT64:
case CUMULATIVE_INT64:
Utils.checkArgument(
value instanceof ValueLong, "Type mismatch: %s, %s.", type, valueClassName);
break;
case CUMULATIVE_DOUBLE:
case GAUGE_DOUBLE:
Utils.checkArgument(
value instanceof ValueDouble, "Type mismatch: %s, %s.", type, valueClassName);
break;
case GAUGE_DISTRIBUTION:
case CUMULATIVE_DISTRIBUTION:
Utils.checkArgument(
value instanceof ValueDistribution, "Type mismatch: %s, %s.", type, valueClassName);
break;
case SUMMARY:
Utils.checkArgument(
value instanceof ValueSummary, "Type mismatch: %s, %s.", type, valueClassName);
}
}
}
}
}
|
