@vtvlive/interactive-apm 0.0.2 → 0.0.3

package/dist/init/opentelemetry-init.js

@@ -52,6 +52,41 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.shouldUseOpenTelemetry = shouldUseOpenTelemetry;
 exports.initOpenTelemetry = initOpenTelemetry;
 const apm_provider_type_1 = require("../types/apm-provider.type");
+const otlp_transport_type_1 = require("../types/otlp-transport.type");
+const debug_logger_1 = require("../utils/debug-logger");
+const debug_exporter_wrapper_1 = require("../utils/debug-exporter-wrapper");
+// @ts-ignore - Optional peer dependency
+const api_1 = require("@opentelemetry/api");
+/**
+ * Transaction Name Processor for OpenTelemetry
+ * Sets transaction names to format: "GET /api/healthcheck/ping"
+ */
+class TransactionNameProcessor {
+    onStart(_span) {
+        // No-op - moved to onEnd to read final http.route
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+    shutdown() {
+        return Promise.resolve();
+    }
+    onEnd(_span) {
+        // Only process root spans (SERVER spans without parent)
+        if (_span.parent || _span.kind !== api_1.SpanKind.SERVER) {
+            return;
+        }
+        // Get HTTP attributes (http.route is often set after routing completes)
+        const method = _span.attributes?.['http.method'];
+        const route = _span.attributes?.['http.route']; // /api/healthcheck/ping
+        const target = _span.attributes?.['http.target']; // fallback
+        if (method && (route || target)) {
+            // Format: GET /api/healthcheck/ping
+            const fullName = `${method} ${route || target}`;
+            _span.updateName(fullName);
+        }
+    }
+}
 /**
  * Check if APM should use OpenTelemetry provider based on configuration
  * @returns true if OpenTelemetry should be used
@@ -60,6 +95,38 @@ function shouldUseOpenTelemetry() {
     const provider = process.env.APM_PROVIDER || apm_provider_type_1.ApmProvider.OPENTELEMETRY;
     return provider !== apm_provider_type_1.ApmProvider.ELASTIC_APM && provider !== 'elastic-apm';
 }
+/**
+ * Normalize OTLP endpoint URL to ensure consistent format
+ * - Ensure port is included
+ * - Remove trailing slashes
+ * - For gRPC, don't add /v1/traces (it uses different path)
+ */
+function normalizeEndpoint(endpoint, isGrpc) {
+    try {
+        const url = new URL(endpoint);
+        // Ensure port is specified
+        if (!url.port) {
+            const defaultPort = url.protocol === 'https:' ? '443' : '80';
+            url.port = defaultPort;
+        }
+        // Remove trailing slash
+        let pathname = url.pathname.replace(/\/+$/, '');
+        // For gRPC, remove /v1/traces as it uses different path
+        if (isGrpc && pathname.endsWith('/v1/traces')) {
+            pathname = pathname.replace('/v1/traces', '');
+        }
+        // For HTTP/PROTO, ensure /v1/traces path exists
+        if (!isGrpc && !pathname.endsWith('/v1/traces')) {
+            pathname = pathname.endsWith('/') ? pathname + 'v1/traces' : pathname + '/v1/traces';
+        }
+        url.pathname = pathname;
+        return url.toString();
+    }
+    catch (error) {
+        // If URL parsing fails, return as-is
+        return endpoint;
+    }
+}
 /**
  * Initialize OpenTelemetry SDK for standalone usage
  *
@@ -71,12 +138,16 @@ async function initOpenTelemetry(options = {}) {
     const { NodeSDK } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/sdk-node')));
     // @ts-ignore - Optional peer dependency
     const { resourceFromAttributes } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/resources')));
-    // @ts-ignore - Optional peer dependency
-    const { OTLPTraceExporter } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/exporter-trace-otlp-http')));
-    console.log('[OpenTelemetry] Initializing...');
     const serviceName = options.serviceName || process.env.ELASTIC_APM_SERVICE_NAME || 'interactive-backend';
     const environment = options.environment || process.env.ELASTIC_APM_ENVIRONMENT || 'development';
+    // Determine transport type (HTTP, gRPC, or PROTO)
+    const transportType = (options.otlpTransport || process.env.ELASTIC_OTLP_TRANSPORT || otlp_transport_type_1.OtlpTransport.HTTP).toLowerCase();
+    const isGrpc = transportType === otlp_transport_type_1.OtlpTransport.GRPC || transportType === 'grpc';
+    const isProto = transportType === otlp_transport_type_1.OtlpTransport.PROTO || transportType === 'proto';
+    // Get endpoint from config or env (same endpoint for both transports)
     const otlpEndpoint = options.otlpEndpoint || process.env.ELASTIC_OTLP_ENDPOINT || 'http://localhost:8200/v1/traces';
+    // Validate and normalize endpoint
+    const normalizedEndpoint = normalizeEndpoint(otlpEndpoint, isGrpc);
     const secretToken = options.secretToken || process.env.ELASTIC_APM_SECRET_TOKEN;
     const otlpAuthToken = options.otlpAuthToken || process.env.ELASTIC_OTLP_AUTH_TOKEN;
     // Build headers: merge options.otlpHeaders with Authorization if token is provided
@@ -85,29 +156,49 @@ async function initOpenTelemetry(options = {}) {
     if (token) {
         headers['Authorization'] = `Bearer ${token}`;
     }
-    console.log(`[OpenTelemetry] Service: ${serviceName}, Environment: ${environment}`);
-    console.log(`[OpenTelemetry] Endpoint: ${otlpEndpoint}`);
+    // Log initialization details when debug mode is on
+    (0, debug_logger_1.logInitialization)('OpenTelemetry', {
+        serviceName,
+        environment,
+        otlpEndpoint: normalizedEndpoint,
+        transport: isGrpc ? 'gRPC' : isProto ? 'PROTO (protobuf over HTTP)' : 'HTTP',
+        hasToken: !!token,
+        enableConsoleExporter: options.enableConsoleExporter ?? process.env.ELASTIC_OTLP_ENABLE_CONSOLE_EXPORTER === 'true',
+        enableHttpInstrumentation: options.enableHttpInstrumentation !== false,
+        enableExpressInstrumentation: options.enableExpressInstrumentation !== false,
+    });
+    const transportLabel = isGrpc ? 'gRPC' : isProto ? 'PROTO' : 'HTTP';
+    (0, debug_logger_1.infoLog)(`[OpenTelemetry] Initializing with ${transportLabel} transport...`);
     // Build exporters array
     const exporters = [];
-    // OTLP Exporter with detailed logging
-    const otlpExporterBase = new OTLPTraceExporter({
-        url: otlpEndpoint,
-        headers: Object.keys(headers).length > 0 ? headers : undefined,
-    });
-    // Wrap OTLP exporter - only log errors
-    const otlpExporter = {
-        export: (spans, resultCallback) => {
-            otlpExporterBase.export(spans, (result) => {
-                if (result.error) {
-                    console.error(`[OpenTelemetry] Export failed: ${result.error instanceof Error ? result.error.message : result.error}`);
-                }
-                resultCallback(result);
-            });
-        },
-        shutdown: async () => {
-            await otlpExporterBase.shutdown();
-        },
-    };
+    // Create OTLP exporter based on transport type
+    let otlpExporterBase;
+    if (isGrpc) {
+        // @ts-ignore - Optional peer dependency
+        const { OTLPTraceExporter } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/exporter-trace-otlp-grpc')));
+        otlpExporterBase = new OTLPTraceExporter({
+            url: normalizedEndpoint,
+            headers: Object.keys(headers).length > 0 ? headers : undefined,
+        });
+    }
+    else if (isProto) {
+        // @ts-ignore - Optional peer dependency
+        const { OTLPTraceExporter } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/exporter-trace-otlp-proto')));
+        otlpExporterBase = new OTLPTraceExporter({
+            url: normalizedEndpoint,
+            headers: Object.keys(headers).length > 0 ? headers : undefined,
+        });
+    }
+    else {
+        // @ts-ignore - Optional peer dependency
+        const { OTLPTraceExporter } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/exporter-trace-otlp-http')));
+        otlpExporterBase = new OTLPTraceExporter({
+            url: normalizedEndpoint,
+            headers: Object.keys(headers).length > 0 ? headers : undefined,
+        });
+    }
+    // Wrap with debug exporter for detailed request/response logging
+    const otlpExporter = (0, debug_exporter_wrapper_1.createDebugExporter)(otlpExporterBase, normalizedEndpoint);
     exporters.push(otlpExporter);
     // Console Exporter for debugging
     if (options.enableConsoleExporter ?? process.env.ELASTIC_OTLP_ENABLE_CONSOLE_EXPORTER === 'true') {
@@ -141,10 +232,16 @@ async function initOpenTelemetry(options = {}) {
         traceExporter: exporters.length === 1 ? exporters[0] : exporters, // Handle single/multiple exporters
         instrumentations,
         resource: sdkResource,
+        spanProcessor: new TransactionNameProcessor(),
     });
     // Start SDK
     sdk.start();
-    console.log('[OpenTelemetry] Initialized');
+    // Install HTTP interceptor for debug mode
+    const interceptor = (0, debug_exporter_wrapper_1.createHttpRequestInterceptor)();
+    if (interceptor) {
+        interceptor.install();
+    }
+    (0, debug_logger_1.infoLog)('[OpenTelemetry] Initialized');
     // Setup graceful shutdown handlers
     const shutdown = async () => {
         await sdk.shutdown();

package/dist/providers/elastic-apm.tracing-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elastic-apm.tracing-provider.d.ts","sourceRoot":"","sources":["../../src/providers/elastic-apm.tracing-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAE5E;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO;IAK1I;;;OAGG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA6B5I;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,QAAQ,GAAE,MAAmB,GAAG,GAAG;IAkDzG;;OAEG;IACG,mBAAmB,CAAC,CAAC,EACzB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3C,OAAO,CAAC,CAAC,CAAC;IAmBb;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAMhC;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvD;;OAEG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAOzB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAe1B"}
+{"version":3,"file":"elastic-apm.tracing-provider.d.ts","sourceRoot":"","sources":["../../src/providers/elastic-apm.tracing-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAG5E;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO;IAK1I;;;OAGG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgD5I;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,QAAQ,GAAE,MAAmB,GAAG,GAAG;IAyDzG;;OAEG;IACG,mBAAmB,CAAC,CAAC,EACzB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3C,OAAO,CAAC,CAAC,CAAC;IAsBb;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAMhC;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvD;;OAEG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAOzB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAe1B"}

package/dist/providers/elastic-apm.tracing-provider.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ElasticApmTracingProvider = void 0;
+const debug_logger_1 = require("../utils/debug-logger");
 /**
  * Elastic APM Tracing Provider Implementation
  * Sử dụng elastic-apm-node agent để gửi traces về Elastic APM server
@@ -22,22 +23,39 @@ class ElasticApmTracingProvider {
             // If agent is already started, just get reference
             if (apm.isStarted()) {
                 this.apm = apm;
+                if ((0, debug_logger_1.isDebugEnabled)()) {
+                    console.log(`[APM-DEBUG] [ElasticAPM] Agent already started, using existing instance`);
+                }
                 return;
             }
+            const serverUrl = config?.serverUrl || process.env.ELASTIC_APM_SERVER_URL || 'http://localhost:8200';
+            const secretToken = config?.secretToken || process.env.ELASTIC_APM_SECRET_TOKEN;
+            const serviceVersion = config?.serviceVersion || process.env.npm_package_version || '1.0.0';
+            const environment = config?.environment || this.environment;
+            // Log initialization details when debug mode is on
+            (0, debug_logger_1.logInitialization)('ElasticAPM', {
+                serviceName: config?.serviceName || this.serviceName,
+                serverUrl,
+                hasSecretToken: !!secretToken,
+                serviceVersion,
+                environment,
+            });
             // Start the agent with provided config
             this.apm = apm.start({
                 serviceName: config?.serviceName || this.serviceName,
-                serverUrl: config?.serverUrl || process.env.ELASTIC_APM_SERVER_URL || 'http://localhost:8200',
-                secretToken: config?.secretToken || process.env.ELASTIC_APM_SECRET_TOKEN,
-                serviceVersion: config?.serviceVersion || process.env.npm_package_version || '1.0.0',
-                environment: config?.environment || this.environment,
-                logLevel: 'error',
+                serverUrl,
+                secretToken,
+                serviceVersion,
+                environment,
+                logLevel: (0, debug_logger_1.isDebugEnabled)() ? 'info' : 'error',
             });
-            console.log(`[ElasticAPM] Service: ${this.serviceName}, Environment: ${this.environment}`);
-            console.log('[ElasticAPM] Initialized');
+            if ((0, debug_logger_1.isDebugEnabled)()) {
+                (0, debug_logger_1.infoLog)(`[ElasticAPM] Service: ${this.serviceName}, Environment: ${this.environment}`);
+                (0, debug_logger_1.infoLog)('[ElasticAPM] Initialized');
+            }
         }
         catch (error) {
-            console.error('[ElasticAPM] Failed to initialize:', error);
+            (0, debug_logger_1.errorLog)('[ElasticAPM] Failed to initialize:', error);
             throw error;
         }
     }
@@ -46,7 +64,9 @@ class ElasticApmTracingProvider {
      */
     startSpan(name, attributes, spanKind = 'INTERNAL') {
         if (!this.apm) {
-            console.warn('[ElasticAPM] Not initialized');
+            if ((0, debug_logger_1.isDebugEnabled)()) {
+                console.warn('[ElasticAPM] Not initialized');
+            }
             return null;
         }
         // Elastic APM cần transaction để tạo span
@@ -75,10 +95,13 @@ class ElasticApmTracingProvider {
         }
         // Set span type dựa trên kind
         span.setType(this.mapSpanKindToType(spanKind));
+        // Log span details when debug mode is on
+        (0, debug_logger_1.logSpan)('ElasticAPM', span);
         // Override end() để end transaction sau
         const originalEnd = span.end.bind(span);
         span.end = () => {
             originalEnd();
+            // End transaction if we created it
             if (createdTransaction && transaction) {
                 transaction.end();
             }
@@ -99,6 +122,9 @@ class ElasticApmTracingProvider {
             if (span) {
                 span.outcome = 'failure';
             }
+            if ((0, debug_logger_1.isDebugEnabled)()) {
+                (0, debug_logger_1.infoLog)(`[ElasticAPM] Span failed: ${name} ${error.message || error}`);
+            }
             throw error;
         }
         finally {
@@ -138,7 +164,16 @@ class ElasticApmTracingProvider {
      */
     async shutdown() {
         if (this.apm) {
-            await this.apm.flush();
+            try {
+                await this.apm.flush();
+                if ((0, debug_logger_1.isDebugEnabled)()) {
+                    (0, debug_logger_1.infoLog)('[ElasticAPM] Shutdown completed successfully');
+                }
+            }
+            catch (error) {
+                (0, debug_logger_1.errorLog)('[ElasticAPM] Shutdown failed:', error);
+                throw error;
+            }
         }
     }
     /**

package/dist/providers/opentelemetry.tracing-provider.d.ts

@@ -1,4 +1,5 @@
 import { ITracingProvider } from '../interfaces/tracing-provider.interface';
+import { OtlpTransport } from '../types/otlp-transport.type';
 /**
  * OpenTelemetry Tracing Provider Implementation
  * Sử dụng OpenTelemetry SDK với OTLP exporter để gửi traces về Elastic APM
@@ -9,6 +10,7 @@ export declare class OpenTelemetryTracingProvider implements ITracingProvider {
     private readonly serviceName;
     private readonly environment;
     private readonly otlpEndpoint;
+    private readonly otlpTransport;
     private readonly secretToken;
     private readonly otlpAuthToken;
     private readonly otlpHeaders;
@@ -18,6 +20,7 @@ export declare class OpenTelemetryTracingProvider implements ITracingProvider {
         serviceName?: string;
         environment?: string;
         otlpEndpoint?: string;
+        otlpTransport?: OtlpTransport | string;
         secretToken?: string;
         otlpAuthToken?: string;
         otlpHeaders?: Record<string, string>;
@@ -52,6 +55,10 @@ export declare class OpenTelemetryTracingProvider implements ITracingProvider {
      * Set attribute cho active span
      */
     setAttribute(key: string, value: string | number): void;
+    /**
+     * Force flush all pending spans
+     */
+    forceFlush(): Promise<void>;
     /**
      * End span manually
      */

package/dist/providers/opentelemetry.tracing-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.tracing-provider.d.ts","sourceRoot":"","sources":["../../src/providers/opentelemetry.tracing-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAE5E;;;GAGG;AACH,qBAAa,4BAA6B,YAAW,gBAAgB;IACnE,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAU;IAChD,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,qBAAqB,CAAC,EAAE,OAAO,CAAC;KAC5B;IAUN;;;OAGG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwIjB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,QAAQ,GAAE,MAAmB,GAAG,GAAG;IAqBzG;;OAEG;IACG,mBAAmB,CAAC,CAAC,EACzB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3C,OAAO,CAAC,CAAC,CAAC;IAoBb;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAchC;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAavD;;OAEG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAazB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B;;OAEG;IACH,OAAO,CAAC,WAAW;CAiBpB"}
+{"version":3,"file":"opentelemetry.tracing-provider.d.ts","sourceRoot":"","sources":["../../src/providers/opentelemetry.tracing-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AA2F7D;;;GAGG;AACH,qBAAa,4BAA6B,YAAW,gBAAgB;IACnE,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAU;IAChD,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;QACvC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,qBAAqB,CAAC,EAAE,OAAO,CAAC;KAC5B;IAqBN;;;OAGG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqMjB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,QAAQ,GAAE,MAAmB,GAAG,GAAG;IA0BzG;;OAEG;IACG,mBAAmB,CAAC,CAAC,EACzB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3C,OAAO,CAAC,CAAC,CAAC;IAwBb;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAchC;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAavD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAazB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B;;OAEG;IACH,OAAO,CAAC,WAAW;CAiBpB"}

package/dist/providers/opentelemetry.tracing-provider.js

@@ -34,6 +34,85 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenTelemetryTracingProvider = void 0;
+const otlp_transport_type_1 = require("../types/otlp-transport.type");
+const debug_logger_1 = require("../utils/debug-logger");
+const debug_exporter_wrapper_1 = require("../utils/debug-exporter-wrapper");
+/**
+ * Transaction Name Processor for OpenTelemetry
+ * Sets transaction names to format: "GET /api/healthcheck/ping"
+ */
+class TransactionNameProcessor {
+    constructor() {
+        this.cachedSpanKind = null;
+    }
+    onStart(_span) {
+        // No-op - moved to onEnd to read final http.route
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+    shutdown() {
+        return Promise.resolve();
+    }
+    onEnd(_span) {
+        // Lazy load SpanKind to avoid top-level import failure when @opentelemetry/api is absent
+        if (!this.cachedSpanKind) {
+            try {
+                // @ts-ignore - Optional peer dependency
+                this.cachedSpanKind = require('@opentelemetry/api').SpanKind;
+            }
+            catch {
+                // If @opentelemetry/api is not available, skip processing
+                return;
+            }
+        }
+        // Only process root spans (SERVER spans without parent)
+        if (_span.parent || _span.kind !== this.cachedSpanKind.SERVER) {
+            return;
+        }
+        // Get HTTP attributes (http.route is often set after routing completes)
+        const method = _span.attributes?.['http.method'];
+        const route = _span.attributes?.['http.route']; // /api/healthcheck/ping
+        const target = _span.attributes?.['http.target']; // fallback
+        if (method && (route || target)) {
+            // Format: GET /api/healthcheck/ping
+            const fullName = `${method} ${route || target}`;
+            _span.updateName(fullName);
+        }
+    }
+}
+/**
+ * Normalize OTLP endpoint URL to ensure consistent format
+ * - Ensure port is included
+ * - Remove trailing slashes
+ * - For gRPC, don't add /v1/traces (it uses different path)
+ */
+function normalizeEndpoint(endpoint, isGrpc) {
+    try {
+        const url = new URL(endpoint);
+        // Ensure port is specified
+        if (!url.port) {
+            const defaultPort = url.protocol === 'https:' ? '443' : '80';
+            url.port = defaultPort;
+        }
+        // Remove trailing slash
+        let pathname = url.pathname.replace(/\/+$/, '');
+        // For gRPC, remove /v1/traces as it uses different path
+        if (isGrpc && pathname.endsWith('/v1/traces')) {
+            pathname = pathname.replace('/v1/traces', '');
+        }
+        // For HTTP/PROTO, ensure /v1/traces path exists
+        if (!isGrpc && !pathname.endsWith('/v1/traces')) {
+            pathname = pathname + '/v1/traces';
+        }
+        url.pathname = pathname;
+        return url.toString();
+    }
+    catch (error) {
+        // If URL parsing fails, return as-is
+        return endpoint;
+    }
+}
 /**
  * OpenTelemetry Tracing Provider Implementation
  * Sử dụng OpenTelemetry SDK với OTLP exporter để gửi traces về Elastic APM
@@ -46,6 +125,17 @@ class OpenTelemetryTracingProvider {
         this.serviceName = config.serviceName || process.env.ELASTIC_APM_SERVICE_NAME || 'interactive-backend';
         this.environment = config.environment || process.env.ELASTIC_APM_ENVIRONMENT || 'development';
         this.otlpEndpoint = config.otlpEndpoint || process.env.ELASTIC_OTLP_ENDPOINT || 'http://localhost:8200/v1/traces';
+        // Determine transport type (HTTP, gRPC, or PROTO)
+        const transportType = (config.otlpTransport || process.env.ELASTIC_OTLP_TRANSPORT || otlp_transport_type_1.OtlpTransport.HTTP).toLowerCase();
+        if (transportType === otlp_transport_type_1.OtlpTransport.GRPC || transportType === 'grpc') {
+            this.otlpTransport = otlp_transport_type_1.OtlpTransport.GRPC;
+        }
+        else if (transportType === otlp_transport_type_1.OtlpTransport.PROTO || transportType === 'proto') {
+            this.otlpTransport = otlp_transport_type_1.OtlpTransport.PROTO;
+        }
+        else {
+            this.otlpTransport = otlp_transport_type_1.OtlpTransport.HTTP;
+        }
         this.secretToken = config.secretToken || process.env.ELASTIC_APM_SECRET_TOKEN || '';
         this.otlpAuthToken = config.otlpAuthToken || process.env.ELASTIC_OTLP_AUTH_TOKEN || '';
         this.otlpHeaders = config.otlpHeaders || {};
@@ -68,13 +158,28 @@ class OpenTelemetryTracingProvider {
             // @ts-ignore - Optional peer dependency
             const { ExpressInstrumentation } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/instrumentation-express')));
             // @ts-ignore - Optional peer dependency
-            const { OTLPTraceExporter } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/exporter-trace-otlp-http')));
-            // @ts-ignore - Optional peer dependency
             const { resourceFromAttributes } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/resources')));
             // @ts-ignore - Optional peer dependency
             const { trace } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/api')));
-            console.log(`[OpenTelemetry] Service: ${this.serviceName}, Environment: ${this.environment}`);
-            console.log(`[OpenTelemetry] Endpoint: ${config?.otlpEndpoint || this.otlpEndpoint}`);
+            const endpoint = config?.otlpEndpoint || this.otlpEndpoint;
+            const isGrpc = this.otlpTransport === otlp_transport_type_1.OtlpTransport.GRPC;
+            const isProto = this.otlpTransport === otlp_transport_type_1.OtlpTransport.PROTO;
+            // Normalize endpoint to ensure consistent format
+            const normalizedEndpoint = normalizeEndpoint(endpoint, isGrpc);
+            // Log initialization details when debug mode is on
+            (0, debug_logger_1.logInitialization)('OpenTelemetry', {
+                serviceName: config?.serviceName || this.serviceName,
+                environment: config?.environment || this.environment,
+                otlpEndpoint: normalizedEndpoint,
+                transport: isGrpc ? 'gRPC' : isProto ? 'PROTO (protobuf over HTTP)' : 'HTTP',
+                hasToken: !!(config?.otlpAuthToken || this.otlpAuthToken || config?.secretToken || this.secretToken),
+                enableConsoleExporter: config?.enableConsoleExporter ?? this.enableConsoleExporter,
+            });
+            const transportLabel = isGrpc ? 'gRPC' : isProto ? 'PROTO' : 'HTTP';
+            if ((0, debug_logger_1.isDebugEnabled)()) {
+                (0, debug_logger_1.infoLog)(`[OpenTelemetry] Service: ${this.serviceName}, Environment: ${this.environment}`);
+                (0, debug_logger_1.infoLog)(`[OpenTelemetry] Endpoint: ${normalizedEndpoint} (${transportLabel})`);
+            }
             // OTLP Exporter - Build headers with Authorization
             const buildHeaders = () => {
                 const headers = {
@@ -87,25 +192,34 @@ class OpenTelemetryTracingProvider {
                 }
                 return Object.keys(headers).length > 0 ? headers : undefined;
             };
-            const otlpExporter = new OTLPTraceExporter({
-                url: config?.otlpEndpoint || this.otlpEndpoint,
-                headers: buildHeaders(),
-            });
-            // Wrap OTLP exporter - only log errors
-            const otlpExporterWithLogging = {
-                export: (spans, resultCallback) => {
-                    otlpExporter.export(spans, (result) => {
-                        if (result.error) {
-                            const endpoint = config?.otlpEndpoint || this.otlpEndpoint;
-                            console.error(`[OpenTelemetry] Export to ${endpoint} failed: ${result.error instanceof Error ? result.error.message : result.error}`);
-                        }
-                        resultCallback(result);
-                    });
-                },
-                shutdown: async () => {
-                    await otlpExporter.shutdown();
-                },
-            };
+            // Import the correct exporter based on transport type
+            let otlpExporter;
+            if (isGrpc) {
+                // @ts-ignore - Optional peer dependency
+                const { OTLPTraceExporter } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/exporter-trace-otlp-grpc')));
+                otlpExporter = new OTLPTraceExporter({
+                    url: normalizedEndpoint,
+                    headers: buildHeaders(),
+                });
+            }
+            else if (isProto) {
+                // @ts-ignore - Optional peer dependency
+                const { OTLPTraceExporter } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/exporter-trace-otlp-proto')));
+                otlpExporter = new OTLPTraceExporter({
+                    url: normalizedEndpoint,
+                    headers: buildHeaders(),
+                });
+            }
+            else {
+                // @ts-ignore - Optional peer dependency
+                const { OTLPTraceExporter } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/exporter-trace-otlp-http')));
+                otlpExporter = new OTLPTraceExporter({
+                    url: normalizedEndpoint,
+                    headers: buildHeaders(),
+                });
+            }
+            // Wrap with debug exporter for detailed request/response logging
+            const otlpExporterWithLogging = (0, debug_exporter_wrapper_1.createDebugExporter)(otlpExporter, normalizedEndpoint);
             // Use console exporter if enabled
             const shouldEnableConsole = config?.enableConsoleExporter ?? this.enableConsoleExporter;
             let traceExporter = otlpExporterWithLogging;
@@ -156,22 +270,53 @@ class OpenTelemetryTracingProvider {
                 'service.instance.id': `${process.pid}`,
                 'host.name': require('os').hostname(),
             });
+            // Use BatchSpanProcessor for efficient batching with explicit flush
+            const { BatchSpanProcessor } = await Promise.resolve().then(() => __importStar(require('@opentelemetry/sdk-trace-base')));
+            // Create a custom processor that extends BatchSpanProcessor behavior
+            // but also applies transaction naming
+            const transactionNameProcessor = new TransactionNameProcessor();
+            const batchProcessor = new BatchSpanProcessor(traceExporter);
+            // Wrap the batch processor to also do transaction naming
+            const processorWithNaming = {
+                onStart: (span, context) => {
+                    transactionNameProcessor.onStart(span);
+                    batchProcessor.onStart(span, context);
+                },
+                onEnd: (span) => {
+                    transactionNameProcessor.onEnd(span);
+                    batchProcessor.onEnd(span);
+                },
+                forceFlush: async () => {
+                    await batchProcessor.forceFlush();
+                },
+                shutdown: async () => {
+                    await batchProcessor.shutdown();
+                },
+            };
             // Khởi tạo SDK
             this.sdk = new NodeSDK({
                 serviceName: config?.serviceName || this.serviceName,
-                traceExporter,
+                traceExporter: undefined, // Don't use traceExporter when using spanProcessor
                 instrumentations: [new HttpInstrumentation(), new ExpressInstrumentation()],
                 resource: sdkResource,
+                spanProcessor: processorWithNaming,
             });
             // Khởi động SDK
             this.sdk.start();
+            // Install HTTP interceptor for debug mode
+            const interceptor = (0, debug_exporter_wrapper_1.createHttpRequestInterceptor)();
+            if (interceptor) {
+                interceptor.install();
+            }
             // Get tracer
             this.tracer = trace.getTracer(config?.serviceName || this.serviceName);
             this.initialized = true;
-            console.log('[OpenTelemetry] Initialized');
+            if ((0, debug_logger_1.isDebugEnabled)()) {
+                (0, debug_logger_1.infoLog)('[OpenTelemetry] Initialized');
+            }
         }
         catch (error) {
-            console.error('[OpenTelemetry] Failed to initialize:', error);
+            (0, debug_logger_1.errorLog)('[OpenTelemetry] Failed to initialize:', error);
             throw error;
         }
     }
@@ -180,7 +325,9 @@ class OpenTelemetryTracingProvider {
      */
     startSpan(name, attributes, spanKind = 'INTERNAL') {
         if (!this.initialized || !this.tracer) {
-            console.warn('[OpenTelemetry] Not initialized');
+            if ((0, debug_logger_1.isDebugEnabled)()) {
+                console.warn('[OpenTelemetry] Not initialized');
+            }
             return null;
         }
         // @ts-ignore - Optional peer dependency
@@ -189,6 +336,8 @@ class OpenTelemetryTracingProvider {
             attributes,
             kind: this.mapSpanKind(spanKind),
         }, context.active());
+        // Log span details when debug mode is on
+        (0, debug_logger_1.logSpan)('OpenTelemetry', span);
         return span;
     }
     /**
@@ -206,6 +355,9 @@ class OpenTelemetryTracingProvider {
             catch (error) {
                 span?.recordException(error);
                 span?.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+                if ((0, debug_logger_1.isDebugEnabled)()) {
+                    console.log(`[APM-DEBUG] [OpenTelemetry] Span failed:`, name, error.message || error);
+                }
                 throw error;
             }
             finally {
@@ -242,6 +394,22 @@ class OpenTelemetryTracingProvider {
             span.setAttribute(key, value);
         }
     }
+    /**
+     * Force flush all pending spans
+     */
+    async forceFlush() {
+        if (this.sdk && this.sdk.forceFlush) {
+            try {
+                await this.sdk.forceFlush();
+                if ((0, debug_logger_1.isDebugEnabled)()) {
+                    console.log('[APM-DEBUG] Force flush completed');
+                }
+            }
+            catch (error) {
+                (0, debug_logger_1.errorLog)('[OpenTelemetry] Force flush failed:', error);
+            }
+        }
+    }
     /**
      * End span manually
      */