@dxos/observability 0.10.0 → 0.11.0

package/dist/lib/node-esm/traces-74F7JUKF.mjs

@@ -1,125 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-import {
-  resolveOtlpUrl
-} from "./chunk-EDDZWPYV.mjs";
-import "./chunk-HSLMI22Q.mjs";
-
-// src/extensions/otel/traces.ts
-import { ROOT_CONTEXT, SpanStatusCode, context as otelContext, propagation, trace } from "@opentelemetry/api";
-import { W3CTraceContextPropagator } from "@opentelemetry/core";
-import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { BasicTracerProvider, BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
-import { ATTR_SERVICE_VERSION } from "@opentelemetry/semantic-conventions";
-import { log as log2 } from "@dxos/log";
-import { TRACE_PROCESSOR } from "@dxos/tracing";
-
-// src/extensions/otel/span-processors.ts
-import { log } from "@dxos/log";
-var __dxlog_file = "/__w/dxos/dxos/packages/sdk/observability/src/extensions/otel/span-processors.ts";
-var TagInjectorSpanProcessor = class {
-  _getTags;
-  constructor(_getTags) {
-    this._getTags = _getTags;
-  }
-  onStart(span, _parentContext) {
-    let tags;
-    try {
-      tags = this._getTags();
-    } catch (err) {
-      log.catch(err, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 28, S: this });
-      return;
-    }
-    for (const [key, value] of Object.entries(tags)) {
-      span.setAttribute(key, value);
-    }
-  }
-  onEnd(_span) {
-  }
-  async shutdown() {
-  }
-  async forceFlush() {
-  }
-};
-
-// src/extensions/otel/traces.ts
-var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/observability/src/extensions/otel/traces.ts";
-var OtelTraces = class {
-  options;
-  _tracer;
-  _tracerProvider;
-  constructor(options) {
-    this.options = options;
-    propagation.setGlobalPropagator(new W3CTraceContextPropagator());
-    this._tracerProvider = new BasicTracerProvider({
-      resource: this.options.resource,
-      spanProcessors: [
-        new TagInjectorSpanProcessor(this.options.getTags),
-        new BatchSpanProcessor(new OTLPTraceExporter({
-          url: resolveOtlpUrl(this.options.endpoint + "/v1/traces"),
-          headers: this.options.headers,
-          concurrencyLimit: 10
-        }))
-      ]
-    });
-    trace.setGlobalTracerProvider(this._tracerProvider);
-    this._tracer = trace.getTracer("dxos-observability", this.options.resource.attributes[ATTR_SERVICE_VERSION]?.toString());
-  }
-  /**
-  * Forcibly flush the BatchSpanProcessor. Call before process exit to avoid
-  * losing queued spans (which manifests as "Missing Span" in SigNoz — their
-  * already-exported children reference a parent that never made it to OTLP).
-  */
-  async flush() {
-    await this._tracerProvider.forceFlush();
-  }
-  /**
-  * Flush + shut down the tracer provider via `BasicTracerProvider.shutdown()`,
-  * which forces a final export then terminates all span processors.
-  *
-  * Terminal and effectively one-shot: safe to call after `flush()`, but
-  * `flush()` MUST NOT be called after `close()` — shutdown stops further
-  * exporting, so subsequent `close()`/`flush()` calls resolve without
-  * emitting new spans.
-  */
-  async close() {
-    await this._tracerProvider.shutdown();
-  }
-  start() {
-    log2("trace processor registered", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 53, S: this });
-    const tracer = this._tracer;
-    TRACE_PROCESSOR.tracingBackend = {
-      startSpan: (options) => {
-        log2("begin otel trace", {
-          options
-        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 57, S: this });
-        const parentCtx = options.parentContext ? propagation.extract(ROOT_CONTEXT, {
-          traceparent: options.parentContext.traceparent,
-          tracestate: options.parentContext.tracestate ?? ""
-        }) : otelContext.active();
-        const span = tracer.startSpan(options.name, options, parentCtx);
-        const sc = span.spanContext();
-        const spanContext = sc && sc.traceId && sc.spanId ? {
-          traceparent: `00-${sc.traceId}-${sc.spanId}-${(sc.traceFlags ?? 0).toString(16).padStart(2, "0")}`,
-          tracestate: sc.traceState?.serialize()
-        } : void 0;
-        return {
-          end: (endTime) => span.end(endTime),
-          setError: (err) => {
-            if (err instanceof Error) {
-              span.recordException(err);
-            }
-            span.setStatus({
-              code: SpanStatusCode.ERROR,
-              message: err instanceof Error ? err.message : String(err)
-            });
-          },
-          spanContext
-        };
-      }
-    };
-  }
-};
-export {
-  OtelTraces
-};
-//# sourceMappingURL=traces-74F7JUKF.mjs.map

package/dist/lib/node-esm/traces-74F7JUKF.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/extensions/otel/traces.ts", "../../../src/extensions/otel/span-processors.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport {\n  ROOT_CONTEXT,\n  SpanStatusCode,\n  type Tracer,\n  context as otelContext,\n  propagation,\n  trace,\n} from '@opentelemetry/api';\nimport { W3CTraceContextPropagator } from '@opentelemetry/core';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport { BasicTracerProvider, BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';\nimport { ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';\n\nimport { log } from '@dxos/log';\nimport { type RemoteSpan, type StartSpanOptions, TRACE_PROCESSOR } from '@dxos/tracing';\n\nimport { type OtelOptions, resolveOtlpUrl } from './otel';\nimport { TagInjectorSpanProcessor } from './span-processors';\n\nexport class OtelTraces {\n  private _tracer: Tracer;\n  private readonly _tracerProvider: BasicTracerProvider;\n\n  constructor(private readonly options: OtelOptions) {\n    propagation.setGlobalPropagator(new W3CTraceContextPropagator());\n\n    this._tracerProvider = new BasicTracerProvider({\n      resource: this.options.resource,\n      spanProcessors: [\n        new TagInjectorSpanProcessor(this.options.getTags),\n        new BatchSpanProcessor(\n          new OTLPTraceExporter({\n            url: resolveOtlpUrl(this.options.endpoint + '/v1/traces'),\n            headers: this.options.headers,\n            concurrencyLimit: 10,\n          }),\n        ),\n      ],\n    });\n\n    trace.setGlobalTracerProvider(this._tracerProvider);\n    this._tracer = trace.getTracer(\n      'dxos-observability',\n      this.options.resource.attributes[ATTR_SERVICE_VERSION]?.toString(),\n    );\n  }\n\n  /**\n   * Forcibly flush the BatchSpanProcessor. Call before process exit to avoid\n   * losing queued spans (which manifests as \"Missing Span\" in SigNoz — their\n   * already-exported children reference a parent that never made it to OTLP).\n   */\n  public async flush(): Promise<void> {\n    await this._tracerProvider.forceFlush();\n  }\n\n  /**\n   * Flush + shut down the tracer provider via `BasicTracerProvider.shutdown()`,\n   * which forces a final export then terminates all span processors.\n   *\n   * Terminal and effectively one-shot: safe to call after `flush()`, but\n   * `flush()` MUST NOT be called after `close()` — shutdown stops further\n   * exporting, so subsequent `close()`/`flush()` calls resolve without\n   * emitting new spans.\n   */\n  public async close(): Promise<void> {\n    await this._tracerProvider.shutdown();\n  }\n\n  public start(): void {\n    log('trace processor registered');\n\n    const tracer = this._tracer;\n\n    TRACE_PROCESSOR.tracingBackend = {\n      startSpan: (options: StartSpanOptions): RemoteSpan => {\n        log('begin otel trace', { options });\n        const parentCtx = options.parentContext\n          ? propagation.extract(ROOT_CONTEXT, {\n              traceparent: options.parentContext.traceparent,\n              tracestate: options.parentContext.tracestate ?? '',\n            })\n          : otelContext.active();\n\n        const span = tracer.startSpan(options.name, options, parentCtx);\n\n        const sc = span.spanContext();\n        const spanContext =\n          sc && sc.traceId && sc.spanId\n            ? {\n                traceparent: `00-${sc.traceId}-${sc.spanId}-${(sc.traceFlags ?? 0).toString(16).padStart(2, '0')}`,\n                tracestate: sc.traceState?.serialize(),\n              }\n            : undefined;\n\n        return {\n          end: (endTime?: number) => span.end(endTime),\n          setError: (err: unknown) => {\n            if (err instanceof Error) {\n              span.recordException(err);\n            }\n            span.setStatus({ code: SpanStatusCode.ERROR, message: err instanceof Error ? err.message : String(err) });\n          },\n          spanContext,\n        };\n      },\n    };\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Context } from '@opentelemetry/api';\nimport { type ReadableSpan, type Span, type SpanProcessor } from '@opentelemetry/sdk-trace-base';\n\nimport { log } from '@dxos/log';\n\n/**\n * Injects dynamic tags as attributes on every span.\n *\n * This is an `onStart`-only processor; `onEnd`/`shutdown`/`forceFlush` are no-ops\n * because this processor never holds pending work (delegates export to downstream\n * processors like BatchSpanProcessor).\n *\n * Use for tags that are not known at provider construction (e.g. identity\n * resolved asynchronously after login). For values known at startup, prefer\n * putting them on the `Resource` — see `extension.ts`.\n *\n * Failures in the tag provider are swallowed so they can never break span\n * recording (the processor is best-effort and runs on the startSpan hot path).\n */\nexport class TagInjectorSpanProcessor implements SpanProcessor {\n  constructor(private readonly _getTags: () => Record<string, string>) {}\n\n  onStart(span: Span, _parentContext: Context): void {\n    let tags: Record<string, string>;\n    try {\n      tags = this._getTags();\n    } catch (err) {\n      log.catch(err);\n      return;\n    }\n    for (const [key, value] of Object.entries(tags)) {\n      span.setAttribute(key, value);\n    }\n  }\n\n  onEnd(_span: ReadableSpan): void {}\n\n  async shutdown(): Promise<void> {}\n\n  async forceFlush(): Promise<void> {}\n}\n"],
-  "mappings": ";;;;;;;AAIA,SACEA,cACAC,gBAEAC,WAAWC,aACXC,aACAC,aACK;AACP,SAASC,iCAAiC;AAC1C,SAASC,yBAAyB;AAClC,SAASC,qBAAqBC,0BAA0B;AACxD,SAASC,4BAA4B;AAErC,SAASC,OAAAA,YAAW;AACpB,SAAiDC,uBAAuB;;;ACXxE,SAASC,WAAW;AAEpB,IAAA,eAAA;AAeE,IAA6BC,2BAA7B,MAAqE;;EAAC,YAAA,UAAA;AAEtEC,SAAQC,WAAYC;;UAEd,MAAA,gBAAA;QACFC;AACF,QAAE;AACAL,aAAIM,KAAMC,SAAAA;aACV,KAAA;AACF,UAAA,MAAA,KAAA,QAAA,EAAA,YAAA,YAAA,GAAA,cAAA,GAAA,IAAA,GAAA,KAAA,CAAA;AACA;;AAEA,eAAA,CAAA,KAAA,KAAA,KAAA,OAAA,QAAA,IAAA,GAAA;AACF,WAAA,aAAA,KAAA,KAAA;IAEAC;EAEA;EAEA,MAAMC,OAAAA;EAAAA;EACR,MAAA,WAAA;EAAA;;;;;;ADrBA,IAAAC,gBAAaC;AACHC,IAAgB,aAAhBA,MAAgB;EACPC;EAEjB;;cACEC,SAAYC;AAEZ,SAAKF,UAAAA;gBACHG,oBAAuBA,IAAQ,0BAAA,CAAA;SAC/BC,kBAAgB,IAAA,oBAAA;gBACVC,KAAAA,QAAAA;sBACAC;YAEAC,yBAAyBC,KAAAA,QAAQC,OAAW;YAC5CC,mBAAcF,IAAQE,kBAAO;UAC7BC,KAAAA,eAAkB,KAAA,QAAA,WAAA,YAAA;UACpB,SAAA,KAAA,QAAA;UAEH,kBAAA;QACH,CAAA,CAAA;MAEAC;IACA,CAAA;AAIF,UAAA,wBAAA,KAAA,eAAA;AAEA,SAAA,UAAA,MAAA,UAAA,sBAAA,KAAA,QAAA,SAAA,WAAA,oBAAA,GAAA,SAAA,CAAA;;;;;;;EAOA,MAAA,QAAA;AAEA,UAAA,KAAA,gBAAA,WAAA;;;;;;;;;;;EAWA,MAAA,QAAA;AAEOC,UAAc,KAAA,gBAAA,SAAA;;UAGnB;AAEAC,IAAAA,KAAAA,8BAAiC,QAAA,EAAA,YAAA,YAAA,GAAAjB,eAAA,GAAA,IAAA,GAAA,KAAA,CAAA;UAC/BkB,SAAW,KAACP;oBACN,iBAAoB;iBAAEA,CAAAA,YAAAA;AAAQ,QAAAQ,KAAA,oBAAA;UAClC;yBAEMC,YAAqBC,GAAAA,eAAcD,GAAAA,IAAAA,GAAAA,KAAW,CAAA;cAC9CE,YAAYX,QAAQU,gBAAcC,YAAc,QAAA,cAAA;UAClD,aACYC,QAAM,cAAA;UAEtB,YAAaC,QAAON,cAAkBO,cAAMd;QAE5C,CAAA,IAAA,YAAgBe,OAAAA;AAChB,cAAMA,OAAAA,OACJC,UAASC,QAAO,MAAOC,SACnB,SAAA;cACET,KAAAA,KAAAA,YAAsBQ;cACtBN,cAAeQ,MAAAA,GAAU,WAAEC,GAAAA,SAAAA;UAE7BC,aAAAA,MAAAA,GAAAA,OAAAA,IAAAA,GAAAA,MAAAA,KAAAA,GAAAA,cAAAA,GAAAA,SAAAA,EAAAA,EAAAA,SAAAA,GAAAA,GAAAA,CAAAA;UAEN,YAAO,GAAA,YAAA,UAAA;YACLC;eACAC;eACE,CAAA,YAAIC,KAAAA,IAAeC,OAAO;oBACxBC,CAAAA,QAAKC;AACP,gBAAA,eAAA,OAAA;AACAD,mBAAKE,gBAAU,GAAA;;iBAA8BC,UAASL;cAAiD,MAAA,eAAA;cACzG,SAAA,eAAA,QAAA,IAAA,UAAA,OAAA,GAAA;YACAT,CAAAA;UACF;UACF;QACF;MACF;IACF;;;",
-  "names": ["ROOT_CONTEXT", "SpanStatusCode", "context", "otelContext", "propagation", "trace", "W3CTraceContextPropagator", "OTLPTraceExporter", "BasicTracerProvider", "BatchSpanProcessor", "ATTR_SERVICE_VERSION", "log", "TRACE_PROCESSOR", "log", "_getTags", "onStart", "span", "_parentContext", "tags", "catch", "err", "onEnd", "forceFlush", "__dxlog_file", "OtelTraces", "_tracer", "_tracerProvider", "propagation", "setGlobalPropagator", "resource", "spanProcessors", "TagInjectorSpanProcessor", "BatchSpanProcessor", "url", "options", "endpoint", "headers", "concurrencyLimit", "trace", "start", "TRACE_PROCESSOR", "startSpan", "log", "traceparent", "parentContext", "tracestate", "active", "tracer", "name", "spanContext", "sc", "traceId", "spanId", "traceState", "serialize", "undefined", "end", "setError", "err", "Error", "span", "recordException", "setStatus", "message"]
-}