@oas-tools/oas-telemetry 0.7.1 → 0.8.0-alpha.0

package/dist/cjs/telemetry/custom-implementations/metrics/tsdb/Chunk.cjs

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Chunk = void 0;
+class Chunk {
+    maxSamples;
+    startTimes;
+    endTimes;
+    values;
+    histograms;
+    cursor = 0;
+    minEndTime = 0;
+    maxEndTime = 0;
+    isHistogram;
+    constructor(maxSamples = 120, isHistogram = false) {
+        this.maxSamples = maxSamples;
+        this.startTimes = new Float64Array(maxSamples);
+        this.endTimes = new Float64Array(maxSamples);
+        this.values = new Float64Array(maxSamples);
+        this.histograms = new Array(maxSamples).fill(null);
+        this.isHistogram = isHistogram;
+    }
+    /**
+     * Append a sample to the chunk.
+     * Returns true if successful or false if the chunk is full.
+     */
+    append(startTime, endTime, value) {
+        if (this.cursor >= this.maxSamples) {
+            return false;
+        }
+        if (this.cursor === 0) {
+            this.minEndTime = endTime;
+        }
+        this.startTimes[this.cursor] = startTime;
+        this.endTimes[this.cursor] = endTime;
+        if (this.isHistogram && typeof value === 'object') {
+            this.values[this.cursor] = value.count;
+            this.histograms[this.cursor] = value;
+        }
+        else if (typeof value === 'number') {
+            this.values[this.cursor] = value;
+            this.histograms[this.cursor] = null;
+        }
+        else {
+            const hv = value;
+            this.values[this.cursor] = hv.count;
+            this.histograms[this.cursor] = hv;
+        }
+        this.maxEndTime = endTime;
+        this.cursor++;
+        return true;
+    }
+    /**
+     * Binary search for first index with endTime >= targetTime
+     */
+    _binarySearchStart(targetTime) {
+        let left = 0;
+        let right = this.cursor - 1;
+        let result = this.cursor;
+        while (left <= right) {
+            const mid = (left + right) >> 1;
+            if (this.endTimes[mid] >= targetTime) {
+                result = mid;
+                right = mid - 1;
+            }
+            else {
+                left = mid + 1;
+            }
+        }
+        return result;
+    }
+    /**
+     * Binary search for last index with endTime <= targetTime
+     */
+    _binarySearchEnd(targetTime, startIdx = 0) {
+        let left = startIdx;
+        let right = this.cursor - 1;
+        let result = startIdx - 1;
+        while (left <= right) {
+            const mid = (left + right) >> 1;
+            if (this.endTimes[mid] <= targetTime) {
+                result = mid;
+                left = mid + 1;
+            }
+            else {
+                right = mid - 1;
+            }
+        }
+        return result;
+    }
+    /**
+     * Efficient slicing method for bulk operations.
+     * Always returns slices. Values can be either a Float64Array (numeric)
+     * or a JS array of HistogramValue objects (histogram series).
+     */
+    getSlices(startTime, endTime) {
+        const emptyResult = {
+            startTimes: new Float64Array(0),
+            endTimes: new Float64Array(0),
+            values: this.isHistogram ? [] : new Float64Array(0),
+        };
+        const start = startTime ?? 0;
+        const end = endTime ?? Number.MAX_SAFE_INTEGER;
+        if (this.cursor === 0 || this.maxEndTime < start || this.minEndTime > end) {
+            return emptyResult;
+        }
+        const startIdx = this._binarySearchStart(start);
+        const endIdx = this._binarySearchEnd(end, startIdx);
+        if (startIdx > endIdx) {
+            return emptyResult;
+        }
+        const startTimesNew = this.startTimes.subarray(startIdx, endIdx + 1);
+        const endTimesNew = this.endTimes.subarray(startIdx, endIdx + 1);
+        if (this.isHistogram) {
+            // Return histogram objects as a simple JS array slice
+            return {
+                startTimes: startTimesNew,
+                endTimes: endTimesNew,
+                values: this.histograms.slice(startIdx, endIdx + 1),
+            };
+        }
+        return {
+            startTimes: startTimesNew,
+            endTimes: endTimesNew,
+            values: this.values.subarray(startIdx, endIdx + 1),
+        };
+    }
+    isFull() {
+        return this.cursor >= this.maxSamples;
+    }
+    overlaps(startTime, endTime) {
+        if (this.cursor === 0)
+            return false;
+        return !(this.maxEndTime < startTime || this.minEndTime > endTime);
+    }
+    getStats() {
+        return {
+            samples: this.cursor,
+            maxSamples: this.maxSamples,
+            minEndTime: this.minEndTime,
+            maxEndTime: this.maxEndTime,
+            memoryBytes: this.getMemoryUsage(),
+        };
+    }
+    getMemoryUsage() {
+        const arrayMemory = this.maxSamples * 8 * 3;
+        const histogramMemory = this.histograms.filter(h => h !== null).length * 200;
+        return arrayMemory + histogramMemory;
+    }
+    getMinTime() {
+        return this.minEndTime;
+    }
+    getMaxTime() {
+        return this.maxEndTime;
+    }
+    size() {
+        return this.cursor;
+    }
+}
+exports.Chunk = Chunk;

package/dist/cjs/telemetry/custom-implementations/metrics/tsdb/Series.cjs

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Series: Time-series storage with metadata and chunks
+ * One series per unique metric+labels combination
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Series = void 0;
+const Chunk_js_1 = require("./Chunk.cjs");
+class Series {
+    labelSet;
+    metadata;
+    chunks = [];
+    maxChunks;
+    chunkSize;
+    isHistogram;
+    constructor(labelSet, metadata, chunkSize = 120, maxChunks = 60 // ~1 hour at 1min intervals with 120 samples/chunk
+    ) {
+        this.labelSet = labelSet;
+        this.metadata = metadata;
+        this.chunkSize = chunkSize;
+        this.maxChunks = maxChunks;
+        this.isHistogram = metadata.dataPointType === 0; // HISTOGRAM = 0
+    }
+    /**
+     * Append a sample to the series
+     */
+    append(startTime, endTime, value) {
+        // Get or create current chunk
+        let currentChunk = this.chunks[this.chunks.length - 1];
+        if (!currentChunk || currentChunk.isFull()) {
+            // Create new chunk
+            currentChunk = new Chunk_js_1.Chunk(this.chunkSize, this.isHistogram);
+            this.chunks.push(currentChunk);
+            // Enforce max chunks limit (circular buffer behavior)
+            if (this.chunks.length > this.maxChunks) {
+                this.chunks.shift(); // Remove oldest chunk
+            }
+        }
+        currentChunk.append(startTime, endTime, value);
+    }
+    /**
+     * Query slices with options object. Example:
+     *   querySlices({ startTime, endTime, includeStartTimes: true })
+     *   includeStartTimes defaults to false.
+     *   If both startTime and endTime are undefined, returns all data (no time filtering).
+     */
+    querySlices(options) {
+        const start = options?.startTime ?? 0;
+        const end = options?.endTime ?? Number.MAX_VALUE;
+        const includeStartTimes = options?.includeStartTimes ?? false;
+        let totalLength = 0;
+        for (const chunk of this.chunks) {
+            if (!chunk.overlaps(start, end))
+                continue;
+            const slice = chunk.getSlices(start, end);
+            totalLength += slice.startTimes.length;
+        }
+        if (totalLength === 0) {
+            const empty = {
+                endTimes: new Float64Array(0),
+                values: this.isHistogram ? [] : new Float64Array(0),
+            };
+            if (includeStartTimes) {
+                empty.startTimes = new Float64Array(0);
+            }
+            return empty;
+        }
+        let resultStart;
+        if (includeStartTimes) {
+            resultStart = new Float64Array(totalLength);
+        }
+        const resultEnd = new Float64Array(totalLength);
+        const resultValues = this.isHistogram
+            ? new Array(totalLength)
+            : new Float64Array(totalLength);
+        let offset = 0;
+        for (const chunk of this.chunks) {
+            if (!chunk.overlaps(start, end))
+                continue;
+            const slice = chunk.getSlices(start, end);
+            const len = slice.startTimes.length;
+            if (len === 0)
+                continue;
+            // Copy start and end times
+            if (includeStartTimes && resultStart) {
+                resultStart.set(slice.startTimes, offset);
+            }
+            resultEnd.set(slice.endTimes, offset);
+            // Copy values (different type depending on metric)
+            if (this.isHistogram) {
+                resultValues.splice(offset, len, ...slice.values);
+            }
+            else {
+                resultValues.set(slice.values, offset);
+            }
+            offset += len;
+        }
+        const result = {
+            endTimes: resultEnd,
+            values: resultValues
+        };
+        if (includeStartTimes && resultStart) {
+            result.startTimes = resultStart;
+        }
+        return result;
+    }
+    /**
+     * Remove chunks older than threshold
+     */
+    evictOldChunks(thresholdTime) {
+        let evicted = 0;
+        while (this.chunks.length > 0 && this.chunks[0].getMaxTime() < thresholdTime) {
+            this.chunks.shift();
+            evicted++;
+        }
+        return evicted;
+    }
+    /**
+     * Get series metadata
+     */
+    getMetadata() {
+        return this.metadata;
+    }
+    getLabels() {
+        return this.labelSet.labels;
+    }
+    getOriginalAttributes() {
+        return this.labelSet.originalAttributes;
+    }
+    /**
+     * Get label hash
+     */
+    getLabelHash() {
+        return this.labelSet.hash;
+    }
+    getStats() {
+        const totalSamples = this.chunks.reduce((sum, chunk) => sum + chunk.size(), 0);
+        const memoryBytes = this.chunks.reduce((sum, chunk) => sum + chunk.getMemoryUsage(), 0);
+        return {
+            metricName: this.metadata?.descriptor?.name ?? 'unknown',
+            labels: this.labelSet?.labels ?? {},
+            chunks: this.chunks.length,
+            samples: totalSamples,
+            memoryBytes,
+            oldestTime: this.chunks[0]?.getMinTime() ?? 0,
+            newestTime: this.chunks[this.chunks.length - 1]?.getMaxTime() ?? 0
+        };
+    }
+    /**
+     * Check if series has any samples
+     */
+    isEmpty() {
+        return this.chunks.length === 0 || this.chunks.every(c => c.size() === 0);
+    }
+    /**
+     * Get time range covered by this series
+     */
+    getTimeRange() {
+        if (this.chunks.length === 0) {
+            return { min: 0, max: 0 };
+        }
+        return {
+            min: this.chunks[0].getMinTime(),
+            max: this.chunks[this.chunks.length - 1].getMaxTime()
+        };
+    }
+}
+exports.Series = Series;