@spinajs/telemetry-otel 2.0.507

package/lib/mjs/longSpanRegistry.js

@@ -0,0 +1,173 @@
+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 { Injectable, Singleton, AsyncService, Autoinject } from '@spinajs/di';
+import { Config } from '@spinajs/configuration';
+import { Log, Logger } from '@spinajs/log';
+import { SpanStatusCode, trace, context, ROOT_CONTEXT } from '@opentelemetry/api';
+import { OtelTracing } from './tracing.js';
+/**
+ * Keyed registry for long-lived spans (minutes) that cannot be scoped to one
+ * async call — e.g. one root span per payment transaction, opened when the
+ * transaction starts and closed by whichever handler sees the terminal state.
+ *
+ * Every method is a guarded no-op when tracing is disabled, the key is unknown
+ * or the underlying OTel call throws: observability must never break the
+ * business flow. An orphan sweep force-closes spans that outlive
+ * `otel.longSpan.maxAgeMs` (crashed flows, lost terminal messages).
+ */
+let LongSpanRegistry = class LongSpanRegistry extends AsyncService {
+    constructor() {
+        super(...arguments);
+        this.spans = new Map();
+    }
+    /** Open a span under `key`; a stale span on the same key is closed as replaced. */
+    open(key, name, attrs) {
+        try {
+            const stale = this.spans.get(key);
+            if (stale) {
+                stale.span.setAttribute('replaced', true);
+                stale.span.setStatus({ code: SpanStatusCode.ERROR, message: 'replaced by a new span on the same key' });
+                stale.span.end();
+                this.spans.delete(key);
+            }
+            const span = this.tracing.tracer('paystation').startSpan(name, { attributes: attrs });
+            this.spans.set(key, { span, openedAt: Date.now() });
+            this.ensureSweepTimer();
+        }
+        catch (err) {
+            this.log.warn(`long-span open('${key}') failed: ${err.message}`);
+        }
+    }
+    /** Add a span event; no-op when key is undefined/unknown. */
+    event(key, name, attrs) {
+        try {
+            if (!key)
+                return;
+            this.spans.get(key)?.span.addEvent(name, attrs);
+        }
+        catch (err) {
+            this.log.warn(`long-span event('${key ?? ''}') failed: ${err.message}`);
+        }
+    }
+    setAttributes(key, attrs) {
+        try {
+            this.spans.get(key)?.span.setAttributes(attrs);
+        }
+        catch (err) {
+            this.log.warn(`long-span setAttributes('${key}') failed: ${err.message}`);
+        }
+    }
+    has(key) {
+        return this.spans.has(key);
+    }
+    /** Close and export the span; no-op for unknown keys. */
+    close(key, status, attrs) {
+        try {
+            const entry = this.spans.get(key);
+            if (!entry)
+                return;
+            if (attrs)
+                entry.span.setAttributes(attrs);
+            entry.span.setStatus({ code: status === 'ok' ? SpanStatusCode.OK : SpanStatusCode.ERROR });
+            entry.span.end();
+            this.spans.delete(key);
+            if (this.spans.size === 0)
+                this.stopSweepTimer();
+        }
+        catch (err) {
+            this.log.warn(`long-span close('${key}') failed: ${err.message}`);
+        }
+    }
+    /**
+     * Run `fn` inside a short span, parented into the open long span for `key`
+     * when there is one (giving kiosk round-trips a place in the transaction
+     * waterfall), standalone otherwise. Errors are recorded and re-thrown.
+     */
+    async childSpan(key, name, attrs, fn) {
+        let span;
+        try {
+            const parent = key ? this.spans.get(key)?.span : undefined;
+            const ctx = parent ? trace.setSpan(ROOT_CONTEXT, parent) : context.active();
+            span = this.tracing.tracer('paystation').startSpan(name, { attributes: attrs }, ctx);
+        }
+        catch (err) {
+            this.log.warn(`long-span childSpan('${name}') failed to start: ${err.message}`);
+        }
+        try {
+            const result = await fn();
+            span?.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (err) {
+            span?.recordException(err);
+            span?.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
+            throw err;
+        }
+        finally {
+            span?.end();
+        }
+    }
+    /** Force-close spans that outlived `maxAgeMs` (public for tests). */
+    sweep() {
+        const cutoff = Date.now() - this.maxAgeMs;
+        for (const [key, entry] of this.spans) {
+            if (entry.openedAt <= cutoff) {
+                this.log.warn(`long-span '${key}' exceeded maxAgeMs; closing as orphaned`);
+                entry.span.setAttribute('orphaned', true);
+                entry.span.setStatus({ code: SpanStatusCode.ERROR, message: 'span outlived otel.longSpan.maxAgeMs' });
+                entry.span.end();
+                this.spans.delete(key);
+            }
+        }
+        if (this.spans.size === 0)
+            this.stopSweepTimer();
+    }
+    ensureSweepTimer() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.sweep(), this.sweepIntervalMs);
+        this.timer.unref?.();
+    }
+    stopSweepTimer() {
+        if (!this.timer)
+            return;
+        clearInterval(this.timer);
+        this.timer = undefined;
+    }
+    async dispose() {
+        for (const key of [...this.spans.keys()]) {
+            this.close(key, 'error', { shutdown: true });
+        }
+        this.stopSweepTimer();
+        await super.dispose();
+    }
+};
+__decorate([
+    Logger('otel'),
+    __metadata("design:type", Log)
+], LongSpanRegistry.prototype, "log", void 0);
+__decorate([
+    Autoinject(OtelTracing),
+    __metadata("design:type", OtelTracing)
+], LongSpanRegistry.prototype, "tracing", void 0);
+__decorate([
+    Config('otel.longSpan.maxAgeMs', { defaultValue: 30 * 60_000 }),
+    __metadata("design:type", Number)
+], LongSpanRegistry.prototype, "maxAgeMs", void 0);
+__decorate([
+    Config('otel.longSpan.sweepIntervalMs', { defaultValue: 60_000 }),
+    __metadata("design:type", Number)
+], LongSpanRegistry.prototype, "sweepIntervalMs", void 0);
+LongSpanRegistry = __decorate([
+    Singleton(),
+    Injectable()
+], LongSpanRegistry);
+export { LongSpanRegistry };
+//# sourceMappingURL=longSpanRegistry.js.map

package/lib/mjs/longSpanRegistry.js.map

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

package/lib/mjs/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/mjs/tracing.d.ts

@@ -0,0 +1,36 @@
+import { AsyncService } from '@spinajs/di';
+import { Log } from '@spinajs/log';
+import { Tracer, Span, Attributes } from '@opentelemetry/api';
+import { SpanProcessor } from '@opentelemetry/sdk-trace-base';
+/**
+ * Boots a private OTel NodeTracerProvider with an OTLP/HTTP trace exporter.
+ *
+ * Config-driven and disabled by default: with `otel.enabled=false` no provider
+ * is created and `tracer()` hands out the OTel API no-op tracer, so call sites
+ * cost nothing. The provider is intentionally NOT registered as the OTel
+ * global — consumers get tracers through this service.
+ *
+ * `start( processor )` accepts a processor override so tests can plug an
+ * InMemorySpanExporter without any network.
+ */
+export declare class OtelTracing extends AsyncService {
+    protected log: Log;
+    protected enabled: boolean;
+    protected endpoint: string;
+    protected serviceName: string;
+    protected resourceAttributes: Record<string, string>;
+    private provider?;
+    /**
+     * Create the provider (idempotent, no-op when disabled). Call after the
+     * Configuration service is resolved so the @Config fields are populated.
+     */
+    start(processorOverride?: SpanProcessor): void;
+    get active(): boolean;
+    /** A tracer from the private provider, or the API no-op tracer when off. */
+    tracer(name: string): Tracer;
+    /** Run `fn` inside a span; records exceptions and sets ERROR status on throw. */
+    withSpan<T>(name: string, attrs: Attributes, fn: (span: Span) => Promise<T>): Promise<T>;
+    flush(): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=tracing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,YAAY,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAS,MAAM,EAAE,IAAI,EAAkB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAsB,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAKlF;;;;;;;;;;GAUG;AACH,qBAEa,WAAY,SAAQ,YAAY;IAE3C,SAAS,CAAC,GAAG,EAAG,GAAG,CAAC;IAGpB,SAAS,CAAC,OAAO,EAAG,OAAO,CAAC;IAG5B,SAAS,CAAC,QAAQ,EAAG,MAAM,CAAC;IAG5B,SAAS,CAAC,WAAW,EAAG,MAAM,CAAC;IAG/B,SAAS,CAAC,kBAAkB,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtD,OAAO,CAAC,QAAQ,CAAC,CAAqB;IAEtC;;;OAGG;IACI,KAAK,CAAC,iBAAiB,CAAC,EAAE,aAAa,GAAG,IAAI,CAWpD;IAED,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,4EAA4E;IACrE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElC;IAED,iFAAiF;IACpE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAapG;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAElC;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAIpC;CACF"}

package/lib/mjs/tracing.js

@@ -0,0 +1,105 @@
+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 { Injectable, Singleton, AsyncService } from '@spinajs/di';
+import { Config } from '@spinajs/configuration';
+import { Log, Logger } from '@spinajs/log';
+import { trace, SpanStatusCode } from '@opentelemetry/api';
+import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';
+/**
+ * Boots a private OTel NodeTracerProvider with an OTLP/HTTP trace exporter.
+ *
+ * Config-driven and disabled by default: with `otel.enabled=false` no provider
+ * is created and `tracer()` hands out the OTel API no-op tracer, so call sites
+ * cost nothing. The provider is intentionally NOT registered as the OTel
+ * global — consumers get tracers through this service.
+ *
+ * `start( processor )` accepts a processor override so tests can plug an
+ * InMemorySpanExporter without any network.
+ */
+let OtelTracing = class OtelTracing extends AsyncService {
+    /**
+     * Create the provider (idempotent, no-op when disabled). Call after the
+     * Configuration service is resolved so the @Config fields are populated.
+     */
+    start(processorOverride) {
+        if (!this.enabled || this.provider) {
+            return;
+        }
+        const resource = resourceFromAttributes({
+            [ATTR_SERVICE_NAME]: this.serviceName,
+            ...this.resourceAttributes,
+        });
+        const processor = processorOverride ?? new BatchSpanProcessor(new OTLPTraceExporter({ url: this.endpoint }));
+        this.provider = new NodeTracerProvider({ resource, spanProcessors: [processor] });
+        this.log.info(`otel tracing started (service=${this.serviceName}, endpoint=${this.endpoint})`);
+    }
+    get active() {
+        return this.provider !== undefined;
+    }
+    /** A tracer from the private provider, or the API no-op tracer when off. */
+    tracer(name) {
+        return this.provider ? this.provider.getTracer(name) : trace.getTracer(name);
+    }
+    /** Run `fn` inside a span; records exceptions and sets ERROR status on throw. */
+    async withSpan(name, attrs, fn) {
+        const span = this.tracer('spinajs').startSpan(name, { attributes: attrs });
+        try {
+            const result = await fn(span);
+            span.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (err) {
+            span.recordException(err);
+            span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    }
+    async flush() {
+        await this.provider?.forceFlush();
+    }
+    async dispose() {
+        await this.provider?.shutdown();
+        this.provider = undefined;
+        await super.dispose();
+    }
+};
+__decorate([
+    Logger('otel'),
+    __metadata("design:type", Log)
+], OtelTracing.prototype, "log", void 0);
+__decorate([
+    Config('otel.enabled', { defaultValue: false }),
+    __metadata("design:type", Boolean)
+], OtelTracing.prototype, "enabled", void 0);
+__decorate([
+    Config('otel.endpoint', { defaultValue: 'https://otel.highlight.io:4318/v1/traces' }),
+    __metadata("design:type", String)
+], OtelTracing.prototype, "endpoint", void 0);
+__decorate([
+    Config('otel.serviceName', { defaultValue: 'spinajs-app' }),
+    __metadata("design:type", String)
+], OtelTracing.prototype, "serviceName", void 0);
+__decorate([
+    Config('otel.resourceAttributes', { defaultValue: {} }),
+    __metadata("design:type", Object)
+], OtelTracing.prototype, "resourceAttributes", void 0);
+OtelTracing = __decorate([
+    Singleton(),
+    Injectable()
+], OtelTracing);
+export { OtelTracing };
+//# sourceMappingURL=tracing.js.map

package/lib/mjs/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/tracing.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAgB,cAAc,EAAc,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAiB,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE;;;;;;;;;;GAUG;AAGI,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,YAAY;IAkB3C;;;OAGG;IACI,KAAK,CAAC,iBAAiC;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,sBAAsB,CAAC;YACtC,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC,WAAW;YACrC,GAAG,IAAI,CAAC,kBAAkB;SAC3B,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,iBAAiB,IAAI,IAAI,kBAAkB,CAAC,IAAI,iBAAiB,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC7G,IAAI,CAAC,QAAQ,GAAG,IAAI,kBAAkB,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iCAAiC,IAAI,CAAC,WAAW,cAAc,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACjG,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC;IACrC,CAAC;IAED,4EAA4E;IACrE,MAAM,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC;IAED,iFAAiF;IAC1E,KAAK,CAAC,QAAQ,CAAI,IAAY,EAAE,KAAiB,EAAE,EAA8B;QACtF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,eAAe,CAAC,GAAY,CAAC,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAChF,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,MAAM,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACF,CAAA;AAnEW;IADT,MAAM,CAAC,MAAM,CAAC;8BACC,GAAG;wCAAC;AAGV;IADT,MAAM,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;;4CACpB;AAGlB;IADT,MAAM,CAAC,eAAe,EAAE,EAAE,YAAY,EAAE,0CAA0C,EAAE,CAAC;;6CAC1D;AAGlB;IADT,MAAM,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;;gDAC7B;AAGrB;IADT,MAAM,CAAC,yBAAyB,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;;uDACF;AAd3C,WAAW;IAFvB,SAAS,EAAE;IACX,UAAU,EAAE;GACA,WAAW,CAqEvB"}