@pingops/otel 0.1.0

package/dist/tracer-provider.js

@@ -0,0 +1,182 @@
+/**
+ * Tracer Provider with global state and isolated TracerProvider architecture
+ *
+ * This module provides an isolated TracerProvider that shares the same
+ * span processors (like PingopsSpanProcessor) with the main OpenTelemetry SDK.
+ * This ensures manual spans created via startSpan are properly processed.
+ *
+ * Architecture follows Langfuse's pattern with global state management.
+ */
+import { trace } from "@opentelemetry/api";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+import { createLogger } from "@pingops/core";
+/**
+ * Global symbol for PingOps state
+ */
+const PINGOPS_GLOBAL_SYMBOL = Symbol.for("pingops");
+/**
+ * Logger instance for tracer provider
+ */
+const log = createLogger("[PingOps TracerProvider]");
+/**
+ * Creates initial global state
+ */
+function createState() {
+    return {
+        isolatedTracerProvider: null,
+    };
+}
+/**
+ * Gets the global state, creating it if it doesn't exist
+ */
+function getGlobalState() {
+    const initialState = createState();
+    try {
+        const g = globalThis;
+        if (typeof g !== "object" || g === null) {
+            // Fallback if globalThis is not available
+            log.warn("globalThis is not available, using fallback state");
+            return initialState;
+        }
+        if (!g[PINGOPS_GLOBAL_SYMBOL]) {
+            log.debug("Creating new global state");
+            Object.defineProperty(g, PINGOPS_GLOBAL_SYMBOL, {
+                value: initialState,
+                writable: false, // lock the slot (not the contents)
+                configurable: false,
+                enumerable: false,
+            });
+        }
+        else {
+            log.debug("Retrieved existing global state");
+        }
+        return g[PINGOPS_GLOBAL_SYMBOL];
+    }
+    catch (err) {
+        log.error("Failed to access global state:", err instanceof Error ? err.message : String(err));
+        // Fallback on error
+        return initialState;
+    }
+}
+/**
+ * Sets an isolated TracerProvider for PingOps tracing operations.
+ *
+ * This allows PingOps to use its own TracerProvider instance, separate from
+ * the global OpenTelemetry TracerProvider. This is useful for avoiding conflicts
+ * with other OpenTelemetry instrumentation in the application.
+ *
+ * @param provider - The TracerProvider instance to use, or null to clear the isolated provider
+ * @public
+ */
+export function setPingopsTracerProvider(provider) {
+    const state = getGlobalState();
+    const hadProvider = state.isolatedTracerProvider !== null;
+    state.isolatedTracerProvider = provider;
+    if (provider) {
+        log.info("Set isolated TracerProvider", {
+            hadPrevious: hadProvider,
+            providerType: provider.constructor.name,
+        });
+    }
+    else {
+        log.info("Cleared isolated TracerProvider", { hadPrevious: hadProvider });
+    }
+}
+/**
+ * Gets the TracerProvider for PingOps tracing operations.
+ *
+ * Returns the isolated TracerProvider if one has been set via setPingopsTracerProvider(),
+ * otherwise falls back to the global OpenTelemetry TracerProvider.
+ *
+ * @returns The TracerProvider instance to use for PingOps tracing
+ * @public
+ */
+export function getPingopsTracerProvider() {
+    const { isolatedTracerProvider } = getGlobalState();
+    if (isolatedTracerProvider) {
+        log.debug("Using isolated TracerProvider", {
+            providerType: isolatedTracerProvider.constructor.name,
+        });
+        return isolatedTracerProvider;
+    }
+    const globalProvider = trace.getTracerProvider();
+    log.debug("Using global TracerProvider", {
+        providerType: globalProvider.constructor.name,
+    });
+    return globalProvider;
+}
+/**
+ * Initializes the isolated TracerProvider with the given span processors
+ *
+ * This creates a separate TracerProvider that shares the same span processors
+ * (like PingopsSpanProcessor) with the main SDK. This ensures manual spans
+ * are processed correctly.
+ *
+ * @param spanProcessors - Array of span processors to use (e.g., PingopsSpanProcessor)
+ * @param serviceName - Service name for resource attributes
+ * @deprecated Use setPingopsTracerProvider instead
+ */
+export function initializeTracerProvider(spanProcessors, serviceName) {
+    log.info("Initializing TracerProvider", {
+        serviceName,
+        spanProcessorCount: spanProcessors.length,
+    });
+    // Create resource with service name
+    const resource = resourceFromAttributes({
+        [ATTR_SERVICE_NAME]: serviceName,
+    });
+    log.debug("Created resource", { serviceName });
+    // In version 2.2.0, span processors are passed in the constructor
+    const tracerProvider = new NodeTracerProvider({
+        resource,
+        spanProcessors,
+    });
+    log.debug("Created NodeTracerProvider", {
+        spanProcessorCount: spanProcessors.length,
+    });
+    // Register the provider globally
+    tracerProvider.register();
+    log.info("Registered TracerProvider globally");
+    // Set it in global state
+    setPingopsTracerProvider(tracerProvider);
+    log.info("TracerProvider initialization complete");
+}
+/**
+ * Gets the isolated TracerProvider instance
+ *
+ * @returns The TracerProvider instance, or null if not initialized
+ * @deprecated Use getPingopsTracerProvider instead
+ */
+export function getTracerProvider() {
+    const provider = getPingopsTracerProvider();
+    return provider instanceof NodeTracerProvider ? provider : null;
+}
+/**
+ * Shuts down the TracerProvider and flushes remaining spans
+ */
+export async function shutdownTracerProvider() {
+    log.info("Shutting down TracerProvider");
+    const provider = getPingopsTracerProvider();
+    // Check if provider has shutdown method (NodeTracerProvider and compatible providers)
+    const providerWithShutdown = provider;
+    if (providerWithShutdown &&
+        typeof providerWithShutdown.shutdown === "function") {
+        log.debug("Calling provider.shutdown()");
+        try {
+            await providerWithShutdown.shutdown();
+            log.info("TracerProvider shutdown complete");
+        }
+        catch (error) {
+            log.error("Error during TracerProvider shutdown:", error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+    }
+    else {
+        log.warn("TracerProvider does not have shutdown method, skipping");
+    }
+    setPingopsTracerProvider(null);
+    log.info("TracerProvider shutdown finished");
+}
+//# sourceMappingURL=tracer-provider.js.map

package/dist/tracer-provider.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@pingops/otel",
+  "version": "0.1.0",
+  "description": "OpenTelemetry SpanProcessor for PingOps",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "pingops",
+    "monitoring",
+    "observability",
+    "opentelemetry",
+    "span-processor"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.2.0",
+    "@opentelemetry/sdk-trace-node": "^2.2.0",
+    "@opentelemetry/resources": "^2.2.0",
+    "@opentelemetry/semantic-conventions": "^1.38.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.208.0",
+    "@opentelemetry/instrumentation": "^0.208.0",
+    "@opentelemetry/instrumentation-http": "^0.208.0",
+    "@opentelemetry/instrumentation-undici": "^0.19.0",
+    "@pingops/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.6.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  }
+}