tracelit 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66ee178565bf80581941df2481fb09e981e013c335ac8a2e4c6d8845a62fb4f1
-  data.tar.gz: a40528eb98fe34dd2dd3d7399cf0e5d40ea5fd0fb83900daec8ee6728d98b846
+  metadata.gz: e7f493aa08c7a1d3595be84019013d49bfa48e2daae3a653cb38b17ad702a8f4
+  data.tar.gz: 07e1c738fb2a5eee274b48f30ff6fea1b97c613b14778de081471fd1fa9ed1d0
 SHA512:
-  metadata.gz: 19b1d323be4bc9f8f1cf531f9728d371537a5430a1e0f6eb82aba66af17ee20b5bddb819e83bd1b8d5f624444ac0a6afaeb68319bbdb380469f7c8ab1ea0945e
-  data.tar.gz: d8c722105fb3b85f0cab312ec82ea81a2de12fae214f9f555bfb7ce6c3929184f231c13f228b182c9c268ab62e3ee94751295b00f939347012cfa43ed797e81a
+  metadata.gz: 4a9c56ef732bc424fbc7a04484c5967bba3d9714d1f520f2b017b07c9fd939b8126b6fc7ff575fe538911be951a0a0da8025dde7e50724c42bdab005703219a8
+  data.tar.gz: 728eefa18600408fcb6475ec87fe83669a0f373500bcbe2a010e2f0f0776c8bd8a5120c4f16ffcca886125be307a58ab369e38161345ed1df567464ee7777ec8

data/lib/tracelit/error_span_processor.rb

@@ -13,12 +13,27 @@ module Tracelit
   #   so there is no double-export for sampled error spans
   #
   # NOTE: opentelemetry-sdk 1.x uses on_finish (not on_end) as the hook name.
+  #
+  # Important: this processor must never block application threads. Exporting an
+  # unsampled error span synchronously in on_finish can block request / console
+  # threads when the ingest endpoint is slow or retrying. We enqueue span data
+  # into a bounded in-memory queue and export on a background worker thread.
   class ErrorSpanProcessor
+    QUEUE_CAPACITY = 512
+    SHUTDOWN_SENTINEL = Object.new
+
     def initialize(exporter)
       @exporter = exporter
+      @queue = SizedQueue.new(QUEUE_CAPACITY)
+      @shutdown = false
+      @worker = Thread.new do
+        Thread.current[:tracelit_error_export_worker] = true
+        worker_loop
+      end
+      @worker.abort_on_exception = false
     end
 
-    def on_start(span, parent_context)
+    def on_start(_span, _parent_context)
       # nothing to do at start
     end
 
@@ -30,19 +45,71 @@ module Tracelit
       # This prevents double-export of error spans on traces that were sampled.
       return if span.context.trace_flags.sampled?
 
-      # Force-export this error span regardless of sampling decision
-      @exporter.export([span.to_span_data])
+      # Queue for background export; never block the caller.
+      enqueue(span.to_span_data)
     rescue StandardError
       # Never let processor errors propagate to the application
     end
 
     def force_flush(timeout: nil)
+      wait_for_queue_drain(timeout)
       @exporter.force_flush(timeout: timeout)
     end
 
     def shutdown(timeout: nil)
+      return if @shutdown
+      @shutdown = true
+      enqueue_shutdown_signal
+      @worker&.join(timeout || 1)
       # Do not shut down the shared exporter here —
       # the BatchSpanProcessor owns its lifecycle
     end
+
+    private
+
+    def worker_loop
+      loop do
+        item = @queue.pop
+        break if item.equal?(SHUTDOWN_SENTINEL)
+
+        begin
+          @exporter.export([item])
+        rescue StandardError
+          # Never let exporter failures crash the app worker thread
+        end
+      end
+    rescue StandardError
+      # Last-ditch guard: processor background failures must stay isolated.
+    end
+
+    def enqueue(span_data)
+      @queue.push(span_data, true)
+    rescue ThreadError
+      # Queue full — drop to protect application latency.
+    end
+
+    def enqueue_shutdown_signal
+      @queue.push(SHUTDOWN_SENTINEL, true)
+    rescue ThreadError
+      # Queue is full: drop one oldest item and retry so shutdown can proceed.
+      begin
+        @queue.pop(true)
+      rescue ThreadError
+        # no-op
+      end
+      begin
+        @queue.push(SHUTDOWN_SENTINEL, true)
+      rescue ThreadError
+        # no-op — join timeout is a final guard
+      end
+    end
+
+    def wait_for_queue_drain(timeout)
+      deadline = timeout ? Time.now + timeout : nil
+      until @queue.empty?
+        break if deadline && Time.now >= deadline
+        sleep(0.01)
+      end
+    end
   end
 end

data/lib/tracelit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tracelit
-  VERSION = "0.1.8"
+  VERSION = "0.1.9"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tracelit
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.9
 platform: ruby
 authors:
 - Tracelit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-05 00:00:00.000000000 Z
+date: 2026-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-sdk