// Copyright The OpenTelemetry 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 aggregatortest // import "go.opentelemetry.io/otel/sdk/metric/aggregator/aggregatortest" import ( "context" "math/rand" "os" "sort" "testing" "unsafe" "go.opentelemetry.io/otel" ottest "go.opentelemetry.io/otel/internal/testing" "go.opentelemetry.io/otel/metric/number" export "go.opentelemetry.io/otel/sdk/export/metric" "go.opentelemetry.io/otel/sdk/metric/aggregator" ) const Magnitude = 1000 type Profile struct { NumberKind number.Kind Random func(sign int) number.Number } func newProfiles() []Profile { rnd := rand.New(rand.NewSource(rand.Int63())) return []Profile{ { NumberKind: number.Int64Kind, Random: func(sign int) number.Number { return number.NewInt64Number(int64(sign) * int64(rnd.Intn(Magnitude+1))) }, }, { NumberKind: number.Float64Kind, Random: func(sign int) number.Number { return number.NewFloat64Number(float64(sign) * rnd.Float64() * Magnitude) }, }, } } func NewAggregatorTest(mkind otel.InstrumentKind, nkind number.Kind) *otel.Descriptor { desc := otel.NewDescriptor("test.name", mkind, nkind) return &desc } func RunProfiles(t *testing.T, f func(*testing.T, Profile)) { for _, profile := range newProfiles() { t.Run(profile.NumberKind.String(), func(t *testing.T) { f(t, profile) }) } } // Ensure local struct alignment prior to running tests. func TestMain(m *testing.M) { fields := []ottest.FieldOffset{ { Name: "Numbers.numbers", Offset: unsafe.Offsetof(Numbers{}.numbers), }, } if !ottest.Aligned8Byte(fields, os.Stderr) { os.Exit(1) } os.Exit(m.Run()) } // TODO: Expose Numbers in api/metric for sorting support type Numbers struct { // numbers has to be aligned for 64-bit atomic operations. numbers []number.Number kind number.Kind } func NewNumbers(kind number.Kind) Numbers { return Numbers{ kind: kind, } } func (n *Numbers) Append(v number.Number) { n.numbers = append(n.numbers, v) } func (n *Numbers) Sort() { sort.Sort(n) } func (n *Numbers) Less(i, j int) bool { return n.numbers[i].CompareNumber(n.kind, n.numbers[j]) < 0 } func (n *Numbers) Len() int { return len(n.numbers) } func (n *Numbers) Swap(i, j int) { n.numbers[i], n.numbers[j] = n.numbers[j], n.numbers[i] } func (n *Numbers) Sum() number.Number { var sum number.Number for _, num := range n.numbers { sum.AddNumber(n.kind, num) } return sum } func (n *Numbers) Count() int64 { return int64(len(n.numbers)) } func (n *Numbers) Min() number.Number { return n.numbers[0] } func (n *Numbers) Max() number.Number { return n.numbers[len(n.numbers)-1] } // Median() is an alias for Quantile(0.5). func (n *Numbers) Median() number.Number { // Note that len(n.numbers) is 1 greater than the max element // index, so dividing by two rounds up. This gives the // intended definition for Quantile() in tests, which is to // return the smallest element that is at or above the // specified quantile. return n.numbers[len(n.numbers)/2] } func (n *Numbers) Points() []number.Number { return n.numbers } // Performs the same range test the SDK does on behalf of the aggregator. func CheckedUpdate(t *testing.T, agg export.Aggregator, number number.Number, descriptor *otel.Descriptor) { ctx := context.Background() // Note: Aggregator tests are written assuming that the SDK // has performed the RangeTest. Therefore we skip errors that // would have been detected by the RangeTest. err := aggregator.RangeTest(number, descriptor) if err != nil { return } if err := agg.Update(ctx, number, descriptor); err != nil { t.Error("Unexpected Update failure", err) } } func CheckedMerge(t *testing.T, aggInto, aggFrom export.Aggregator, descriptor *otel.Descriptor) { if err := aggInto.Merge(aggFrom, descriptor); err != nil { t.Error("Unexpected Merge failure", err) } }