iii-sdk 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/{iii-DhZKdyS8.d.mts → iii-7FpY7bi9.d.mts} +24 -27
- package/dist/iii-7FpY7bi9.d.mts.map +1 -0
- package/dist/{iii-BZ-tGd_y.d.cts → iii-BhtLRYBs.d.cts} +24 -27
- package/dist/iii-BhtLRYBs.d.cts.map +1 -0
- package/dist/index.cjs +78 -49
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +7 -28
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.mts +7 -28
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +74 -45
- package/dist/index.mjs.map +1 -1
- package/dist/{otel-worker-gauges-bAp_yKcU.cjs → otel-worker-gauges-8AUNGQgJ.cjs} +39 -24
- package/dist/otel-worker-gauges-8AUNGQgJ.cjs.map +1 -0
- package/dist/{otel-worker-gauges-CshKEITX.mjs → otel-worker-gauges-Dka1CFDy.mjs} +38 -23
- package/dist/otel-worker-gauges-Dka1CFDy.mjs.map +1 -0
- package/dist/stream-Bzpo5JNV.d.mts.map +1 -1
- package/dist/telemetry.cjs +1 -1
- package/dist/telemetry.d.cts +1 -1
- package/dist/telemetry.d.mts +1 -1
- package/dist/telemetry.mjs +1 -1
- package/package.json +1 -1
- package/tests/healthcheck.test.ts +1 -1
- package/tests/otel-defaults.test.ts +268 -0
- package/tests/state.test.ts +20 -20
- package/tests/stream.test.ts +21 -21
- package/tests/utils.ts +1 -2
- package/dist/iii-BZ-tGd_y.d.cts.map +0 -1
- package/dist/iii-DhZKdyS8.d.mts.map +0 -1
- package/dist/otel-worker-gauges-CshKEITX.mjs.map +0 -1
- package/dist/otel-worker-gauges-bAp_yKcU.cjs.map +0 -1
|
@@ -3,7 +3,7 @@ import { WebSocket } from "ws";
|
|
|
3
3
|
import { SeverityNumber as SeverityNumber$1 } from "@opentelemetry/api-logs";
|
|
4
4
|
import { Resource } from "@opentelemetry/resources";
|
|
5
5
|
import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
|
|
6
|
-
import { randomUUID } from "crypto";
|
|
6
|
+
import { randomUUID } from "node:crypto";
|
|
7
7
|
import { SimpleSpanProcessor } from "@opentelemetry/sdk-trace-base";
|
|
8
8
|
import { MeterProvider, PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
|
|
9
9
|
import { CompositePropagator, ExportResultCode, W3CBaggagePropagator, W3CTraceContextPropagator } from "@opentelemetry/core";
|
|
@@ -19,9 +19,9 @@ import { monitorEventLoopDelay, performance } from "node:perf_hooks";
|
|
|
19
19
|
*/
|
|
20
20
|
/** Engine function paths for internal operations */
|
|
21
21
|
const EngineFunctions = {
|
|
22
|
-
LIST_FUNCTIONS: "engine
|
|
23
|
-
LIST_WORKERS: "engine
|
|
24
|
-
REGISTER_WORKER: "engine
|
|
22
|
+
LIST_FUNCTIONS: "engine::functions::list",
|
|
23
|
+
LIST_WORKERS: "engine::workers::list",
|
|
24
|
+
REGISTER_WORKER: "engine::workers::register"
|
|
25
25
|
};
|
|
26
26
|
/** Engine trigger types */
|
|
27
27
|
const EngineTriggers = {
|
|
@@ -30,10 +30,10 @@ const EngineTriggers = {
|
|
|
30
30
|
};
|
|
31
31
|
/** Log function paths */
|
|
32
32
|
const LogFunctions = {
|
|
33
|
-
INFO: "log
|
|
34
|
-
WARN: "log
|
|
35
|
-
ERROR: "log
|
|
36
|
-
DEBUG: "log
|
|
33
|
+
INFO: "engine::log::info",
|
|
34
|
+
WARN: "engine::log::warn",
|
|
35
|
+
ERROR: "engine::log::error",
|
|
36
|
+
DEBUG: "engine::log::debug"
|
|
37
37
|
};
|
|
38
38
|
/** Default reconnection configuration */
|
|
39
39
|
const DEFAULT_BRIDGE_RECONNECTION_CONFIG = {
|
|
@@ -63,6 +63,21 @@ const DEFAULT_RECONNECTION_CONFIG = {
|
|
|
63
63
|
jitterFactor: .3,
|
|
64
64
|
maxRetries: -1
|
|
65
65
|
};
|
|
66
|
+
/** Default configuration values for OpenTelemetry initialization. */
|
|
67
|
+
const DEFAULT_OTEL_CONFIG = {
|
|
68
|
+
enabled: true,
|
|
69
|
+
serviceName: "iii-node",
|
|
70
|
+
serviceVersion: "unknown",
|
|
71
|
+
engineWsUrl: "ws://localhost:49134",
|
|
72
|
+
metricsEnabled: true,
|
|
73
|
+
metricsExportIntervalMs: 6e4
|
|
74
|
+
};
|
|
75
|
+
/** Parse a boolean environment variable, recognizing 'false', '0', 'no', 'off' as false. */
|
|
76
|
+
function parseBoolEnv(value, defaultValue) {
|
|
77
|
+
if (value === void 0) return defaultValue;
|
|
78
|
+
const lower = value.toLowerCase();
|
|
79
|
+
return lower !== "false" && lower !== "0" && lower !== "no" && lower !== "off";
|
|
80
|
+
}
|
|
66
81
|
|
|
67
82
|
//#endregion
|
|
68
83
|
//#region src/telemetry-system/connection.ts
|
|
@@ -455,7 +470,7 @@ function currentSpanId() {
|
|
|
455
470
|
function injectTraceparent() {
|
|
456
471
|
const carrier = {};
|
|
457
472
|
propagation.inject(context.active(), carrier);
|
|
458
|
-
return carrier
|
|
473
|
+
return carrier.traceparent;
|
|
459
474
|
}
|
|
460
475
|
/**
|
|
461
476
|
* Extract a trace context from a W3C traceparent header string.
|
|
@@ -470,7 +485,7 @@ function extractTraceparent(traceparent) {
|
|
|
470
485
|
function injectBaggage() {
|
|
471
486
|
const carrier = {};
|
|
472
487
|
propagation.inject(context.active(), carrier);
|
|
473
|
-
return carrier
|
|
488
|
+
return carrier.baggage;
|
|
474
489
|
}
|
|
475
490
|
/**
|
|
476
491
|
* Extract baggage from a W3C baggage header string.
|
|
@@ -484,8 +499,8 @@ function extractBaggage(baggage) {
|
|
|
484
499
|
*/
|
|
485
500
|
function extractContext(traceparent, baggage) {
|
|
486
501
|
const carrier = {};
|
|
487
|
-
if (traceparent) carrier
|
|
488
|
-
if (baggage) carrier
|
|
502
|
+
if (traceparent) carrier.traceparent = traceparent;
|
|
503
|
+
if (baggage) carrier.baggage = baggage;
|
|
489
504
|
return propagation.extract(context.active(), carrier);
|
|
490
505
|
}
|
|
491
506
|
/**
|
|
@@ -543,16 +558,16 @@ let serviceName = "iii-node-iii";
|
|
|
543
558
|
* This should be called once at application startup.
|
|
544
559
|
*/
|
|
545
560
|
function initOtel(config = {}) {
|
|
546
|
-
if (!(config.enabled ?? (process.env.OTEL_ENABLED
|
|
547
|
-
console.
|
|
561
|
+
if (!(config.enabled ?? parseBoolEnv(process.env.OTEL_ENABLED, DEFAULT_OTEL_CONFIG.enabled))) {
|
|
562
|
+
console.debug("[OTel] OpenTelemetry is disabled. To enable, remove OTEL_ENABLED=false or set enabled: true in config.");
|
|
548
563
|
return;
|
|
549
564
|
}
|
|
550
565
|
if (config.instrumentations?.length) registerInstrumentations({ instrumentations: config.instrumentations });
|
|
551
|
-
serviceName = config.serviceName ?? process.env.OTEL_SERVICE_NAME ??
|
|
552
|
-
const serviceVersion = config.serviceVersion ?? process.env.SERVICE_VERSION ??
|
|
566
|
+
serviceName = config.serviceName ?? process.env.OTEL_SERVICE_NAME ?? DEFAULT_OTEL_CONFIG.serviceName;
|
|
567
|
+
const serviceVersion = config.serviceVersion ?? process.env.SERVICE_VERSION ?? DEFAULT_OTEL_CONFIG.serviceVersion;
|
|
553
568
|
const serviceNamespace = config.serviceNamespace ?? process.env.SERVICE_NAMESPACE;
|
|
554
569
|
const serviceInstanceId = config.serviceInstanceId ?? process.env.SERVICE_INSTANCE_ID ?? randomUUID();
|
|
555
|
-
const engineWsUrl = config.engineWsUrl ?? process.env.III_BRIDGE_URL ??
|
|
570
|
+
const engineWsUrl = config.engineWsUrl ?? process.env.III_BRIDGE_URL ?? DEFAULT_OTEL_CONFIG.engineWsUrl;
|
|
556
571
|
const resourceAttributes = {
|
|
557
572
|
[ATTR_SERVICE_NAME]: serviceName,
|
|
558
573
|
[ATTR_SERVICE_VERSION]: serviceVersion,
|
|
@@ -568,10 +583,10 @@ function initOtel(config = {}) {
|
|
|
568
583
|
propagation.setGlobalPropagator(new CompositePropagator({ propagators: [new W3CTraceContextPropagator(), new W3CBaggagePropagator()] }));
|
|
569
584
|
tracerProvider.register();
|
|
570
585
|
tracer = trace.getTracer(serviceName);
|
|
571
|
-
console.
|
|
572
|
-
if (config.metricsEnabled ?? (process.env.OTEL_METRICS_ENABLED
|
|
586
|
+
console.debug(`[OTel] Traces initialized: engine=${engineWsUrl}, service=${serviceName}`);
|
|
587
|
+
if (config.metricsEnabled ?? parseBoolEnv(process.env.OTEL_METRICS_ENABLED, DEFAULT_OTEL_CONFIG.metricsEnabled)) {
|
|
573
588
|
const metricsExporter = new EngineMetricsExporter(sharedConnection);
|
|
574
|
-
const exportIntervalMs = config.metricsExportIntervalMs ??
|
|
589
|
+
const exportIntervalMs = config.metricsExportIntervalMs ?? DEFAULT_OTEL_CONFIG.metricsExportIntervalMs;
|
|
575
590
|
meterProvider = new MeterProvider({
|
|
576
591
|
resource,
|
|
577
592
|
readers: [new PeriodicExportingMetricReader({
|
|
@@ -581,13 +596,13 @@ function initOtel(config = {}) {
|
|
|
581
596
|
});
|
|
582
597
|
metrics.setGlobalMeterProvider(meterProvider);
|
|
583
598
|
meter = meterProvider.getMeter(serviceName);
|
|
584
|
-
console.
|
|
599
|
+
console.debug(`[OTel] Metrics initialized: interval=${exportIntervalMs}ms`);
|
|
585
600
|
}
|
|
586
601
|
const logExporter = new EngineLogExporter(sharedConnection);
|
|
587
602
|
loggerProvider = new LoggerProvider({ resource });
|
|
588
603
|
loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(logExporter));
|
|
589
604
|
logger = loggerProvider.getLogger(serviceName);
|
|
590
|
-
console.
|
|
605
|
+
console.debug("[OTel] Logs initialized");
|
|
591
606
|
}
|
|
592
607
|
/**
|
|
593
608
|
* Shutdown OpenTelemetry, flushing any pending data.
|
|
@@ -905,4 +920,4 @@ function stopWorkerGauges() {
|
|
|
905
920
|
|
|
906
921
|
//#endregion
|
|
907
922
|
export { removeBaggageEntry as C, EngineFunctions as D, DEFAULT_INVOCATION_TIMEOUT_MS as E, EngineTriggers as O, injectTraceparent as S, DEFAULT_BRIDGE_RECONNECTION_CONFIG as T, extractContext as _, SeverityNumber$1 as a, getBaggageEntry as b, getLogger as c, initOtel as d, shutdownOtel as f, extractBaggage as g, currentTraceId as h, safeStringify as i, LogFunctions as k, getMeter as l, currentSpanId as m, stopWorkerGauges as n, SpanKind as o, withSpan as p, WorkerMetricsCollector as r, SpanStatusCode as s, registerWorkerGauges as t, getTracer as u, extractTraceparent as v, setBaggageEntry as w, injectBaggage as x, getAllBaggage as y };
|
|
908
|
-
//# sourceMappingURL=otel-worker-gauges-
|
|
923
|
+
//# sourceMappingURL=otel-worker-gauges-Dka1CFDy.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"otel-worker-gauges-Dka1CFDy.mjs","names":["DEFAULT_BRIDGE_RECONNECTION_CONFIG: IIIReconnectionConfig","DEFAULT_RECONNECTION_CONFIG: ReconnectionConfig","metrics","carrier: Record<string, string>","entries: Record<string, string>","sharedConnection: SharedEngineConnection | null","tracerProvider: NodeTracerProvider | null","meterProvider: MeterProvider | null","loggerProvider: LoggerProvider | null","tracer: Tracer | null","meter: Meter | null","logger: Logger | null","serviceName: string","resourceAttributes: Record<string, string>","noopSpan: Span","metricsCollector: WorkerMetricsCollector | null","registeredMeter: Meter | null","registeredBatchCallback: ((observableResult: BatchObservableResult) => void) | null","registeredObservables: Observable[]","meter","metrics"],"sources":["../src/iii-constants.ts","../src/telemetry-system/types.ts","../src/telemetry-system/connection.ts","../src/telemetry-system/span-exporter.ts","../src/telemetry-system/metrics-exporter.ts","../src/telemetry-system/log-exporter.ts","../src/telemetry-system/context.ts","../src/telemetry-system/index.ts","../src/utils.ts","../src/worker-metrics.ts","../src/otel-worker-gauges.ts"],"sourcesContent":["/**\n * Constants for the III module.\n */\n\n/** Engine function paths for internal operations */\nexport const EngineFunctions = {\n LIST_FUNCTIONS: 'engine::functions::list',\n LIST_WORKERS: 'engine::workers::list',\n REGISTER_WORKER: 'engine::workers::register',\n} as const\n\n/** Engine trigger types */\nexport const EngineTriggers = {\n FUNCTIONS_AVAILABLE: 'engine::functions-available',\n LOG: 'log',\n} as const\n\n/** Log function paths */\nexport const LogFunctions = {\n INFO: 'engine::log::info',\n WARN: 'engine::log::warn',\n ERROR: 'engine::log::error',\n DEBUG: 'engine::log::debug',\n} as const\n\n/** Connection state for the III WebSocket */\nexport type IIIConnectionState =\n | 'disconnected'\n | 'connecting'\n | 'connected'\n | 'reconnecting'\n | 'failed'\n\n/** Configuration for WebSocket reconnection behavior */\nexport interface IIIReconnectionConfig {\n /** Starting delay in milliseconds (default: 1000ms) */\n initialDelayMs: number\n /** Maximum delay cap in milliseconds (default: 30000ms) */\n maxDelayMs: number\n /** Exponential backoff multiplier (default: 2) */\n backoffMultiplier: number\n /** Random jitter factor 0-1 (default: 0.3) */\n jitterFactor: number\n /** Maximum retry attempts, -1 for infinite (default: -1) */\n maxRetries: number\n}\n\n/** Default reconnection configuration */\nexport const DEFAULT_BRIDGE_RECONNECTION_CONFIG: IIIReconnectionConfig = {\n initialDelayMs: 1000,\n maxDelayMs: 30000,\n backoffMultiplier: 2,\n jitterFactor: 0.3,\n maxRetries: -1,\n}\n\n/** Default invocation timeout in milliseconds */\nexport const DEFAULT_INVOCATION_TIMEOUT_MS = 30000\n","/**\n * Types, interfaces, and constants for the OpenTelemetry module.\n */\n\nimport type { Instrumentation } from '@opentelemetry/instrumentation'\n\n// Semantic convention constants for compatibility across versions\nexport const ATTR_SERVICE_VERSION = 'service.version'\nexport const ATTR_SERVICE_NAMESPACE = 'service.namespace'\nexport const ATTR_SERVICE_INSTANCE_ID = 'service.instance.id'\n\n/** Magic prefixes for binary frames over WebSocket */\nexport const PREFIX_TRACES = 'OTLP'\nexport const PREFIX_METRICS = 'MTRC'\nexport const PREFIX_LOGS = 'LOGS'\n\n/** Connection state for the shared WebSocket */\nexport type ConnectionState =\n | 'disconnected'\n | 'connecting'\n | 'connected'\n | 'reconnecting'\n | 'failed'\n\n/** Configuration for WebSocket reconnection behavior */\nexport interface ReconnectionConfig {\n /** Starting delay in milliseconds (default: 1000ms) */\n initialDelayMs: number\n /** Maximum delay cap in milliseconds (default: 30000ms) */\n maxDelayMs: number\n /** Exponential backoff multiplier (default: 2) */\n backoffMultiplier: number\n /** Random jitter factor 0-1 (default: 0.3) */\n jitterFactor: number\n /** Maximum retry attempts, -1 for infinite (default: -1) */\n maxRetries: number\n}\n\n/** Default reconnection configuration */\nexport const DEFAULT_RECONNECTION_CONFIG: ReconnectionConfig = {\n initialDelayMs: 1000,\n maxDelayMs: 30000,\n backoffMultiplier: 2,\n jitterFactor: 0.3,\n maxRetries: -1,\n}\n\n/** Configuration for OpenTelemetry initialization. */\nexport interface OtelConfig {\n /** Whether OpenTelemetry export is enabled. Defaults to true. Set to false or OTEL_ENABLED=false/0/no/off to disable. */\n enabled?: boolean\n /** The service name to report. Defaults to OTEL_SERVICE_NAME or \"iii-node\". */\n serviceName?: string\n /** The service version to report. Defaults to SERVICE_VERSION env var or \"unknown\". */\n serviceVersion?: string\n /** The service namespace to report. Defaults to SERVICE_NAMESPACE env var. */\n serviceNamespace?: string\n /** The service instance ID to report. Defaults to SERVICE_INSTANCE_ID env var or auto-generated UUID. */\n serviceInstanceId?: string\n /** III Engine WebSocket URL. Defaults to III_BRIDGE_URL or \"ws://localhost:49134\". */\n engineWsUrl?: string\n /** OpenTelemetry instrumentations to register (e.g., PrismaInstrumentation). */\n instrumentations?: Instrumentation[]\n /** Whether OpenTelemetry metrics export is enabled. Defaults to true. Set to false or OTEL_METRICS_ENABLED=false/0/no/off to disable. */\n metricsEnabled?: boolean\n /** Metrics export interval in milliseconds. Defaults to 60000 (60 seconds). */\n metricsExportIntervalMs?: number\n /** Optional reconnection configuration for the WebSocket connection. */\n reconnectionConfig?: Partial<ReconnectionConfig>\n}\n\n/** Default configuration values for OpenTelemetry initialization. */\nexport const DEFAULT_OTEL_CONFIG = {\n enabled: true,\n serviceName: 'iii-node',\n serviceVersion: 'unknown',\n engineWsUrl: 'ws://localhost:49134',\n metricsEnabled: true,\n metricsExportIntervalMs: 60000,\n} as const satisfies Partial<OtelConfig>\n\n/** Parse a boolean environment variable, recognizing 'false', '0', 'no', 'off' as false. */\nexport function parseBoolEnv(value: string | undefined, defaultValue: boolean): boolean {\n if (value === undefined) return defaultValue\n const lower = value.toLowerCase()\n return lower !== 'false' && lower !== '0' && lower !== 'no' && lower !== 'off'\n}\n","/**\n * Shared WebSocket connection for OpenTelemetry exporters.\n */\n\nimport { WebSocket } from 'ws'\nimport { type ConnectionState, type ReconnectionConfig, DEFAULT_RECONNECTION_CONFIG } from './types'\n\n/**\n * Shared WebSocket connection for all OTEL exporters (traces, metrics, logs).\n * Uses a single connection with message prefixes to identify signal type.\n */\nexport class SharedEngineConnection {\n private static readonly MAX_PENDING_MESSAGES = 1000\n private ws: WebSocket | null = null\n private wsUrl: string\n private connecting = false\n private shuttingDown = false\n private pendingMessages: Array<{ frame: Buffer; callback?: (err?: Error) => void }> = []\n private reconnectAttempt = 0\n private reconnectTimeout: NodeJS.Timeout | null = null\n private config: ReconnectionConfig\n private state: ConnectionState = 'disconnected'\n private onConnectedCallbacks: Array<() => void> = []\n\n constructor(wsUrl: string, config: Partial<ReconnectionConfig> = {}) {\n this.wsUrl = wsUrl\n this.config = { ...DEFAULT_RECONNECTION_CONFIG, ...config }\n this.connect()\n }\n\n private connect(): void {\n if (this.connecting || (this.ws && this.ws.readyState === WebSocket.OPEN)) {\n return\n }\n\n this.connecting = true\n this.state = 'connecting'\n\n try {\n this.ws = new WebSocket(this.wsUrl)\n\n this.ws.on('open', () => {\n this.connecting = false\n this.state = 'connected'\n console.log(`[OTel] Connected to engine at ${this.wsUrl}`)\n\n // Reset reconnection state\n if (this.reconnectAttempt > 0) {\n console.log('[OTel] Successfully reconnected')\n }\n this.reconnectAttempt = 0\n\n // Clear any pending reconnect timer to prevent race conditions\n if (this.reconnectTimeout) {\n clearTimeout(this.reconnectTimeout)\n this.reconnectTimeout = null\n }\n\n // Flush pending messages\n const pending = this.pendingMessages.splice(0, this.pendingMessages.length)\n for (const { frame, callback } of pending) {\n this.ws?.send(frame, err => callback?.(err))\n }\n\n // Notify callbacks\n for (const cb of this.onConnectedCallbacks) {\n cb()\n }\n })\n\n this.ws.on('close', () => {\n this.connecting = false\n this.ws = null\n\n // Skip reconnection if we're shutting down intentionally\n if (this.shuttingDown) {\n this.state = 'disconnected'\n console.log('[OTel] Connection closed during shutdown')\n return\n }\n\n this.state = 'disconnected'\n console.log('[OTel] Disconnected from engine, will reconnect...')\n this.scheduleReconnect()\n })\n\n this.ws.on('error', err => {\n this.connecting = false\n\n // Skip error handling if we're shutting down intentionally\n if (this.shuttingDown) {\n return\n }\n\n console.error('[OTel] WebSocket error:', err.message)\n })\n } catch (err) {\n this.connecting = false\n console.error('[OTel] Connection failed:', err)\n this.scheduleReconnect()\n }\n }\n\n private scheduleReconnect(): void {\n if (this.config.maxRetries !== -1 && this.reconnectAttempt >= this.config.maxRetries) {\n this.state = 'failed'\n console.error(`[OTel] Max retries (${this.config.maxRetries}) reached, giving up`)\n\n // Notify pending message callbacks that they won't be delivered\n const pending = this.pendingMessages.splice(0, this.pendingMessages.length)\n const failedError = new Error('Connection failed after max retries')\n for (const { callback } of pending) {\n callback?.(failedError)\n }\n return\n }\n\n if (this.reconnectTimeout) {\n return // Already scheduled\n }\n\n const exponentialDelay =\n this.config.initialDelayMs * this.config.backoffMultiplier ** this.reconnectAttempt\n const cappedDelay = Math.min(exponentialDelay, this.config.maxDelayMs)\n const jitter = cappedDelay * this.config.jitterFactor * (2 * Math.random() - 1)\n const delay = Math.max(0, Math.floor(cappedDelay + jitter))\n\n this.state = 'reconnecting'\n console.log(`[OTel] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempt + 1})...`)\n\n this.reconnectTimeout = setTimeout(() => {\n this.reconnectTimeout = null\n this.reconnectAttempt++\n this.connect()\n }, delay)\n }\n\n /**\n * Send a message with a signal prefix.\n */\n send(prefix: string, data: Uint8Array, callback?: (err?: Error) => void): void {\n const prefixBytes = Buffer.from(prefix, 'utf-8')\n const frame = Buffer.concat([prefixBytes, Buffer.from(data)])\n\n if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n this.ws.send(frame, callback)\n } else {\n // Queue for later with bounded size to prevent memory exhaustion\n if (this.pendingMessages.length >= SharedEngineConnection.MAX_PENDING_MESSAGES) {\n console.warn('[OTel] Pending message queue full, dropping oldest message')\n const dropped = this.pendingMessages.shift()\n dropped?.callback?.(new Error('Message dropped due to queue overflow'))\n }\n this.pendingMessages.push({ frame, callback })\n this.connect()\n }\n }\n\n /**\n * Register a callback to be called when connected.\n */\n onConnected(callback: () => void): void {\n this.onConnectedCallbacks.push(callback)\n if (this.state === 'connected') {\n callback()\n }\n }\n\n /**\n * Get the current connection state.\n */\n getState(): ConnectionState {\n return this.state\n }\n\n /**\n * Shutdown the connection.\n */\n async shutdown(): Promise<void> {\n // Set shutdown flag to prevent reconnection attempts\n this.shuttingDown = true\n\n if (this.reconnectTimeout) {\n clearTimeout(this.reconnectTimeout)\n this.reconnectTimeout = null\n }\n\n if (this.ws) {\n this.ws.close()\n this.ws = null\n }\n\n // Notify pending message callbacks that they won't be delivered\n const pending = this.pendingMessages.splice(0, this.pendingMessages.length)\n const shutdownError = new Error('Connection shutdown before message could be sent')\n for (const { callback } of pending) {\n callback?.(shutdownError)\n }\n this.onConnectedCallbacks = []\n this.state = 'disconnected'\n }\n}\n","/**\n * Span exporter for the III Engine.\n */\n\nimport { ExportResultCode, type ExportResult } from '@opentelemetry/core'\nimport type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base'\nimport { JsonTraceSerializer } from '@opentelemetry/otlp-transformer'\n\nimport type { SharedEngineConnection } from './connection'\nimport { PREFIX_TRACES } from './types'\n\n/**\n * Span exporter using the shared WebSocket connection.\n */\nexport class EngineSpanExporter implements SpanExporter {\n private static readonly MAX_PENDING_EXPORTS = 100\n private connection: SharedEngineConnection\n private pendingExports: Array<{\n spans: ReadableSpan[]\n resultCallback?: (result: ExportResult) => void\n }> = []\n\n constructor(connection: SharedEngineConnection) {\n this.connection = connection\n this.connection.onConnected(() => this.flushPending())\n }\n\n private flushPending(): void {\n const pending = this.pendingExports.splice(0, this.pendingExports.length)\n for (const { spans, resultCallback } of pending) {\n this.sendExport(spans, resultCallback)\n }\n }\n\n private sendExport(spans: ReadableSpan[], resultCallback?: (result: ExportResult) => void): void {\n try {\n const serialized = JsonTraceSerializer.serializeRequest(spans)\n if (!serialized) {\n resultCallback?.({ code: ExportResultCode.SUCCESS })\n return\n }\n\n this.connection.send(PREFIX_TRACES, serialized, err => {\n if (err) {\n console.error('[OTel] Failed to send spans:', err.message)\n resultCallback?.({ code: ExportResultCode.FAILED, error: err })\n } else {\n resultCallback?.({ code: ExportResultCode.SUCCESS })\n }\n })\n } catch (err) {\n console.error('[OTel] Error exporting spans:', err)\n resultCallback?.({ code: ExportResultCode.FAILED, error: err as Error })\n }\n }\n\n private doExport(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void {\n if (this.connection.getState() !== 'connected') {\n if (this.pendingExports.length >= EngineSpanExporter.MAX_PENDING_EXPORTS) {\n const dropped = this.pendingExports.shift()\n dropped?.resultCallback?.({\n code: ExportResultCode.FAILED,\n error: new Error('Queue overflow'),\n })\n console.warn('[OTel] Spans export queue full, dropped oldest entry')\n }\n this.pendingExports.push({ spans, resultCallback })\n // Don't call resultCallback here - it will be called when actually sent or on shutdown\n return\n }\n\n this.sendExport(spans, resultCallback)\n }\n\n export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void {\n this.doExport(spans, resultCallback)\n }\n\n async shutdown(): Promise<void> {\n const pending = this.pendingExports.splice(0, this.pendingExports.length)\n const shutdownError = new Error('Exporter shutdown before export completed')\n for (const { resultCallback } of pending) {\n resultCallback?.({ code: ExportResultCode.FAILED, error: shutdownError })\n }\n }\n\n async forceFlush(): Promise<void> {\n // No-op, spans are sent immediately\n }\n}\n","/**\n * Metrics exporter for the III Engine.\n */\n\nimport { ExportResultCode, type ExportResult } from '@opentelemetry/core'\nimport type { PushMetricExporter, ResourceMetrics } from '@opentelemetry/sdk-metrics'\nimport { JsonMetricsSerializer } from '@opentelemetry/otlp-transformer'\n\nimport type { SharedEngineConnection } from './connection'\nimport { PREFIX_METRICS } from './types'\n\n/**\n * Metrics exporter using the shared WebSocket connection.\n */\nexport class EngineMetricsExporter implements PushMetricExporter {\n private static readonly MAX_PENDING_EXPORTS = 100\n private connection: SharedEngineConnection\n private pendingExports: Array<{\n metrics: ResourceMetrics\n resultCallback?: (result: ExportResult) => void\n }> = []\n\n constructor(connection: SharedEngineConnection) {\n this.connection = connection\n this.connection.onConnected(() => this.flushPending())\n }\n\n private flushPending(): void {\n const pending = this.pendingExports.splice(0, this.pendingExports.length)\n for (const { metrics, resultCallback } of pending) {\n this.sendExport(metrics, resultCallback)\n }\n }\n\n private sendExport(\n metricsData: ResourceMetrics,\n resultCallback?: (result: ExportResult) => void,\n ): void {\n try {\n const serialized = JsonMetricsSerializer.serializeRequest(metricsData)\n if (!serialized) {\n resultCallback?.({ code: ExportResultCode.SUCCESS })\n return\n }\n\n this.connection.send(PREFIX_METRICS, serialized, err => {\n if (err) {\n console.error('[OTel] Failed to send metrics:', err.message)\n resultCallback?.({ code: ExportResultCode.FAILED, error: err })\n } else {\n resultCallback?.({ code: ExportResultCode.SUCCESS })\n }\n })\n } catch (err) {\n console.error('[OTel] Error exporting metrics:', err)\n resultCallback?.({ code: ExportResultCode.FAILED, error: err as Error })\n }\n }\n\n private doExport(\n metricsData: ResourceMetrics,\n resultCallback: (result: ExportResult) => void,\n ): void {\n if (this.connection.getState() !== 'connected') {\n if (this.pendingExports.length >= EngineMetricsExporter.MAX_PENDING_EXPORTS) {\n const dropped = this.pendingExports.shift()\n dropped?.resultCallback?.({\n code: ExportResultCode.FAILED,\n error: new Error('Queue overflow'),\n })\n console.warn('[OTel] Metrics export queue full, dropped oldest entry')\n }\n this.pendingExports.push({ metrics: metricsData, resultCallback })\n // Don't call resultCallback here - it will be called when actually sent or on shutdown\n return\n }\n\n this.sendExport(metricsData, resultCallback)\n }\n\n export(metrics: ResourceMetrics, resultCallback: (result: ExportResult) => void): void {\n this.doExport(metrics, resultCallback)\n }\n\n async shutdown(): Promise<void> {\n const pending = this.pendingExports.splice(0, this.pendingExports.length)\n const shutdownError = new Error('Exporter shutdown before export completed')\n for (const { resultCallback } of pending) {\n resultCallback?.({ code: ExportResultCode.FAILED, error: shutdownError })\n }\n }\n\n async forceFlush(): Promise<void> {\n // No-op\n }\n}\n","/**\n * Log exporter for the III Engine.\n */\n\nimport { ExportResultCode, type ExportResult } from '@opentelemetry/core'\nimport type { LogRecordExporter, ReadableLogRecord } from '@opentelemetry/sdk-logs'\nimport { JsonLogsSerializer } from '@opentelemetry/otlp-transformer'\n\nimport type { SharedEngineConnection } from './connection'\nimport { PREFIX_LOGS } from './types'\n\n/**\n * Log exporter using the shared WebSocket connection.\n */\nexport class EngineLogExporter implements LogRecordExporter {\n private connection: SharedEngineConnection\n private pendingExports: Array<{\n logs: ReadableLogRecord[]\n callback: (result: ExportResult) => void\n }> = []\n\n constructor(connection: SharedEngineConnection) {\n this.connection = connection\n this.connection.onConnected(() => this.flushPending())\n }\n\n private flushPending(): void {\n const pending = this.pendingExports.splice(0, this.pendingExports.length)\n for (const { logs, callback } of pending) {\n this.doExport(logs, callback)\n }\n }\n\n private doExport(\n logs: ReadableLogRecord[],\n resultCallback: (result: ExportResult) => void,\n ): void {\n if (this.connection.getState() !== 'connected') {\n this.pendingExports.push({ logs, callback: resultCallback })\n return\n }\n\n try {\n const serialized = JsonLogsSerializer.serializeRequest(logs)\n if (!serialized) {\n resultCallback({ code: ExportResultCode.SUCCESS })\n return\n }\n\n this.connection.send(PREFIX_LOGS, serialized, err => {\n if (err) {\n console.error('[OTel] Failed to send logs:', err.message)\n resultCallback({ code: ExportResultCode.FAILED, error: err })\n } else {\n resultCallback({ code: ExportResultCode.SUCCESS })\n }\n })\n } catch (err) {\n console.error('[OTel] Error exporting logs:', err)\n resultCallback({ code: ExportResultCode.FAILED, error: err as Error })\n }\n }\n\n export(logs: ReadableLogRecord[], resultCallback: (result: ExportResult) => void): void {\n this.doExport(logs, resultCallback)\n }\n\n async shutdown(): Promise<void> {\n for (const { callback } of this.pendingExports) {\n callback({ code: ExportResultCode.FAILED, error: new Error('Exporter shutdown') })\n }\n this.pendingExports = []\n }\n}\n","/**\n * Trace context and baggage propagation utilities.\n */\n\nimport { trace, context, propagation, type Context } from '@opentelemetry/api'\n\n/**\n * Extract the current trace ID from the active span context.\n */\nexport function currentTraceId(): string | undefined {\n const span = trace.getActiveSpan()\n if (span) {\n const spanContext = span.spanContext()\n if (spanContext.traceId && spanContext.traceId !== '00000000000000000000000000000000') {\n return spanContext.traceId\n }\n }\n return undefined\n}\n\n/**\n * Extract the current span ID from the active span context.\n */\nexport function currentSpanId(): string | undefined {\n const span = trace.getActiveSpan()\n if (span) {\n const spanContext = span.spanContext()\n if (spanContext.spanId && spanContext.spanId !== '0000000000000000') {\n return spanContext.spanId\n }\n }\n return undefined\n}\n\n/**\n * Inject the current trace context into a W3C traceparent header string.\n */\nexport function injectTraceparent(): string | undefined {\n const carrier: Record<string, string> = {}\n propagation.inject(context.active(), carrier)\n return carrier.traceparent\n}\n\n/**\n * Extract a trace context from a W3C traceparent header string.\n */\nexport function extractTraceparent(traceparent: string): Context {\n const carrier: Record<string, string> = { traceparent }\n return propagation.extract(context.active(), carrier)\n}\n\n/**\n * Inject the current baggage into a W3C baggage header string.\n */\nexport function injectBaggage(): string | undefined {\n const carrier: Record<string, string> = {}\n propagation.inject(context.active(), carrier)\n return carrier.baggage\n}\n\n/**\n * Extract baggage from a W3C baggage header string.\n */\nexport function extractBaggage(baggage: string): Context {\n const carrier: Record<string, string> = { baggage }\n return propagation.extract(context.active(), carrier)\n}\n\n/**\n * Extract both trace context and baggage from their respective headers.\n */\nexport function extractContext(traceparent?: string, baggage?: string): Context {\n const carrier: Record<string, string> = {}\n if (traceparent) {\n carrier.traceparent = traceparent\n }\n if (baggage) {\n carrier.baggage = baggage\n }\n return propagation.extract(context.active(), carrier)\n}\n\n/**\n * Get a baggage entry from the current context.\n */\nexport function getBaggageEntry(key: string): string | undefined {\n const bag = propagation.getBaggage(context.active())\n return bag?.getEntry(key)?.value\n}\n\n/**\n * Set a baggage entry in the current context.\n */\nexport function setBaggageEntry(key: string, value: string): Context {\n let bag = propagation.getBaggage(context.active()) ?? propagation.createBaggage()\n bag = bag.setEntry(key, { value })\n return propagation.setBaggage(context.active(), bag)\n}\n\n/**\n * Remove a baggage entry from the current context.\n */\nexport function removeBaggageEntry(key: string): Context {\n const bag = propagation.getBaggage(context.active())\n if (!bag) {\n return context.active()\n }\n const newBag = bag.removeEntry(key)\n return propagation.setBaggage(context.active(), newBag)\n}\n\n/**\n * Get all baggage entries from the current context.\n */\nexport function getAllBaggage(): Record<string, string> {\n const bag = propagation.getBaggage(context.active())\n if (!bag) {\n return {}\n }\n const entries: Record<string, string> = {}\n for (const [key, entry] of bag.getAllEntries()) {\n entries[key] = entry.value\n }\n return entries\n}\n","/**\n * OpenTelemetry initialization for the III Node SDK.\n *\n * This module provides trace, metrics, and log export to the III Engine\n * via a shared WebSocket connection using OTLP JSON format.\n */\n\nimport { Resource } from '@opentelemetry/resources'\nimport { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions'\nimport { randomUUID } from 'node:crypto'\nimport {\n trace,\n context,\n propagation,\n SpanKind,\n SpanStatusCode,\n metrics,\n type Span,\n type Context,\n type Tracer,\n type Meter,\n} from '@opentelemetry/api'\nimport { SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base'\nimport { MeterProvider, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics'\nimport {\n CompositePropagator,\n W3CBaggagePropagator,\n W3CTraceContextPropagator,\n} from '@opentelemetry/core'\nimport { NodeTracerProvider } from '@opentelemetry/sdk-trace-node'\nimport { registerInstrumentations } from '@opentelemetry/instrumentation'\nimport { LoggerProvider, SimpleLogRecordProcessor } from '@opentelemetry/sdk-logs'\nimport { type Logger, SeverityNumber } from '@opentelemetry/api-logs'\n\nimport {\n type OtelConfig,\n DEFAULT_OTEL_CONFIG,\n parseBoolEnv,\n ATTR_SERVICE_VERSION,\n ATTR_SERVICE_NAMESPACE,\n ATTR_SERVICE_INSTANCE_ID,\n} from './types'\nimport { SharedEngineConnection } from './connection'\nimport { EngineSpanExporter, EngineMetricsExporter, EngineLogExporter } from './exporters'\nimport { extractTraceparent } from './context'\n\n// Re-export everything from submodules\nexport * from './types'\nexport * from './context'\n\n// Module-level state\nlet sharedConnection: SharedEngineConnection | null = null\nlet tracerProvider: NodeTracerProvider | null = null\nlet meterProvider: MeterProvider | null = null\nlet loggerProvider: LoggerProvider | null = null\nlet tracer: Tracer | null = null\nlet meter: Meter | null = null\nlet logger: Logger | null = null\nlet serviceName: string = 'iii-node-iii'\n\n/**\n * Initialize OpenTelemetry with the given configuration.\n * This should be called once at application startup.\n */\nexport function initOtel(config: OtelConfig = {}): void {\n const enabled =\n config.enabled ?? parseBoolEnv(process.env.OTEL_ENABLED, DEFAULT_OTEL_CONFIG.enabled)\n\n if (!enabled) {\n console.debug(\n '[OTel] OpenTelemetry is disabled. To enable, remove OTEL_ENABLED=false or set enabled: true in config.',\n )\n return\n }\n\n // Register any provided instrumentations\n if (config.instrumentations?.length) {\n registerInstrumentations({ instrumentations: config.instrumentations })\n }\n\n // Configure service identity\n serviceName =\n config.serviceName ?? process.env.OTEL_SERVICE_NAME ?? DEFAULT_OTEL_CONFIG.serviceName\n const serviceVersion =\n config.serviceVersion ?? process.env.SERVICE_VERSION ?? DEFAULT_OTEL_CONFIG.serviceVersion\n const serviceNamespace = config.serviceNamespace ?? process.env.SERVICE_NAMESPACE\n const serviceInstanceId =\n config.serviceInstanceId ?? process.env.SERVICE_INSTANCE_ID ?? randomUUID()\n const engineWsUrl =\n config.engineWsUrl ?? process.env.III_BRIDGE_URL ?? DEFAULT_OTEL_CONFIG.engineWsUrl\n\n // Build resource attributes\n const resourceAttributes: Record<string, string> = {\n [ATTR_SERVICE_NAME]: serviceName,\n [ATTR_SERVICE_VERSION]: serviceVersion,\n [ATTR_SERVICE_INSTANCE_ID]: serviceInstanceId,\n }\n if (serviceNamespace) {\n resourceAttributes[ATTR_SERVICE_NAMESPACE] = serviceNamespace\n }\n const resource = new Resource(resourceAttributes)\n\n // Create shared WebSocket connection\n sharedConnection = new SharedEngineConnection(engineWsUrl, config.reconnectionConfig)\n\n // Initialize tracer\n const spanExporter = new EngineSpanExporter(sharedConnection)\n tracerProvider = new NodeTracerProvider({\n resource,\n spanProcessors: [new SimpleSpanProcessor(spanExporter)],\n })\n\n // Register W3C Trace Context and Baggage propagators\n propagation.setGlobalPropagator(\n new CompositePropagator({\n propagators: [new W3CTraceContextPropagator(), new W3CBaggagePropagator()],\n }),\n )\n\n tracerProvider.register()\n tracer = trace.getTracer(serviceName)\n\n console.debug(`[OTel] Traces initialized: engine=${engineWsUrl}, service=${serviceName}`)\n\n // Initialize metrics (enabled by default, opt-out via config or env)\n const metricsEnabled =\n config.metricsEnabled ??\n parseBoolEnv(process.env.OTEL_METRICS_ENABLED, DEFAULT_OTEL_CONFIG.metricsEnabled)\n\n if (metricsEnabled) {\n const metricsExporter = new EngineMetricsExporter(sharedConnection)\n const exportIntervalMs =\n config.metricsExportIntervalMs ?? DEFAULT_OTEL_CONFIG.metricsExportIntervalMs\n\n const metricReader = new PeriodicExportingMetricReader({\n exporter: metricsExporter,\n exportIntervalMillis: exportIntervalMs,\n })\n\n meterProvider = new MeterProvider({\n resource,\n readers: [metricReader],\n })\n\n metrics.setGlobalMeterProvider(meterProvider)\n meter = meterProvider.getMeter(serviceName)\n\n console.debug(`[OTel] Metrics initialized: interval=${exportIntervalMs}ms`)\n }\n\n // Initialize logs (always enabled when OTEL is enabled)\n const logExporter = new EngineLogExporter(sharedConnection)\n loggerProvider = new LoggerProvider({ resource })\n loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(logExporter))\n logger = loggerProvider.getLogger(serviceName)\n\n console.debug('[OTel] Logs initialized')\n}\n\n/**\n * Shutdown OpenTelemetry, flushing any pending data.\n */\nexport async function shutdownOtel(): Promise<void> {\n if (tracerProvider) {\n await tracerProvider.shutdown()\n tracerProvider = null\n }\n\n if (meterProvider) {\n await meterProvider.shutdown()\n meterProvider = null\n }\n\n if (loggerProvider) {\n await loggerProvider.shutdown()\n loggerProvider = null\n }\n\n if (sharedConnection) {\n await sharedConnection.shutdown()\n sharedConnection = null\n }\n\n tracer = null\n meter = null\n logger = null\n}\n\n/**\n * Get the OpenTelemetry tracer instance.\n */\nexport function getTracer(): Tracer | null {\n return tracer\n}\n\n/**\n * Get the OpenTelemetry meter instance.\n */\nexport function getMeter(): Meter | null {\n return meter\n}\n\n/**\n * Get the OpenTelemetry logger instance.\n */\nexport function getLogger(): Logger | null {\n return logger\n}\n\n/**\n * Start a new span with the given name and run the callback within it.\n */\nexport async function withSpan<T>(\n name: string,\n options: { kind?: SpanKind; traceparent?: string },\n fn: (span: Span) => Promise<T>,\n): Promise<T> {\n if (!tracer) {\n // Execute without span context when tracer is not initialized\n // Provide a no-op span to avoid runtime errors if fn calls span methods\n const noopSpan: Span = {\n spanContext: () => ({ traceId: '', spanId: '', traceFlags: 0 }),\n setAttribute: () => noopSpan,\n setAttributes: () => noopSpan,\n addEvent: () => noopSpan,\n addLink: () => noopSpan,\n setStatus: () => noopSpan,\n updateName: () => noopSpan,\n end: () => {},\n isRecording: () => false,\n recordException: () => {},\n addLinks: () => noopSpan,\n }\n return fn(noopSpan)\n }\n\n const parentContext = options.traceparent\n ? extractTraceparent(options.traceparent)\n : context.active()\n\n return tracer.startActiveSpan(\n name,\n { kind: options.kind ?? SpanKind.INTERNAL },\n parentContext,\n async span => {\n try {\n const result = await fn(span)\n span.setStatus({ code: SpanStatusCode.OK })\n return result\n } catch (error) {\n span.setStatus({ code: SpanStatusCode.ERROR, message: (error as Error).message })\n span.recordException(error as Error)\n throw error\n } finally {\n span.end()\n }\n },\n )\n}\n\n// Re-export OTEL types for convenience\nexport {\n SpanKind,\n SpanStatusCode,\n SeverityNumber,\n type Span,\n type Context,\n type Tracer,\n type Meter,\n type Logger,\n}\n","/**\n * Safely stringify a value, handling circular references, BigInt, and other edge cases.\n * Returns \"[unserializable]\" if serialization fails for any reason.\n */\nexport function safeStringify(value: unknown): string {\n const seen = new WeakSet<object>()\n\n try {\n return JSON.stringify(value, (_key, val) => {\n // Handle BigInt\n if (typeof val === 'bigint') {\n return val.toString()\n }\n\n // Handle circular references\n if (val !== null && typeof val === 'object') {\n if (seen.has(val)) {\n return '[Circular]'\n }\n seen.add(val)\n }\n\n return val\n })\n } catch {\n return '[unserializable]'\n }\n}\n","/**\n * Worker metrics collection for the III Node SDK.\n *\n * Collects CPU, memory, and event loop metrics for worker health monitoring.\n * Uses the Node.js built-in `monitorEventLoopDelay` API for accurate\n * event loop lag measurements.\n */\n\nimport { type IntervalHistogram, monitorEventLoopDelay, performance } from 'node:perf_hooks'\n\n/**\n * Worker metrics data structure used internally for OTEL metric collection.\n */\nexport type WorkerMetrics = {\n memory_heap_used?: number\n memory_heap_total?: number\n memory_rss?: number\n memory_external?: number\n cpu_user_micros?: number\n cpu_system_micros?: number\n cpu_percent?: number\n event_loop_lag_ms?: number\n uptime_seconds?: number\n timestamp_ms: number\n runtime: string\n}\n\n/**\n * Configuration options for the WorkerMetricsCollector.\n */\nexport interface WorkerMetricsCollectorOptions {\n /**\n * Event loop delay histogram resolution in milliseconds.\n * Lower values provide more accurate measurements but use more resources.\n * @default 20\n */\n eventLoopResolutionMs?: number\n}\n\n/**\n * Collects worker resource metrics including CPU, memory, and event loop lag.\n *\n * Uses the Node.js `monitorEventLoopDelay` API for high-precision event loop\n * delay measurements instead of manual `setImmediate` timing.\n *\n * @example\n * ```typescript\n * const collector = new WorkerMetricsCollector()\n *\n * // Collect metrics periodically\n * setInterval(() => {\n * const metrics = collector.collect()\n * console.log('CPU:', metrics.cpu_percent, '%')\n * console.log('Event Loop Lag:', metrics.event_loop_lag_ms, 'ms')\n * }, 5000)\n *\n * // Clean up when done\n * collector.stopMonitoring()\n * ```\n */\nexport class WorkerMetricsCollector {\n private readonly startTime: number\n private lastCpuUsage: NodeJS.CpuUsage\n private lastCpuTime: number\n private eventLoopHistogram: IntervalHistogram | null = null\n\n /**\n * Creates a new WorkerMetricsCollector instance.\n *\n * @param options - Configuration options\n */\n constructor(options: WorkerMetricsCollectorOptions = {}) {\n this.startTime = Date.now()\n this.lastCpuUsage = process.cpuUsage()\n this.lastCpuTime = performance.now()\n this.startEventLoopMonitoring(options.eventLoopResolutionMs ?? 20)\n }\n\n /**\n * Starts the event loop delay histogram monitoring.\n *\n * @param resolutionMs - Histogram resolution in milliseconds\n */\n private startEventLoopMonitoring(resolutionMs: number): void {\n // Sanitize resolution: must be a positive finite number, minimum 1ms\n const safeResolutionMs =\n Number.isFinite(resolutionMs) && resolutionMs > 0 ? Math.max(1, Math.floor(resolutionMs)) : 20 // Default fallback\n\n this.eventLoopHistogram = monitorEventLoopDelay({ resolution: safeResolutionMs })\n this.eventLoopHistogram.enable()\n }\n\n /**\n * Stops the event loop monitoring and releases resources.\n * Should be called when the collector is no longer needed.\n */\n public stopMonitoring(): void {\n if (this.eventLoopHistogram) {\n this.eventLoopHistogram.disable()\n this.eventLoopHistogram = null\n }\n }\n\n /**\n * Collects current worker metrics.\n *\n * This method calculates CPU usage since the last collection,\n * reads memory usage, and gets event loop delay statistics.\n * The event loop histogram is reset after each collection for\n * accurate per-interval measurements.\n *\n * @returns Current worker metrics snapshot\n */\n collect(): WorkerMetrics {\n const memoryUsage = process.memoryUsage()\n const cpuUsage = process.cpuUsage()\n const now = performance.now()\n\n // Calculate CPU percentage since last collection\n const cpuDelta = {\n user: cpuUsage.user - this.lastCpuUsage.user,\n system: cpuUsage.system - this.lastCpuUsage.system,\n }\n const timeDelta = (now - this.lastCpuTime) * 1000 // Convert ms to microseconds\n const cpuPercent = timeDelta > 0 ? ((cpuDelta.user + cpuDelta.system) / timeDelta) * 100 : 0\n\n // Update state for next collection\n this.lastCpuUsage = cpuUsage\n this.lastCpuTime = now\n\n // Get event loop lag from histogram (in nanoseconds, convert to ms)\n let eventLoopLagMs = 0\n if (this.eventLoopHistogram) {\n // Mean is in nanoseconds, convert to milliseconds\n eventLoopLagMs = this.eventLoopHistogram.mean / 1_000_000\n // Reset histogram for next collection interval\n this.eventLoopHistogram.reset()\n }\n\n return {\n memory_heap_used: memoryUsage.heapUsed,\n memory_heap_total: memoryUsage.heapTotal,\n memory_rss: memoryUsage.rss,\n memory_external: memoryUsage.external,\n cpu_user_micros: cpuUsage.user,\n cpu_system_micros: cpuUsage.system,\n cpu_percent: Math.min(cpuPercent, 100), // Cap at 100%\n event_loop_lag_ms: eventLoopLagMs,\n uptime_seconds: Math.floor((Date.now() - this.startTime) / 1000),\n timestamp_ms: Date.now(),\n runtime: 'node',\n }\n }\n}\n","import type { Meter, BatchObservableResult, Observable } from '@opentelemetry/api'\nimport { WorkerMetricsCollector } from './worker-metrics'\n\nexport interface WorkerGaugesOptions {\n workerId: string\n workerName?: string\n}\n\nlet registeredGauges = false\nlet metricsCollector: WorkerMetricsCollector | null = null\nlet registeredMeter: Meter | null = null\nlet registeredBatchCallback: ((observableResult: BatchObservableResult) => void) | null = null\nlet registeredObservables: Observable[] = []\n\nexport function registerWorkerGauges(meter: Meter, options: WorkerGaugesOptions): void {\n if (registeredGauges) {\n return\n }\n\n const { workerId, workerName } = options\n const baseAttributes = {\n 'worker.id': workerId,\n ...(workerName && { 'worker.name': workerName }),\n }\n\n metricsCollector = new WorkerMetricsCollector()\n\n const memoryHeapUsed = meter.createObservableGauge('iii.worker.memory.heap_used', {\n description: 'Worker heap memory used in bytes',\n unit: 'bytes',\n })\n\n const memoryHeapTotal = meter.createObservableGauge('iii.worker.memory.heap_total', {\n description: 'Worker total heap memory in bytes',\n unit: 'bytes',\n })\n\n const memoryRss = meter.createObservableGauge('iii.worker.memory.rss', {\n description: 'Worker resident set size in bytes',\n unit: 'bytes',\n })\n\n const memoryExternal = meter.createObservableGauge('iii.worker.memory.external', {\n description: 'Worker external memory in bytes',\n unit: 'bytes',\n })\n\n const cpuPercent = meter.createObservableGauge('iii.worker.cpu.percent', {\n description: 'Worker CPU usage percentage',\n unit: '%',\n })\n\n const cpuUserMicros = meter.createObservableGauge('iii.worker.cpu.user_micros', {\n description: 'Worker CPU user time in microseconds',\n unit: 'us',\n })\n\n const cpuSystemMicros = meter.createObservableGauge('iii.worker.cpu.system_micros', {\n description: 'Worker CPU system time in microseconds',\n unit: 'us',\n })\n\n const eventLoopLag = meter.createObservableGauge('iii.worker.event_loop.lag_ms', {\n description: 'Worker event loop lag in milliseconds',\n unit: 'ms',\n })\n\n const uptimeSeconds = meter.createObservableGauge('iii.worker.uptime_seconds', {\n description: 'Worker uptime in seconds',\n unit: 's',\n })\n\n const batchCallback = (observableResult: BatchObservableResult) => {\n if (!metricsCollector) return\n\n const metrics = metricsCollector.collect()\n\n if (metrics.memory_heap_used !== undefined) {\n observableResult.observe(memoryHeapUsed, metrics.memory_heap_used, baseAttributes)\n }\n if (metrics.memory_heap_total !== undefined) {\n observableResult.observe(memoryHeapTotal, metrics.memory_heap_total, baseAttributes)\n }\n if (metrics.memory_rss !== undefined) {\n observableResult.observe(memoryRss, metrics.memory_rss, baseAttributes)\n }\n if (metrics.memory_external !== undefined) {\n observableResult.observe(memoryExternal, metrics.memory_external, baseAttributes)\n }\n if (metrics.cpu_percent !== undefined) {\n observableResult.observe(cpuPercent, metrics.cpu_percent, baseAttributes)\n }\n if (metrics.cpu_user_micros !== undefined) {\n observableResult.observe(cpuUserMicros, metrics.cpu_user_micros, baseAttributes)\n }\n if (metrics.cpu_system_micros !== undefined) {\n observableResult.observe(cpuSystemMicros, metrics.cpu_system_micros, baseAttributes)\n }\n if (metrics.event_loop_lag_ms !== undefined) {\n observableResult.observe(eventLoopLag, metrics.event_loop_lag_ms, baseAttributes)\n }\n if (metrics.uptime_seconds !== undefined) {\n observableResult.observe(uptimeSeconds, metrics.uptime_seconds, baseAttributes)\n }\n }\n\n meter.addBatchObservableCallback(batchCallback, [\n memoryHeapUsed,\n memoryHeapTotal,\n memoryRss,\n memoryExternal,\n cpuPercent,\n cpuUserMicros,\n cpuSystemMicros,\n eventLoopLag,\n uptimeSeconds,\n ])\n\n registeredMeter = meter\n registeredBatchCallback = batchCallback\n registeredObservables = [\n memoryHeapUsed,\n memoryHeapTotal,\n memoryRss,\n memoryExternal,\n cpuPercent,\n cpuUserMicros,\n cpuSystemMicros,\n eventLoopLag,\n uptimeSeconds,\n ]\n\n registeredGauges = true\n}\n\nexport function stopWorkerGauges(): void {\n // Remove the batch observable callback before stopping\n if (registeredMeter && registeredBatchCallback) {\n registeredMeter.removeBatchObservableCallback(registeredBatchCallback, registeredObservables)\n }\n\n if (metricsCollector) {\n metricsCollector.stopMonitoring()\n metricsCollector = null\n }\n\n registeredMeter = null\n registeredBatchCallback = null\n registeredObservables = []\n registeredGauges = false\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stream-Bzpo5JNV.d.mts","names":[],"sources":["../src/stream.ts"],"sourcesContent":[],"mappings":";UAAiB,eAAA;EAAA,OAAA,EACN,MADM,CAAA,MAAe,EAAA,MACrB,CAAA;EAMM,IAAA,EAAA,MAAA;EAKL,YAAA,EATI,MASS,CAAA,
|
|
1
|
+
{"version":3,"file":"stream-Bzpo5JNV.d.mts","names":[],"sources":["../src/stream.ts"],"sourcesContent":[],"mappings":";UAAiB,eAAA;EAAA,OAAA,EACN,MADM,CAAA,MAAe,EAAA,MACrB,CAAA;EAMM,IAAA,EAAA,MAAA;EAKL,YAAA,EATI,MASS,CAAA,MAAA,EAAG,MAAA,EAAA,CAAA;EAEX,IAAA,EAAA,MAAA;AAQjB;AAIY,UAnBK,gBAAA,CAmBS;EAMd,OAAA,CAAA,EAAA,GAAA;AAQZ;AAMY,KAlCA,aAAA,GAAgB,gBAkCD,CAAA,SAAA,CAAA;AAKf,UArCK,oBAAA,CAqCgB;EAIrB,eAAA,EAAA,MAAe;EAKf,WAAA,EAAA,MAAA;EAKA,QAAA,EAAA,MAAS;EAOT,EAAA,CAAA,EAAA,MAAA;EAMA,OAAA,CAAA,EA3DA,aA2De;AAM3B;AAKY,UAnEK,gBAAA,CAmEM;EAOX,YAAA,EAAA,OAAY;AAKxB;AAAuB,KA3EX,cAAA,GA2EW;EAAY,WAAA,EAAA,MAAA;EAAkB,QAAA,EAAA,MAAA;EAAkB,OAAA,EAAA,MAAA;CAAe;AAAW,KArErF,cAAA,GAqEqF;EAErF,WAAA,EAAA,MAAA;EAOK,QAAA,EAAO,MAAA;EACX,OAAA,EAAA,MAAA;EAAyB,IAAA,EAAA,GAAA;CAAR;AACjB,KAxED,iBAAA,GAwEC;EAAyC,WAAA,EAAA,MAAA;EAAhB,QAAA,EAAA,MAAA;EAAR,OAAA,EAAA,MAAA;CACd;AAA4B,KAnEhC,eAAA,GAmEgC;EAAR,WAAA,EAAA,MAAA;EACtB,QAAA,EAAA,MAAA;CAA0B;AAAR,KA/DpB,qBAAA,GA+DoB;EACZ,WAAA,EAAA,MAAA;CAAwB;AAC5B,KA7DJ,eA6DI,CAAA,KAAA,CAAA,GAAA;EAA+C,SAAA,CAAA,EA5DjD,KA4DiD;EAAnB,SAAA,EA3D/B,KA2D+B;CAAR;AAAO,KAxD/B,kBAwD+B,CAAA,KAAA,CAAA,GAAA;cAvD7B;aACD;;KAGD,SAAA;;;;;KAOA,eAAA;;;;;KAMA,eAAA;;;;;KAMA,YAAA;;;;KAKA,WAAA;;;;;KAOA,YAAA;;;KAKA,QAAA,GAAW,YAAY,kBAAkB,kBAAkB,eAAe;KAE1E,iBAAA;;;;OAIL;;UAGU;aACJ,iBAAiB,QAAQ;aACzB,iBAAiB,QAAQ,gBAAgB;gBACtC,oBAAoB,QAAQ;cAC9B,kBAAkB,QAAQ;oBACpB,wBAAwB;gBAC5B,oBAAoB,QAAQ,mBAAmB"}
|
package/dist/telemetry.cjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
const require_otel_worker_gauges = require('./otel-worker-gauges-
|
|
1
|
+
const require_otel_worker_gauges = require('./otel-worker-gauges-8AUNGQgJ.cjs');
|
|
2
2
|
const require_index = require('./index.cjs');
|
|
3
3
|
let __opentelemetry_api_logs = require("@opentelemetry/api-logs");
|
|
4
4
|
let __opentelemetry_api = require("@opentelemetry/api");
|
package/dist/telemetry.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { A as extractTraceparent, B as EngineFunctions, C as initOtel, D as currentTraceId, E as currentSpanId, F as removeBaggageEntry, H as IIIConnectionState, I as setBaggageEntry, L as OtelConfig, M as getBaggageEntry, N as injectBaggage, O as extractBaggage, P as injectTraceparent, R as DEFAULT_BRIDGE_RECONNECTION_CONFIG, S as getTracer, T as withSpan, U as IIIReconnectionConfig, V as EngineTriggers, W as LogFunctions, _ as SeverityNumber, b as getLogger, c as LogCallback, d as OtelLogEvent, f as FunctionInfo, g as Meter, h as Logger, j as getAllBaggage, k as extractContext, l as LogConfig, m as WorkerStatus, o as FunctionsAvailableCallback, p as WorkerInfo, t as ConnectionStateCallback, u as LogSeverityLevel, v as Span, w as shutdownOtel, x as getMeter, y as SpanStatusCode, z as DEFAULT_INVOCATION_TIMEOUT_MS } from "./iii-
|
|
1
|
+
import { A as extractTraceparent, B as EngineFunctions, C as initOtel, D as currentTraceId, E as currentSpanId, F as removeBaggageEntry, H as IIIConnectionState, I as setBaggageEntry, L as OtelConfig, M as getBaggageEntry, N as injectBaggage, O as extractBaggage, P as injectTraceparent, R as DEFAULT_BRIDGE_RECONNECTION_CONFIG, S as getTracer, T as withSpan, U as IIIReconnectionConfig, V as EngineTriggers, W as LogFunctions, _ as SeverityNumber, b as getLogger, c as LogCallback, d as OtelLogEvent, f as FunctionInfo, g as Meter, h as Logger, j as getAllBaggage, k as extractContext, l as LogConfig, m as WorkerStatus, o as FunctionsAvailableCallback, p as WorkerInfo, t as ConnectionStateCallback, u as LogSeverityLevel, v as Span, w as shutdownOtel, x as getMeter, y as SpanStatusCode, z as DEFAULT_INVOCATION_TIMEOUT_MS } from "./iii-BhtLRYBs.cjs";
|
|
2
2
|
import { Meter as Meter$1 } from "@opentelemetry/api";
|
|
3
3
|
|
|
4
4
|
//#region src/worker-metrics.d.ts
|
package/dist/telemetry.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { A as extractTraceparent, B as EngineFunctions, C as initOtel, D as currentTraceId, E as currentSpanId, F as removeBaggageEntry, H as IIIConnectionState, I as setBaggageEntry, L as OtelConfig, M as getBaggageEntry, N as injectBaggage, O as extractBaggage, P as injectTraceparent, R as DEFAULT_BRIDGE_RECONNECTION_CONFIG, S as getTracer, T as withSpan, U as IIIReconnectionConfig, V as EngineTriggers, W as LogFunctions, _ as SeverityNumber, b as getLogger, c as LogCallback, d as OtelLogEvent, f as FunctionInfo, g as Meter, h as Logger, j as getAllBaggage, k as extractContext, l as LogConfig, m as WorkerStatus, o as FunctionsAvailableCallback, p as WorkerInfo, t as ConnectionStateCallback, u as LogSeverityLevel, v as Span, w as shutdownOtel, x as getMeter, y as SpanStatusCode, z as DEFAULT_INVOCATION_TIMEOUT_MS } from "./iii-
|
|
1
|
+
import { A as extractTraceparent, B as EngineFunctions, C as initOtel, D as currentTraceId, E as currentSpanId, F as removeBaggageEntry, H as IIIConnectionState, I as setBaggageEntry, L as OtelConfig, M as getBaggageEntry, N as injectBaggage, O as extractBaggage, P as injectTraceparent, R as DEFAULT_BRIDGE_RECONNECTION_CONFIG, S as getTracer, T as withSpan, U as IIIReconnectionConfig, V as EngineTriggers, W as LogFunctions, _ as SeverityNumber, b as getLogger, c as LogCallback, d as OtelLogEvent, f as FunctionInfo, g as Meter, h as Logger, j as getAllBaggage, k as extractContext, l as LogConfig, m as WorkerStatus, o as FunctionsAvailableCallback, p as WorkerInfo, t as ConnectionStateCallback, u as LogSeverityLevel, v as Span, w as shutdownOtel, x as getMeter, y as SpanStatusCode, z as DEFAULT_INVOCATION_TIMEOUT_MS } from "./iii-7FpY7bi9.mjs";
|
|
2
2
|
import { Meter as Meter$1 } from "@opentelemetry/api";
|
|
3
3
|
|
|
4
4
|
//#region src/worker-metrics.d.ts
|
package/dist/telemetry.mjs
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import { C as removeBaggageEntry, D as EngineFunctions, E as DEFAULT_INVOCATION_TIMEOUT_MS, O as EngineTriggers, S as injectTraceparent, T as DEFAULT_BRIDGE_RECONNECTION_CONFIG, _ as extractContext, a as SeverityNumber, b as getBaggageEntry, c as getLogger, d as initOtel, f as shutdownOtel, g as extractBaggage, h as currentTraceId, i as safeStringify, k as LogFunctions, l as getMeter, m as currentSpanId, n as stopWorkerGauges, p as withSpan, r as WorkerMetricsCollector, s as SpanStatusCode, t as registerWorkerGauges, u as getTracer, v as extractTraceparent, w as setBaggageEntry, x as injectBaggage, y as getAllBaggage } from "./otel-worker-gauges-
|
|
1
|
+
import { C as removeBaggageEntry, D as EngineFunctions, E as DEFAULT_INVOCATION_TIMEOUT_MS, O as EngineTriggers, S as injectTraceparent, T as DEFAULT_BRIDGE_RECONNECTION_CONFIG, _ as extractContext, a as SeverityNumber, b as getBaggageEntry, c as getLogger, d as initOtel, f as shutdownOtel, g as extractBaggage, h as currentTraceId, i as safeStringify, k as LogFunctions, l as getMeter, m as currentSpanId, n as stopWorkerGauges, p as withSpan, r as WorkerMetricsCollector, s as SpanStatusCode, t as registerWorkerGauges, u as getTracer, v as extractTraceparent, w as setBaggageEntry, x as injectBaggage, y as getAllBaggage } from "./otel-worker-gauges-Dka1CFDy.mjs";
|
|
2
2
|
|
|
3
3
|
export { DEFAULT_BRIDGE_RECONNECTION_CONFIG, DEFAULT_INVOCATION_TIMEOUT_MS, EngineFunctions, EngineTriggers, LogFunctions, SeverityNumber, SpanStatusCode, WorkerMetricsCollector, currentSpanId, currentTraceId, extractBaggage, extractContext, extractTraceparent, getAllBaggage, getBaggageEntry, getLogger, getMeter, getTracer, initOtel, injectBaggage, injectTraceparent, registerWorkerGauges, removeBaggageEntry, safeStringify, setBaggageEntry, shutdownOtel, stopWorkerGauges, withSpan };
|
package/package.json
CHANGED
|
@@ -0,0 +1,268 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Unit tests for OTel default-enabled behavior.
|
|
3
|
+
*
|
|
4
|
+
* These tests verify that OpenTelemetry is enabled by default
|
|
5
|
+
* and can be disabled via config or environment variable.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import { describe, it, expect, afterEach, vi, beforeEach } from 'vitest'
|
|
9
|
+
|
|
10
|
+
// Mock WebSocket to prevent real connections
|
|
11
|
+
vi.mock('ws', () => {
|
|
12
|
+
const MockWebSocket = vi.fn().mockImplementation(() => ({
|
|
13
|
+
on: vi.fn(),
|
|
14
|
+
close: vi.fn(),
|
|
15
|
+
send: vi.fn(),
|
|
16
|
+
readyState: 0,
|
|
17
|
+
}))
|
|
18
|
+
return { WebSocket: MockWebSocket, default: { WebSocket: MockWebSocket } }
|
|
19
|
+
})
|
|
20
|
+
|
|
21
|
+
// Mock NodeTracerProvider to avoid real tracer setup
|
|
22
|
+
vi.mock('@opentelemetry/sdk-trace-node', () => ({
|
|
23
|
+
NodeTracerProvider: vi.fn().mockImplementation(() => ({
|
|
24
|
+
register: vi.fn(),
|
|
25
|
+
shutdown: vi.fn().mockResolvedValue(undefined),
|
|
26
|
+
})),
|
|
27
|
+
}))
|
|
28
|
+
|
|
29
|
+
// Mock MeterProvider to avoid real metrics setup
|
|
30
|
+
vi.mock('@opentelemetry/sdk-metrics', () => ({
|
|
31
|
+
MeterProvider: vi.fn().mockImplementation(() => ({
|
|
32
|
+
getMeter: vi.fn().mockReturnValue({ createCounter: vi.fn() }),
|
|
33
|
+
shutdown: vi.fn().mockResolvedValue(undefined),
|
|
34
|
+
})),
|
|
35
|
+
PeriodicExportingMetricReader: vi.fn().mockImplementation(() => ({})),
|
|
36
|
+
}))
|
|
37
|
+
|
|
38
|
+
// Mock LoggerProvider to avoid real log setup
|
|
39
|
+
vi.mock('@opentelemetry/sdk-logs', () => ({
|
|
40
|
+
LoggerProvider: vi.fn().mockImplementation(() => ({
|
|
41
|
+
getLogger: vi.fn().mockReturnValue({ emit: vi.fn() }),
|
|
42
|
+
addLogRecordProcessor: vi.fn(),
|
|
43
|
+
shutdown: vi.fn().mockResolvedValue(undefined),
|
|
44
|
+
})),
|
|
45
|
+
SimpleLogRecordProcessor: vi.fn().mockImplementation(() => ({})),
|
|
46
|
+
}))
|
|
47
|
+
|
|
48
|
+
// Mock span processor
|
|
49
|
+
vi.mock('@opentelemetry/sdk-trace-base', () => ({
|
|
50
|
+
SimpleSpanProcessor: vi.fn().mockImplementation(() => ({})),
|
|
51
|
+
}))
|
|
52
|
+
|
|
53
|
+
// Mock exporters to avoid real exporter instantiation
|
|
54
|
+
vi.mock('../src/telemetry-system/exporters', () => ({
|
|
55
|
+
EngineSpanExporter: vi.fn().mockImplementation(() => ({})),
|
|
56
|
+
EngineMetricsExporter: vi.fn().mockImplementation(() => ({})),
|
|
57
|
+
EngineLogExporter: vi.fn().mockImplementation(() => ({})),
|
|
58
|
+
}))
|
|
59
|
+
|
|
60
|
+
// Mock the shared connection to avoid real WebSocket connections
|
|
61
|
+
vi.mock('../src/telemetry-system/connection', () => ({
|
|
62
|
+
SharedEngineConnection: vi.fn().mockImplementation(() => ({
|
|
63
|
+
send: vi.fn(),
|
|
64
|
+
onConnected: vi.fn(),
|
|
65
|
+
getState: vi.fn().mockReturnValue('disconnected'),
|
|
66
|
+
shutdown: vi.fn().mockResolvedValue(undefined),
|
|
67
|
+
})),
|
|
68
|
+
}))
|
|
69
|
+
|
|
70
|
+
import {
|
|
71
|
+
initOtel,
|
|
72
|
+
shutdownOtel,
|
|
73
|
+
getTracer,
|
|
74
|
+
getMeter,
|
|
75
|
+
getLogger,
|
|
76
|
+
} from '../src/telemetry-system/index'
|
|
77
|
+
|
|
78
|
+
describe('OTel default-enabled behavior', () => {
|
|
79
|
+
const originalEnv = process.env
|
|
80
|
+
|
|
81
|
+
beforeEach(() => {
|
|
82
|
+
// Reset environment variables before each test
|
|
83
|
+
process.env = { ...originalEnv }
|
|
84
|
+
delete process.env.OTEL_ENABLED
|
|
85
|
+
delete process.env.OTEL_METRICS_ENABLED
|
|
86
|
+
})
|
|
87
|
+
|
|
88
|
+
afterEach(async () => {
|
|
89
|
+
// Shut down OTel to reset module-level singleton state between tests
|
|
90
|
+
await shutdownOtel()
|
|
91
|
+
process.env = originalEnv
|
|
92
|
+
})
|
|
93
|
+
|
|
94
|
+
it('should enable OTel by default when no config or env var is set', () => {
|
|
95
|
+
// Call initOtel with no arguments — should default to enabled
|
|
96
|
+
initOtel()
|
|
97
|
+
|
|
98
|
+
// Tracer and logger should be initialized (not null)
|
|
99
|
+
expect(getTracer()).not.toBeNull()
|
|
100
|
+
expect(getLogger()).not.toBeNull()
|
|
101
|
+
})
|
|
102
|
+
|
|
103
|
+
it('should disable OTel when enabled: false is set in config', () => {
|
|
104
|
+
initOtel({ enabled: false })
|
|
105
|
+
|
|
106
|
+
// Tracer and logger should be null when explicitly disabled
|
|
107
|
+
expect(getTracer()).toBeNull()
|
|
108
|
+
expect(getLogger()).toBeNull()
|
|
109
|
+
})
|
|
110
|
+
|
|
111
|
+
it('should disable OTel when OTEL_ENABLED=false env var is set', () => {
|
|
112
|
+
process.env.OTEL_ENABLED = 'false'
|
|
113
|
+
|
|
114
|
+
initOtel()
|
|
115
|
+
|
|
116
|
+
// Tracer and logger should be null when env var disables OTel
|
|
117
|
+
expect(getTracer()).toBeNull()
|
|
118
|
+
expect(getLogger()).toBeNull()
|
|
119
|
+
})
|
|
120
|
+
|
|
121
|
+
it('should disable OTel when OTEL_ENABLED=0 env var is set', () => {
|
|
122
|
+
process.env.OTEL_ENABLED = '0'
|
|
123
|
+
|
|
124
|
+
initOtel()
|
|
125
|
+
|
|
126
|
+
// Tracer and logger should be null when env var disables OTel
|
|
127
|
+
expect(getTracer()).toBeNull()
|
|
128
|
+
expect(getLogger()).toBeNull()
|
|
129
|
+
})
|
|
130
|
+
|
|
131
|
+
it('should enable OTel when OTEL_ENABLED=true is set', () => {
|
|
132
|
+
process.env.OTEL_ENABLED = 'true'
|
|
133
|
+
|
|
134
|
+
initOtel()
|
|
135
|
+
|
|
136
|
+
expect(getTracer()).not.toBeNull()
|
|
137
|
+
expect(getLogger()).not.toBeNull()
|
|
138
|
+
})
|
|
139
|
+
|
|
140
|
+
it('should enable OTel when OTEL_ENABLED=1 is set', () => {
|
|
141
|
+
process.env.OTEL_ENABLED = '1'
|
|
142
|
+
|
|
143
|
+
initOtel()
|
|
144
|
+
|
|
145
|
+
expect(getTracer()).not.toBeNull()
|
|
146
|
+
expect(getLogger()).not.toBeNull()
|
|
147
|
+
})
|
|
148
|
+
|
|
149
|
+
it('should enable OTel for any non-false/non-0 OTEL_ENABLED value', () => {
|
|
150
|
+
process.env.OTEL_ENABLED = 'yes'
|
|
151
|
+
|
|
152
|
+
initOtel()
|
|
153
|
+
|
|
154
|
+
// Any value other than 'false' or '0' is treated as enabled
|
|
155
|
+
expect(getTracer()).not.toBeNull()
|
|
156
|
+
expect(getLogger()).not.toBeNull()
|
|
157
|
+
})
|
|
158
|
+
|
|
159
|
+
it('should enable metrics by default when no config or env var is set', () => {
|
|
160
|
+
initOtel()
|
|
161
|
+
|
|
162
|
+
// Tracer, logger, and meter should all be initialized by default
|
|
163
|
+
expect(getTracer()).not.toBeNull()
|
|
164
|
+
expect(getLogger()).not.toBeNull()
|
|
165
|
+
expect(getMeter()).not.toBeNull()
|
|
166
|
+
})
|
|
167
|
+
|
|
168
|
+
it('should disable metrics when metricsEnabled: false is set in config', () => {
|
|
169
|
+
initOtel({ metricsEnabled: false })
|
|
170
|
+
|
|
171
|
+
// Tracer and logger should be initialized, but meter should be null
|
|
172
|
+
expect(getTracer()).not.toBeNull()
|
|
173
|
+
expect(getLogger()).not.toBeNull()
|
|
174
|
+
expect(getMeter()).toBeNull()
|
|
175
|
+
})
|
|
176
|
+
|
|
177
|
+
it('should disable metrics when OTEL_METRICS_ENABLED=false env var is set', () => {
|
|
178
|
+
process.env.OTEL_METRICS_ENABLED = 'false'
|
|
179
|
+
|
|
180
|
+
initOtel()
|
|
181
|
+
|
|
182
|
+
expect(getTracer()).not.toBeNull()
|
|
183
|
+
expect(getLogger()).not.toBeNull()
|
|
184
|
+
expect(getMeter()).toBeNull()
|
|
185
|
+
})
|
|
186
|
+
|
|
187
|
+
it('should disable metrics when OTEL_METRICS_ENABLED=0 env var is set', () => {
|
|
188
|
+
process.env.OTEL_METRICS_ENABLED = '0'
|
|
189
|
+
|
|
190
|
+
initOtel()
|
|
191
|
+
|
|
192
|
+
expect(getTracer()).not.toBeNull()
|
|
193
|
+
expect(getLogger()).not.toBeNull()
|
|
194
|
+
expect(getMeter()).toBeNull()
|
|
195
|
+
})
|
|
196
|
+
|
|
197
|
+
it('should disable OTel when OTEL_ENABLED=no env var is set', () => {
|
|
198
|
+
process.env.OTEL_ENABLED = 'no'
|
|
199
|
+
|
|
200
|
+
initOtel()
|
|
201
|
+
|
|
202
|
+
expect(getTracer()).toBeNull()
|
|
203
|
+
expect(getLogger()).toBeNull()
|
|
204
|
+
})
|
|
205
|
+
|
|
206
|
+
it('should disable OTel when OTEL_ENABLED=off env var is set', () => {
|
|
207
|
+
process.env.OTEL_ENABLED = 'off'
|
|
208
|
+
|
|
209
|
+
initOtel()
|
|
210
|
+
|
|
211
|
+
expect(getTracer()).toBeNull()
|
|
212
|
+
expect(getLogger()).toBeNull()
|
|
213
|
+
})
|
|
214
|
+
|
|
215
|
+
it('should disable OTel when OTEL_ENABLED=OFF (case-insensitive) env var is set', () => {
|
|
216
|
+
process.env.OTEL_ENABLED = 'OFF'
|
|
217
|
+
|
|
218
|
+
initOtel()
|
|
219
|
+
|
|
220
|
+
expect(getTracer()).toBeNull()
|
|
221
|
+
expect(getLogger()).toBeNull()
|
|
222
|
+
})
|
|
223
|
+
|
|
224
|
+
it('should let config.enabled override OTEL_ENABLED env var (config wins)', () => {
|
|
225
|
+
process.env.OTEL_ENABLED = 'false'
|
|
226
|
+
|
|
227
|
+
initOtel({ enabled: true })
|
|
228
|
+
|
|
229
|
+
// Config takes precedence over env var
|
|
230
|
+
expect(getTracer()).not.toBeNull()
|
|
231
|
+
expect(getLogger()).not.toBeNull()
|
|
232
|
+
})
|
|
233
|
+
|
|
234
|
+
it('should let config.enabled=false override even when OTEL_ENABLED is not set', () => {
|
|
235
|
+
// No env var set, but config explicitly disables
|
|
236
|
+
initOtel({ enabled: false })
|
|
237
|
+
|
|
238
|
+
expect(getTracer()).toBeNull()
|
|
239
|
+
expect(getLogger()).toBeNull()
|
|
240
|
+
})
|
|
241
|
+
|
|
242
|
+
it('should let config.metricsEnabled override OTEL_METRICS_ENABLED env var', () => {
|
|
243
|
+
process.env.OTEL_METRICS_ENABLED = 'false'
|
|
244
|
+
|
|
245
|
+
initOtel({ metricsEnabled: true })
|
|
246
|
+
|
|
247
|
+
// Config takes precedence over env var
|
|
248
|
+
expect(getMeter()).not.toBeNull()
|
|
249
|
+
})
|
|
250
|
+
|
|
251
|
+
it('should disable metrics when OTEL_METRICS_ENABLED=no env var is set', () => {
|
|
252
|
+
process.env.OTEL_METRICS_ENABLED = 'no'
|
|
253
|
+
|
|
254
|
+
initOtel()
|
|
255
|
+
|
|
256
|
+
expect(getTracer()).not.toBeNull()
|
|
257
|
+
expect(getMeter()).toBeNull()
|
|
258
|
+
})
|
|
259
|
+
|
|
260
|
+
it('should disable metrics when OTEL_METRICS_ENABLED=off env var is set', () => {
|
|
261
|
+
process.env.OTEL_METRICS_ENABLED = 'off'
|
|
262
|
+
|
|
263
|
+
initOtel()
|
|
264
|
+
|
|
265
|
+
expect(getTracer()).not.toBeNull()
|
|
266
|
+
expect(getMeter()).toBeNull()
|
|
267
|
+
})
|
|
268
|
+
})
|