Files
tasq/node_modules/@opentelemetry/sdk-metrics/build/src/view/Aggregation.js
T
2026-04-09 19:01:53 +08:00

179 lines
7.1 KiB
JavaScript

"use strict";
/*
* 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
*
* https://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.
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.DefaultAggregation = exports.ExponentialHistogramAggregation = exports.ExplicitBucketHistogramAggregation = exports.HistogramAggregation = exports.LastValueAggregation = exports.SumAggregation = exports.DropAggregation = exports.Aggregation = void 0;
const api = require("@opentelemetry/api");
const aggregator_1 = require("../aggregator");
const InstrumentDescriptor_1 = require("../InstrumentDescriptor");
/**
* Configures how measurements are combined into metrics for views.
*
* Aggregation provides a set of built-in aggregations via static methods.
*/
class Aggregation {
static Drop() {
return DROP_AGGREGATION;
}
static Sum() {
return SUM_AGGREGATION;
}
static LastValue() {
return LAST_VALUE_AGGREGATION;
}
static Histogram() {
return HISTOGRAM_AGGREGATION;
}
static ExponentialHistogram() {
return EXPONENTIAL_HISTOGRAM_AGGREGATION;
}
static Default() {
return DEFAULT_AGGREGATION;
}
}
exports.Aggregation = Aggregation;
/**
* The default drop aggregation.
*/
class DropAggregation extends Aggregation {
createAggregator(_instrument) {
return DropAggregation.DEFAULT_INSTANCE;
}
}
exports.DropAggregation = DropAggregation;
DropAggregation.DEFAULT_INSTANCE = new aggregator_1.DropAggregator();
/**
* The default sum aggregation.
*/
class SumAggregation extends Aggregation {
createAggregator(instrument) {
switch (instrument.type) {
case InstrumentDescriptor_1.InstrumentType.COUNTER:
case InstrumentDescriptor_1.InstrumentType.OBSERVABLE_COUNTER:
case InstrumentDescriptor_1.InstrumentType.HISTOGRAM: {
return SumAggregation.MONOTONIC_INSTANCE;
}
default: {
return SumAggregation.NON_MONOTONIC_INSTANCE;
}
}
}
}
exports.SumAggregation = SumAggregation;
SumAggregation.MONOTONIC_INSTANCE = new aggregator_1.SumAggregator(true);
SumAggregation.NON_MONOTONIC_INSTANCE = new aggregator_1.SumAggregator(false);
/**
* The default last value aggregation.
*/
class LastValueAggregation extends Aggregation {
createAggregator(_instrument) {
return LastValueAggregation.DEFAULT_INSTANCE;
}
}
exports.LastValueAggregation = LastValueAggregation;
LastValueAggregation.DEFAULT_INSTANCE = new aggregator_1.LastValueAggregator();
/**
* The default histogram aggregation.
*/
class HistogramAggregation extends Aggregation {
createAggregator(_instrument) {
return HistogramAggregation.DEFAULT_INSTANCE;
}
}
exports.HistogramAggregation = HistogramAggregation;
HistogramAggregation.DEFAULT_INSTANCE = new aggregator_1.HistogramAggregator([0, 5, 10, 25, 50, 75, 100, 250, 500, 750, 1000, 2500, 5000, 7500, 10000], true);
/**
* The explicit bucket histogram aggregation.
*/
class ExplicitBucketHistogramAggregation extends Aggregation {
/**
* @param boundaries the bucket boundaries of the histogram aggregation
* @param _recordMinMax If set to true, min and max will be recorded. Otherwise, min and max will not be recorded.
*/
constructor(boundaries, _recordMinMax = true) {
super();
this._recordMinMax = _recordMinMax;
if (boundaries == null) {
throw new Error('ExplicitBucketHistogramAggregation should be created with explicit boundaries, if a single bucket histogram is required, please pass an empty array');
}
// Copy the boundaries array for modification.
boundaries = boundaries.concat();
// We need to an ordered set to be able to correctly compute count for each
// boundary since we'll iterate on each in order.
boundaries = boundaries.sort((a, b) => a - b);
// Remove all Infinity from the boundaries.
const minusInfinityIndex = boundaries.lastIndexOf(-Infinity);
let infinityIndex = boundaries.indexOf(Infinity);
if (infinityIndex === -1) {
infinityIndex = undefined;
}
this._boundaries = boundaries.slice(minusInfinityIndex + 1, infinityIndex);
}
createAggregator(_instrument) {
return new aggregator_1.HistogramAggregator(this._boundaries, this._recordMinMax);
}
}
exports.ExplicitBucketHistogramAggregation = ExplicitBucketHistogramAggregation;
class ExponentialHistogramAggregation extends Aggregation {
constructor(_maxSize = 160, _recordMinMax = true) {
super();
this._maxSize = _maxSize;
this._recordMinMax = _recordMinMax;
}
createAggregator(_instrument) {
return new aggregator_1.ExponentialHistogramAggregator(this._maxSize, this._recordMinMax);
}
}
exports.ExponentialHistogramAggregation = ExponentialHistogramAggregation;
/**
* The default aggregation.
*/
class DefaultAggregation extends Aggregation {
_resolve(instrument) {
// cast to unknown to disable complaints on the (unreachable) fallback.
switch (instrument.type) {
case InstrumentDescriptor_1.InstrumentType.COUNTER:
case InstrumentDescriptor_1.InstrumentType.UP_DOWN_COUNTER:
case InstrumentDescriptor_1.InstrumentType.OBSERVABLE_COUNTER:
case InstrumentDescriptor_1.InstrumentType.OBSERVABLE_UP_DOWN_COUNTER: {
return SUM_AGGREGATION;
}
case InstrumentDescriptor_1.InstrumentType.GAUGE:
case InstrumentDescriptor_1.InstrumentType.OBSERVABLE_GAUGE: {
return LAST_VALUE_AGGREGATION;
}
case InstrumentDescriptor_1.InstrumentType.HISTOGRAM: {
if (instrument.advice.explicitBucketBoundaries) {
return new ExplicitBucketHistogramAggregation(instrument.advice.explicitBucketBoundaries);
}
return HISTOGRAM_AGGREGATION;
}
}
api.diag.warn(`Unable to recognize instrument type: ${instrument.type}`);
return DROP_AGGREGATION;
}
createAggregator(instrument) {
return this._resolve(instrument).createAggregator(instrument);
}
}
exports.DefaultAggregation = DefaultAggregation;
const DROP_AGGREGATION = new DropAggregation();
const SUM_AGGREGATION = new SumAggregation();
const LAST_VALUE_AGGREGATION = new LastValueAggregation();
const HISTOGRAM_AGGREGATION = new HistogramAggregation();
const EXPONENTIAL_HISTOGRAM_AGGREGATION = new ExponentialHistogramAggregation();
const DEFAULT_AGGREGATION = new DefaultAggregation();
//# sourceMappingURL=Aggregation.js.map