@echoteam/signoz-react 1.2.8 → 1.2.11

package/TROUBLESHOOTING.md

@@ -1,5 +1,81 @@
 # Troubleshooting Guide
 
+## Error: Timeout from BatchSpanProcessor
+
+### Masalah
+Jika Anda mendapatkan error seperti ini di console:
+```
+Unhandled Promise rejection: Timeout ; Zone: <root> ; Task: Promise.then ; Value: Error: Timeout
+at BatchSpanProcessorBase.js:132:1
+```
+
+### Penyebab
+Error ini terjadi ketika BatchSpanProcessor mencoba mengirim spans ke backend SignOz tetapi mengalami timeout. Ini biasanya terjadi karena:
+1. Backend SignOz tidak dapat dijangkau
+2. Network lambat atau tidak stabil
+3. CORS tidak dikonfigurasi dengan benar di backend
+4. Timeout terlalu pendek untuk koneksi Anda
+
+### Solusi
+
+#### 1. Verifikasi Backend SignOz Dapat Dijangkau
+Pastikan URL SignOz Anda benar dan dapat diakses dari browser:
+```javascript
+// Test di browser console
+fetch('http://your-signoz-url:4318/v1/traces', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' }
+})
+```
+
+#### 2. Periksa CORS Configuration
+Pastikan backend SignOz Anda mengizinkan request dari domain frontend Anda. Lihat [BACKEND_CORS_SETUP.md](./BACKEND_CORS_SETUP.md) untuk panduan lengkap.
+
+#### 3. Tingkatkan Timeout (Recommended)
+Sejak versi 1.2.10, timeout default sudah ditingkatkan menjadi 60 detik. Jika masih timeout, Anda bisa meningkatkannya lebih lanjut:
+
+```javascript
+import { initializeSignOzTracing } from '@echoteam/signoz-react';
+
+initializeSignOzTracing({
+  serviceName: 'my-app',
+  serviceVersion: '1.0.0',
+  environment: 'production',
+  serviceNamespace: 'frontend',
+  url: 'http://your-signoz-url:4318/v1/traces',
+  batchSpanProcessorConfig: {
+    maxQueueSize: 100,
+    scheduledDelayMillis: 5000,
+    exportTimeoutMillis: 120000, // 120 seconds
+    maxExportBatchSize: 50
+  }
+});
+```
+
+#### 4. Suppress Timeout Errors (Jika Tidak Mengganggu)
+Sejak versi 1.2.10, timeout errors dari BatchSpanProcessor secara otomatis di-suppress untuk menghindari noise di console. Error ini biasanya aman untuk diabaikan karena spans akan di-retry atau di-queue ulang.
+
+Jika Anda ingin melihat warning untuk timeout ini, aktifkan console logging:
+```javascript
+initializeSignOzTracing({
+  // ... config lainnya
+  enableConsoleLog: true
+});
+```
+
+#### 5. Gunakan Network yang Lebih Stabil
+Jika Anda mengalami timeout secara konsisten, pertimbangkan:
+- Menggunakan koneksi internet yang lebih stabil
+- Mengurangi ukuran batch dengan `maxExportBatchSize`
+- Meningkatkan `scheduledDelayMillis` untuk mengirim spans lebih jarang
+
+### Catatan Penting
+- Timeout errors biasanya tidak mempengaruhi fungsionalitas aplikasi Anda
+- Spans yang gagal dikirim akan di-queue ulang dan dicoba lagi
+- Jika backend SignOz tidak dapat dijangkau sama sekali, spans akan di-drop setelah queue penuh
+
+---
+
 ## Error: Can't resolve 'perf_hooks'
 
 ### Masalah

package/dist/index.d.ts

@@ -11,6 +11,7 @@ interface SignOzConfig {
         maxQueueSize?: number;
         scheduledDelayMillis?: number;
         exportTimeoutMillis?: number;
+        maxExportBatchSize?: number;
     };
     allowedOrigins?: (string | RegExp)[];
     enableRequestLogging?: boolean;

package/dist/index.esm.js

@@ -15584,6 +15584,21 @@ function addErrorTracking(enableConsoleLog = false) {
     }, true); // Use capture phase to catch errors early
     // Track unhandled promise rejections
     window.addEventListener('unhandledrejection', (event) => {
+        // Suppress BatchSpanProcessor timeout errors to avoid noise
+        const reason = String(event.reason);
+        const stack = event.reason instanceof Error ? (event.reason.stack || '') : '';
+        // Check if this is a SignOz internal timeout error
+        const isSignOzTimeout = (reason.includes('Timeout') &&
+            (reason.includes('BatchSpanProcessor') ||
+                stack.includes('BatchSpanProcessor') ||
+                stack.includes('zone.js')));
+        if (isSignOzTimeout) {
+            if (enableConsoleLog) {
+                console.warn('[SignOz] Span export timeout (this is usually safe to ignore - check if SignOz endpoint is reachable)');
+            }
+            event.preventDefault(); // Prevent the error from being logged
+            return;
+        }
         const tracer = trace.getTracer('error-tracker');
         const span = tracer.startSpan('Unhandled Promise Rejection');
         span.setAttribute('error.type', 'unhandled_rejection');
@@ -15611,6 +15626,17 @@ function addErrorTracking(enableConsoleLog = false) {
         const originalHandleError = currentZone.handleError;
         if (originalHandleError) {
             currentZone.handleError = function (error) {
+                // Skip SignOz internal timeout errors
+                const errorMessage = error.message || String(error);
+                const errorStack = error.stack || '';
+                const isSignOzTimeout = (errorMessage.includes('Timeout') &&
+                    (errorStack.includes('BatchSpanProcessor') || errorStack.includes('zone.js')));
+                if (isSignOzTimeout) {
+                    if (enableConsoleLog) {
+                        console.warn('[SignOz] Zone.js caught span export timeout (safe to ignore)');
+                    }
+                    return; // Don't track this error
+                }
                 const tracer = trace.getTracer('error-tracker');
                 const span = tracer.startSpan('Zone.js Error');
                 span.setAttribute('error.type', 'zone_error');
@@ -15984,7 +16010,8 @@ function initializeSignOzTracing(config) {
             batchSpanProcessorConfig: (config === null || config === void 0 ? void 0 : config.batchSpanProcessorConfig) || {
                 maxQueueSize: 100,
                 scheduledDelayMillis: 5000,
-                exportTimeoutMillis: 30000
+                exportTimeoutMillis: 60000, // Increased to 60 seconds
+                maxExportBatchSize: 50 // Smaller batches to avoid timeouts
             },
             allowedOrigins: (config === null || config === void 0 ? void 0 : config.allowedOrigins) || parseAllowedOrigins(getConfigValue('REACT_APP_SIGNOZ_ALLOWED_ORIGINS')),
             enableRequestLogging: (config === null || config === void 0 ? void 0 : config.enableRequestLogging) !== undefined ? config.enableRequestLogging : (getConfigValue('REACT_APP_SIGNOZ_ENABLE_REQUEST_LOGGING') === 'true' || true),
@@ -16015,7 +16042,8 @@ function initializeSignOzTracing(config) {
         // Set up the OTLP trace exporter
         const exporter = new OTLPTraceExporter({
             url: effectiveConfig.url,
-            headers: effectiveConfig.headers
+            headers: effectiveConfig.headers,
+            timeoutMillis: 60000 // Set exporter timeout to 60 seconds
         });
         // Set up the span processor with configuration
         const processor = new BatchSpanProcessor(exporter, {