@spinajs/telemetry 2.0.482

package/lib/cjs/timeline.d.ts

@@ -0,0 +1,48 @@
+import { IRequestStatsSnapshot } from './requestStats.js';
+/**
+ * Serializable snapshot of a {@link Timeline}: a map of bucket-key -> stats.
+ */
+export type ITimelineSnapshot = Record<string, IRequestStatsSnapshot>;
+/**
+ * Port of swagger-stats' `swsTimeline` — a rolling ring of `length` buckets,
+ * each spanning `bucketMs`, keyed by `floor(timestamp / bucketMs)`. Each bucket
+ * holds its own {@link RequestStats}.
+ *
+ * Deterministic: every method takes the current timestamp so tests can drive
+ * it without touching the real clock.
+ */
+export declare class Timeline {
+    /**
+     * Number of buckets retained in the ring.
+     */
+    readonly length: number;
+    /**
+     * Bucket width in milliseconds.
+     */
+    readonly bucketMs: number;
+    /**
+     * Apdex threshold ( ms ) propagated to each bucket's RequestStats.
+     */
+    readonly apdexThreshold: number;
+    private buckets;
+    constructor(length?: number, bucketMs?: number, apdexThreshold?: number);
+    /**
+     * The bucket key for a timestamp.
+     */
+    keyFor(timestamp: number): number;
+    private ensureBucket;
+    /**
+     * Open the bucket for `now` and expire buckets older than `length` buckets.
+     */
+    tick(now?: number): void;
+    /**
+     * Route a completed response into the bucket for its timestamp ( ticking to
+     * open the current bucket + expire old ones first ).
+     */
+    record(statusCode: number, durationMs: number, timestamp?: number): void;
+    /**
+     * A plain-object snapshot of every live bucket, keyed by bucket key.
+     */
+    toJSON(): ITimelineSnapshot;
+}
+//# sourceMappingURL=timeline.d.ts.map

package/lib/cjs/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAgB,MAAM,mBAAmB,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAKtE;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,SAAgB,cAAc,EAAE,MAAM,CAAC;IAEvC,OAAO,CAAC,OAAO,CAAmC;gBAEtC,MAAM,GAAE,MAAuB,EAAE,QAAQ,GAAE,MAA0B,EAAE,cAAc,CAAC,EAAE,MAAM;IAM1G;;OAEG;IACI,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIxC,OAAO,CAAC,YAAY;IASpB;;OAEG;IACI,IAAI,CAAC,GAAG,GAAE,MAAmB,GAAG,IAAI;IAU3C;;;OAGG;IACI,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,MAAmB,GAAG,IAAI;IAO3F;;OAEG;IACI,MAAM,IAAI,iBAAiB;CAOnC"}

package/lib/cjs/timeline.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timeline = void 0;
+const requestStats_js_1 = require("./requestStats.js");
+const DEFAULT_LENGTH = 60;
+const DEFAULT_BUCKET_MS = 60_000;
+/**
+ * Port of swagger-stats' `swsTimeline` — a rolling ring of `length` buckets,
+ * each spanning `bucketMs`, keyed by `floor(timestamp / bucketMs)`. Each bucket
+ * holds its own {@link RequestStats}.
+ *
+ * Deterministic: every method takes the current timestamp so tests can drive
+ * it without touching the real clock.
+ */
+class Timeline {
+    constructor(length = DEFAULT_LENGTH, bucketMs = DEFAULT_BUCKET_MS, apdexThreshold) {
+        this.buckets = new Map();
+        this.length = length;
+        this.bucketMs = bucketMs;
+        this.apdexThreshold = apdexThreshold ?? new requestStats_js_1.RequestStats().apdexThreshold;
+    }
+    /**
+     * The bucket key for a timestamp.
+     */
+    keyFor(timestamp) {
+        return Math.floor(timestamp / this.bucketMs);
+    }
+    ensureBucket(key) {
+        let bucket = this.buckets.get(key);
+        if (!bucket) {
+            bucket = new requestStats_js_1.RequestStats(this.apdexThreshold);
+            this.buckets.set(key, bucket);
+        }
+        return bucket;
+    }
+    /**
+     * Open the bucket for `now` and expire buckets older than `length` buckets.
+     */
+    tick(now = Date.now()) {
+        const current = this.keyFor(now);
+        this.ensureBucket(current);
+        const oldest = current - this.length + 1;
+        for (const key of [...this.buckets.keys()]) {
+            if (key < oldest)
+                this.buckets.delete(key);
+        }
+    }
+    /**
+     * Route a completed response into the bucket for its timestamp ( ticking to
+     * open the current bucket + expire old ones first ).
+     */
+    record(statusCode, durationMs, timestamp = Date.now()) {
+        this.tick(timestamp);
+        const bucket = this.ensureBucket(this.keyFor(timestamp));
+        bucket.countRequest();
+        bucket.countResponse(statusCode, durationMs);
+    }
+    /**
+     * A plain-object snapshot of every live bucket, keyed by bucket key.
+     */
+    toJSON() {
+        const out = {};
+        for (const [key, stats] of this.buckets) {
+            out[String(key)] = stats.toJSON();
+        }
+        return out;
+    }
+}
+exports.Timeline = Timeline;
+//# sourceMappingURL=timeline.js.map

package/lib/cjs/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../src/timeline.ts"],"names":[],"mappings":";;;AAAA,uDAAwE;AAOxE,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAa,QAAQ;IAkBnB,YAAY,SAAiB,cAAc,EAAE,WAAmB,iBAAiB,EAAE,cAAuB;QAFlG,YAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;QAGhD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,IAAI,IAAI,8BAAY,EAAE,CAAC,cAAc,CAAC;IAC5E,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEO,YAAY,CAAC,GAAW;QAC9B,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,8BAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAE3B,MAAM,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3C,IAAI,GAAG,GAAG,MAAM;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,UAAkB,EAAE,UAAkB,EAAE,YAAoB,IAAI,CAAC,GAAG,EAAE;QAClF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,MAAM;QACX,MAAM,GAAG,GAAsB,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA1ED,4BA0EC"}

package/lib/mjs/InMemoryPerfSink.d.ts

@@ -0,0 +1,51 @@
+import { PerfSink, IPerfMetric } from '@spinajs/log';
+/** One aggregated span row. */
+export interface IPerfSpanEntry {
+    name: string;
+    count: number;
+    totalMs: number;
+    avgMs: number;
+    maxMs: number;
+}
+/** One aggregated counter / value row. */
+export interface IPerfEventEntry {
+    name: string;
+    count: number;
+    total: number;
+}
+/** Serializable snapshot served by `GET /telemetry/perf`. */
+export interface IPerfSnapshot {
+    /** True once the name cap was hit and new names stopped being tracked. */
+    truncated: boolean;
+    spans: IPerfSpanEntry[];
+    events: IPerfEventEntry[];
+}
+/**
+ * A {@link PerfSink} that keeps a bounded, JSON-readable aggregate of every
+ * measurement, backing `GET /telemetry/perf`.
+ *
+ * This exists alongside `PromMetricSink` rather than replacing it: prom
+ * histograms are the right shape for Prometheus but their bucket counts cannot
+ * be read back as a mean or a max, which is what a JSON snapshot needs.
+ *
+ * Per-request rollups are intentionally NOT implemented here — `onScopeEnd`
+ * totals share the span names, so folding them in would double-count against
+ * the same rows. The per-request view lives in `perf_scope_total_ms` on the
+ * prometheus side.
+ */
+export declare class InMemoryPerfSink extends PerfSink {
+    protected Enabled: boolean;
+    protected MaxNames: number;
+    private spans;
+    private events;
+    private truncated;
+    collect(metric: IPerfMetric): void;
+    toJSON(): IPerfSnapshot;
+    /**
+     * Whether a NEW name may be tracked. Spans and events share one budget so the
+     * total retained-name count is what `maxNames` bounds.
+     */
+    private track;
+    private create;
+}
+//# sourceMappingURL=InMemoryPerfSink.d.ts.map

package/lib/mjs/InMemoryPerfSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryPerfSink.d.ts","sourceRoot":"","sources":["../../src/InMemoryPerfSink.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAErD,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,qBAEa,gBAAiB,SAAQ,QAAQ;IAE5C,SAAS,CAAC,OAAO,EAAG,OAAO,CAAC;IAG5B,SAAS,CAAC,QAAQ,EAAG,MAAM,CAAC;IAE5B,OAAO,CAAC,KAAK,CAAwE;IACrF,OAAO,CAAC,MAAM,CAAuD;IACrE,OAAO,CAAC,SAAS,CAAS;IAEnB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAsBlC,MAAM,IAAI,aAAa;IAgB9B;;;OAGG;IACH,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,MAAM;CAIf"}

package/lib/mjs/InMemoryPerfSink.js

@@ -0,0 +1,97 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Singleton, Injectable } from '@spinajs/di';
+import { Config } from '@spinajs/configuration';
+import { PerfSink } from '@spinajs/log';
+/**
+ * A {@link PerfSink} that keeps a bounded, JSON-readable aggregate of every
+ * measurement, backing `GET /telemetry/perf`.
+ *
+ * This exists alongside `PromMetricSink` rather than replacing it: prom
+ * histograms are the right shape for Prometheus but their bucket counts cannot
+ * be read back as a mean or a max, which is what a JSON snapshot needs.
+ *
+ * Per-request rollups are intentionally NOT implemented here — `onScopeEnd`
+ * totals share the span names, so folding them in would double-count against
+ * the same rows. The per-request view lives in `perf_scope_total_ms` on the
+ * prometheus side.
+ */
+let InMemoryPerfSink = class InMemoryPerfSink extends PerfSink {
+    constructor() {
+        super(...arguments);
+        this.spans = new Map();
+        this.events = new Map();
+        this.truncated = false;
+    }
+    collect(metric) {
+        if (this.Enabled === false)
+            return;
+        if (!metric || typeof metric.name !== 'string')
+            return;
+        if (metric.kind === 'span') {
+            const entry = this.spans.get(metric.name) ?? (this.track(metric.name) ? this.create(this.spans, metric.name, { count: 0, totalMs: 0, maxMs: 0 }) : undefined);
+            if (!entry)
+                return;
+            const durationMs = metric.durationMs ?? 0;
+            entry.count += 1;
+            entry.totalMs += durationMs;
+            if (durationMs > entry.maxMs)
+                entry.maxMs = durationMs;
+            return;
+        }
+        const entry = this.events.get(metric.name) ?? (this.track(metric.name) ? this.create(this.events, metric.name, { count: 0, total: 0 }) : undefined);
+        if (!entry)
+            return;
+        entry.count += 1;
+        entry.total += metric.value ?? 1;
+    }
+    toJSON() {
+        const spans = [];
+        for (const [name, e] of this.spans) {
+            spans.push({ name, count: e.count, totalMs: e.totalMs, avgMs: e.count > 0 ? e.totalMs / e.count : 0, maxMs: e.maxMs });
+        }
+        spans.sort((a, b) => b.totalMs - a.totalMs);
+        const events = [];
+        for (const [name, e] of this.events) {
+            events.push({ name, count: e.count, total: e.total });
+        }
+        events.sort((a, b) => b.total - a.total);
+        return { truncated: this.truncated, spans, events };
+    }
+    /**
+     * Whether a NEW name may be tracked. Spans and events share one budget so the
+     * total retained-name count is what `maxNames` bounds.
+     */
+    track(_name) {
+        if (this.spans.size + this.events.size >= (this.MaxNames ?? 200)) {
+            this.truncated = true;
+            return false;
+        }
+        return true;
+    }
+    create(map, name, initial) {
+        map.set(name, initial);
+        return initial;
+    }
+};
+__decorate([
+    Config('telemetry.perf.enabled', { defaultValue: true }),
+    __metadata("design:type", Boolean)
+], InMemoryPerfSink.prototype, "Enabled", void 0);
+__decorate([
+    Config('telemetry.perf.maxNames', { defaultValue: 200 }),
+    __metadata("design:type", Number)
+], InMemoryPerfSink.prototype, "MaxNames", void 0);
+InMemoryPerfSink = __decorate([
+    Singleton(),
+    Injectable(PerfSink)
+], InMemoryPerfSink);
+export { InMemoryPerfSink };
+//# sourceMappingURL=InMemoryPerfSink.js.map

package/lib/mjs/InMemoryPerfSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryPerfSink.js","sourceRoot":"","sources":["../../src/InMemoryPerfSink.ts"],"names":[],"mappings":"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"}

package/lib/mjs/PromMetricSink.d.ts

@@ -0,0 +1,26 @@
+import { PerfSink, IPerfMetric, IPerfRollup } from "@spinajs/log";
+import { Counter, Histogram } from "prom-client";
+import { Metrics } from "./metrics.js";
+/** Duration histogram buckets ( ms ), mirroring the http telemetry middleware. */
+export declare const PERF_DURATION_BUCKETS_MS: number[];
+/**
+ * {@link PerfSink} that forwards perf measurements to the shared prom-client
+ * {@link Metrics} registry — the prom side of the dual-sink. Span durations go
+ * to `perf_span_duration_ms{name}`; counter/value events increment
+ * `perf_events_total{name}`; per-request scope totals go to their own
+ * `perf_scope_total_ms{name}` histogram so they don't conflate with the
+ * per-span distribution. Labels are restricted to `name` ( plus the metric's
+ * own low-cardinality labels are folded into the name label space via a single
+ * `name` label to stay bounded ).
+ */
+export declare class PromMetricSink extends PerfSink {
+    protected metrics: Metrics;
+    protected duration: Histogram<string>;
+    protected events: Counter<string>;
+    protected scopeTotal: Histogram<string>;
+    private defined;
+    private ensure;
+    collect(metric: IPerfMetric): void;
+    onScopeEnd(rollup: IPerfRollup): void;
+}
+//# sourceMappingURL=PromMetricSink.d.ts.map

package/lib/mjs/PromMetricSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromMetricSink.d.ts","sourceRoot":"","sources":["../../src/PromMetricSink.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,OAAO,EAAa,MAAM,cAAc,CAAC;AAElD,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,UAA6D,CAAC;AAEnG;;;;;;;;;GASG;AACH,qBAEa,cAAe,SAAQ,QAAQ;IAC1C,SAAS,CAAC,OAAO,EAAG,OAAO,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACvC,SAAS,CAAC,MAAM,EAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,SAAS,CAAC,UAAU,EAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,MAAM;IAcP,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IASlC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CAQ7C"}

package/lib/mjs/PromMetricSink.js

@@ -0,0 +1,65 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Singleton, Injectable, DI } from "@spinajs/di";
+import { PerfSink } from "@spinajs/log";
+import { Metrics } from "./metrics.js";
+/** Duration histogram buckets ( ms ), mirroring the http telemetry middleware. */
+export const PERF_DURATION_BUCKETS_MS = [1, 5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000];
+/**
+ * {@link PerfSink} that forwards perf measurements to the shared prom-client
+ * {@link Metrics} registry — the prom side of the dual-sink. Span durations go
+ * to `perf_span_duration_ms{name}`; counter/value events increment
+ * `perf_events_total{name}`; per-request scope totals go to their own
+ * `perf_scope_total_ms{name}` histogram so they don't conflate with the
+ * per-span distribution. Labels are restricted to `name` ( plus the metric's
+ * own low-cardinality labels are folded into the name label space via a single
+ * `name` label to stay bounded ).
+ */
+let PromMetricSink = class PromMetricSink extends PerfSink {
+    constructor() {
+        super(...arguments);
+        this.defined = false;
+    }
+    ensure() {
+        if (this.defined)
+            return;
+        this.metrics = DI.get(Metrics) ?? DI.resolve(Metrics);
+        const map = this.metrics.defineMetrics("perf", [
+            { name: "span_duration_ms", help: "Perf span duration in ms", type: "histogram", labelNames: ["name"], buckets: PERF_DURATION_BUCKETS_MS },
+            { name: "events_total", help: "Perf counter/value events", type: "counter", labelNames: ["name"] },
+            { name: "scope_total_ms", help: "Perf per-request scope total duration in ms", type: "histogram", labelNames: ["name"], buckets: PERF_DURATION_BUCKETS_MS },
+        ]);
+        this.duration = map["span_duration_ms"];
+        this.events = map["events_total"];
+        this.scopeTotal = map["scope_total_ms"];
+        this.defined = true;
+    }
+    collect(metric) {
+        this.ensure();
+        if (metric.kind === "span") {
+            this.duration.observe({ name: metric.name }, metric.durationMs ?? 0);
+        }
+        else {
+            this.events.inc({ name: metric.name }, metric.value ?? 1);
+        }
+    }
+    onScopeEnd(rollup) {
+        this.ensure();
+        for (const [name, e] of Object.entries(rollup.byName)) {
+            // per-request totals: record the aggregate duration once per request, into
+            // its own histogram so it doesn't conflate with the per-span distribution.
+            if (e.totalMs > 0)
+                this.scopeTotal.observe({ name }, e.totalMs);
+        }
+    }
+};
+PromMetricSink = __decorate([
+    Singleton(),
+    Injectable(PerfSink)
+], PromMetricSink);
+export { PromMetricSink };
+//# sourceMappingURL=PromMetricSink.js.map

package/lib/mjs/PromMetricSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromMetricSink.js","sourceRoot":"","sources":["../../src/PromMetricSink.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,QAAQ,EAA4B,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,OAAO,EAAa,MAAM,cAAc,CAAC;AAElD,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAEnG;;;;;;;;;GASG;AAGI,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,QAAQ;IAArC;;QAKG,YAAO,GAAG,KAAK,CAAC;IAiC1B,CAAC;IA/BS,MAAM;QACZ,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,GAAG,GAAc,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE;YACxD,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE;YAC1I,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE;YAClG,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,6CAA6C,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE;SAC5J,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,kBAAkB,CAAsB,CAAC;QAC7D,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,cAAc,CAAoB,CAAC;QACrD,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,gBAAgB,CAAsB,CAAC;QAC7D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAEM,OAAO,CAAC,MAAmB;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEM,UAAU,CAAC,MAAmB;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,2EAA2E;YAC3E,2EAA2E;YAC3E,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;CACF,CAAA;AAtCY,cAAc;IAF1B,SAAS,EAAE;IACX,UAAU,CAAC,QAAQ,CAAC;GACR,cAAc,CAsC1B"}

package/lib/mjs/bootstrap.d.ts

@@ -0,0 +1,13 @@
+import { Bootstrapper } from '@spinajs/di';
+/**
+ * Wires the telemetry collection layer at startup:
+ *
+ *  - registers prom-client's default process metrics against the PRIVATE
+ *    registry ( never the global default one ), when configured,
+ *  - builds the perf sinks and refreshes the Perf facade's sink list, so the
+ *    perf bridge is live in apps that use telemetry WITHOUT @spinajs/http.
+ */
+export declare class TelemetryBootstrapper extends Bootstrapper {
+    bootstrap(): void;
+}
+//# sourceMappingURL=bootstrap.d.ts.map

package/lib/mjs/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAM,MAAM,aAAa,CAAC;AAM3D;;;;;;;GAOG;AACH,qBACa,qBAAsB,SAAQ,YAAY;IAC9C,SAAS,IAAI,IAAI;CAiCzB"}

package/lib/mjs/bootstrap.js

@@ -0,0 +1,54 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Injectable, Bootstrapper, DI } from '@spinajs/di';
+import { Configuration } from '@spinajs/configuration';
+import { Perf, PerfSink } from '@spinajs/log';
+import { Metrics } from './metrics.js';
+/**
+ * Wires the telemetry collection layer at startup:
+ *
+ *  - registers prom-client's default process metrics against the PRIVATE
+ *    registry ( never the global default one ), when configured,
+ *  - builds the perf sinks and refreshes the Perf facade's sink list, so the
+ *    perf bridge is live in apps that use telemetry WITHOUT @spinajs/http.
+ */
+let TelemetryBootstrapper = class TelemetryBootstrapper extends Bootstrapper {
+    bootstrap() {
+        const cfg = DI.get(Configuration);
+        const metrics = DI.get(Metrics) ?? DI.resolve(Metrics);
+        if (cfg?.get('telemetry.collectDefaultMetrics', true)) {
+            metrics.collectDefault();
+        }
+        // Build the sinks through the ARRAY, never with a direct
+        // `DI.resolve( PromMetricSink )`. A direct resolve caches the instance under
+        // its own type name only; the later `Array.ofType( PerfSink )` — which is
+        // what the Perf facade uses — then hits that cache entry on its fast path,
+        // returns it WITHOUT adding it to the `PerfSink` list, and the facade stays
+        // blind to that sink. Resolving the array first creates them together.
+        const sinks = DI.resolve(Array.ofType(PerfSink));
+        // The array cache does not double as a per-type cache, so publish each
+        // instance under its own type name too. Without this a later
+        // `@Autoinject( InMemoryPerfSink )` ( the telemetry controller does exactly
+        // that ) would build a SECOND, permanently empty sink.
+        //
+        // `override` MUST be true: without it `asValue` APPENDS to an existing cache
+        // entry instead of replacing it, while the resolve fast path keeps handing
+        // out the entry it already had. So anything that resolved a sink directly
+        // BEFORE this bootstrapper ran — an earlier-ordered consumer bootstrapper,
+        // or an app still calling `DI.resolve( PromMetricSink )` — would pin
+        // `@Autoinject` to that earlier, permanently empty instance.
+        for (const sink of sinks) {
+            DI.register(sink).asValue(sink.constructor.name, true);
+        }
+        Perf.refreshSinks();
+    }
+};
+TelemetryBootstrapper = __decorate([
+    Injectable(Bootstrapper)
+], TelemetryBootstrapper);
+export { TelemetryBootstrapper };
+//# sourceMappingURL=bootstrap.js.map

package/lib/mjs/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;GAOG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,YAAY;IAC9C,SAAS;QACd,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEvD,IAAI,GAAG,EAAE,GAAG,CAAU,iCAAiC,EAAE,IAAI,CAAC,EAAE,CAAC;YAC/D,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,CAAC;QAED,yDAAyD;QACzD,6EAA6E;QAC7E,0EAA0E;QAC1E,2EAA2E;QAC3E,4EAA4E;QAC5E,uEAAuE;QACvE,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEjD,uEAAuE;QACvE,6DAA6D;QAC7D,4EAA4E;QAC5E,uDAAuD;QACvD,EAAE;QACF,6EAA6E;QAC7E,2EAA2E;QAC3E,0EAA0E;QAC1E,2EAA2E;QAC3E,qEAAqE;QACrE,6DAA6D;QAC7D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;CACF,CAAA;AAlCY,qBAAqB;IADjC,UAAU,CAAC,YAAY,CAAC;GACZ,qBAAqB,CAkCjC"}

package/lib/mjs/config/telemetry.d.ts

@@ -0,0 +1,63 @@
+declare const config: {
+    system: {
+        dirs: {
+            controllers: string[];
+        };
+    };
+    telemetry: {
+        auth: {
+            token: string;
+            /**
+             * Policy class name per endpoint. Each route resolves its policy by
+             * reading the config key below, so access can be tightened or loosened
+             * per endpoint without touching code.
+             */
+            policies: {
+                metrics: string;
+                stats: string;
+                timeline: string;
+                routes: string;
+                perf: string;
+                health: string;
+                ready: string;
+            };
+        };
+        /**
+         * Register prom-client's process / heap / cpu / event-loop metrics against
+         * the private registry at bootstrap.
+         */
+        collectDefaultMetrics: boolean;
+        /** Metric name prefix for the http telemetry metrics. */
+        prefix: string;
+        /** Duration histogram buckets in ms. */
+        buckets: number[];
+        /** Apdex satisfied threshold in ms; tolerated is 4x this. */
+        apdexThresholdMs: number;
+        timeline: {
+            /** Number of buckets retained in the ring. */
+            length: number;
+            /** Bucket width in ms. */
+            bucketMs: number;
+        };
+        routes: {
+            enabled: boolean;
+            /** Cap on distinct method+route keys held in memory. */
+            maxEntries: number;
+        };
+        perf: {
+            enabled: boolean;
+            /** Cap on distinct perf measurement names held in memory. */
+            maxNames: number;
+        };
+        health: {
+            /** Per-check timeout in ms. A timed-out check counts as down. */
+            timeoutMs: number;
+            /** When true a degraded overall status returns 503 rather than 200. */
+            failOnDegraded: boolean;
+            /** Reported by /telemetry/health. Omitted from the response when unset. */
+            version: string | undefined;
+        };
+    };
+};
+export default config;
+//# sourceMappingURL=telemetry.d.ts.map

package/lib/mjs/config/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/config/telemetry.ts"],"names":[],"mappings":"AAcA,QAAA,MAAM,MAAM;;;;;;;;;YAYN;;;;eAIG;;;;;;;;;;;QAcL;;;WAGG;;QAGH,yDAAyD;;QAGzD,wCAAwC;;QAGxC,6DAA6D;;;YAI3D,8CAA8C;;YAE9C,0BAA0B;;;;;YAM1B,wDAAwD;;;;;YAMxD,6DAA6D;;;;YAK7D,iEAAiE;;YAEjE,uEAAuE;;YAEvE,2EAA2E;qBACrD,MAAM,GAAG,SAAS;;;CAG7C,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/lib/mjs/config/telemetry.js

@@ -0,0 +1,76 @@
+import { join, normalize, resolve } from 'path';
+function dir(path) {
+    const inCommonJs = typeof module !== 'undefined';
+    return resolve(normalize(join(process.env.WORKSPACE_ROOT_PATH ?? process.cwd(), 'node_modules', '@spinajs', 'telemetry', 'lib', inCommonJs ? 'cjs' : 'mjs', path)));
+}
+/**
+ * Duration histogram bucket boundaries ( ms ) for http request timing. Kept in
+ * sync with DURATION_BUCKETS_MS in middleware.ts, which is the compile-time
+ * default when no configuration is present.
+ */
+const DURATION_BUCKETS_MS = [5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000];
+const config = {
+    system: {
+        dirs: {
+            controllers: [dir('controllers')],
+        },
+    },
+    telemetry: {
+        auth: {
+            // set this in your project
+            token: '',
+            /**
+             * Policy class name per endpoint. Each route resolves its policy by
+             * reading the config key below, so access can be tightened or loosened
+             * per endpoint without touching code.
+             */
+            policies: {
+                metrics: 'TelemetryTokenPolicy',
+                stats: 'TelemetryTokenPolicy',
+                timeline: 'TelemetryTokenPolicy',
+                routes: 'TelemetryTokenPolicy',
+                perf: 'TelemetryTokenPolicy',
+                // probe endpoints must be reachable without credentials
+                health: 'PublicPolicy',
+                ready: 'PublicPolicy',
+            },
+        },
+        /**
+         * Register prom-client's process / heap / cpu / event-loop metrics against
+         * the private registry at bootstrap.
+         */
+        collectDefaultMetrics: true,
+        /** Metric name prefix for the http telemetry metrics. */
+        prefix: 'http',
+        /** Duration histogram buckets in ms. */
+        buckets: DURATION_BUCKETS_MS,
+        /** Apdex satisfied threshold in ms; tolerated is 4x this. */
+        apdexThresholdMs: 25,
+        timeline: {
+            /** Number of buckets retained in the ring. */
+            length: 60,
+            /** Bucket width in ms. */
+            bucketMs: 60_000,
+        },
+        routes: {
+            enabled: true,
+            /** Cap on distinct method+route keys held in memory. */
+            maxEntries: 500,
+        },
+        perf: {
+            enabled: true,
+            /** Cap on distinct perf measurement names held in memory. */
+            maxNames: 200,
+        },
+        health: {
+            /** Per-check timeout in ms. A timed-out check counts as down. */
+            timeoutMs: 2000,
+            /** When true a degraded overall status returns 503 rather than 200. */
+            failOnDegraded: false,
+            /** Reported by /telemetry/health. Omitted from the response when unset. */
+            version: undefined,
+        },
+    },
+};
+export default config;
+//# sourceMappingURL=telemetry.js.map

package/lib/mjs/config/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../src/config/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEhD,SAAS,GAAG,CAAC,IAAY;IACvB,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC;IACjD,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AACtK,CAAC;AAED;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAEpF,MAAM,MAAM,GAAG;IACb,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,WAAW,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;SAClC;KACF;IAED,SAAS,EAAE;QACT,IAAI,EAAE;YACJ,2BAA2B;YAC3B,KAAK,EAAE,EAAE;YAET;;;;eAIG;YACH,QAAQ,EAAE;gBACR,OAAO,EAAE,sBAAsB;gBAC/B,KAAK,EAAE,sBAAsB;gBAC7B,QAAQ,EAAE,sBAAsB;gBAChC,MAAM,EAAE,sBAAsB;gBAC9B,IAAI,EAAE,sBAAsB;gBAE5B,wDAAwD;gBACxD,MAAM,EAAE,cAAc;gBACtB,KAAK,EAAE,cAAc;aACtB;SACF;QAED;;;WAGG;QACH,qBAAqB,EAAE,IAAI;QAE3B,yDAAyD;QACzD,MAAM,EAAE,MAAM;QAEd,wCAAwC;QACxC,OAAO,EAAE,mBAAmB;QAE5B,6DAA6D;QAC7D,gBAAgB,EAAE,EAAE;QAEpB,QAAQ,EAAE;YACR,8CAA8C;YAC9C,MAAM,EAAE,EAAE;YACV,0BAA0B;YAC1B,QAAQ,EAAE,MAAM;SACjB;QAED,MAAM,EAAE;YACN,OAAO,EAAE,IAAI;YACb,wDAAwD;YACxD,UAAU,EAAE,GAAG;SAChB;QAED,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,6DAA6D;YAC7D,QAAQ,EAAE,GAAG;SACd;QAED,MAAM,EAAE;YACN,iEAAiE;YACjE,SAAS,EAAE,IAAI;YACf,uEAAuE;YACvE,cAAc,EAAE,KAAK;YACrB,2EAA2E;YAC3E,OAAO,EAAE,SAA+B;SACzC;KACF;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/lib/mjs/controllers/Metrics.d.ts

@@ -0,0 +1,26 @@
+import { BaseController } from '@spinajs/http';
+import { Metrics } from './../metrics.js';
+import { PrometheusResponse } from './../responses.js';
+import './../policies/TelemetryTokenPolicy.js';
+import './../policies/PublicPolicy.js';
+/**
+ * Prometheus scrape endpoint.
+ *
+ * Deliberately kept at the bare `/metrics` path rather than under the
+ * `/telemetry` prefix used by the JSON api — this is the path existing
+ * `scrape_configs` already point at.
+ */
+export declare class MetricsController extends BaseController {
+    protected MetricsService: Metrics;
+    /**
+     * Prometheus exposition text for every metric on the registry: the `http_*`
+     * request metrics, the `perf_*` bridge metrics, any application metrics
+     * declared through `Metrics.defineMetrics`, and — when
+     * `telemetry.collectDefaultMetrics` is on — the `process_*` / `nodejs_*` set.
+     *
+     * @response 200 {string} Prometheus exposition text ( text/plain )
+     * @response 403 Access token missing or invalid
+     */
+    getMetrics(): Promise<PrometheusResponse>;
+}
+//# sourceMappingURL=Metrics.d.ts.map

package/lib/mjs/controllers/Metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metrics.d.ts","sourceRoot":"","sources":["../../../src/controllers/Metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,cAAc,EAAe,MAAM,eAAe,CAAC;AAGtE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAUvD,OAAO,uCAAuC,CAAC;AAC/C,OAAO,+BAA+B,CAAC;AAEvC;;;;;;GAMG;AACH,qBACa,iBAAkB,SAAQ,cAAc;IAEnD,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC;IAElC;;;;;;;;OAQG;IAGU,UAAU;CAGxB"}