flare 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cee6e0910ebcd04f073efc41638823f7ed4d7abf511ab71b68caead994997af1
-  data.tar.gz: f28d669e444b2abb8b6043990b8f1cfc5cbd39abc14d25942cf5f41e08a80cb2
+  metadata.gz: 51460501eac978ca4b5296191b28b820e3d61092465af21df9427c2f8c1c8586
+  data.tar.gz: 61f8e21adfaad80e0698a5c3a609041aa95c4ce605c99878f15a187f14c049b0
 SHA512:
-  metadata.gz: 06647d35a64ae38dafb6e946b181fd87a8b8dc8e7065c5b0d4af3cb47419bd5be5dc9e930f3aa322740e824279169d9b2ae867c2b3c14dfda22c1d01be25507d
-  data.tar.gz: 837f70a2ef44f4d0f8c415cc15c6455ab5250b63e7dd06580ad640492385d8d1e6842cda3f56b036d918bb38c7b55438a2d60546a6c41fd7ce77a429b2d1793a
+  metadata.gz: fc97c65d39676d6613aa9878e80cb84f3ac9ec946042fd69dd164ca2c6ed558ee948757bcff8e0a71a401fe379391dc801d0cf85c0201615d036089ce37c4423
+  data.tar.gz: 0adcea8c4075c11a507a1efb8bc7d74a2ef670b76cf8b20578d04cb44de69a1009de69f75d896978a631347f43c65ac3528065c9419bc1be51df555e0dcdef7b

data/lib/flare/lifecycle.rb

@@ -26,6 +26,41 @@ module Flare
       OpenTelemetry::SDK::Trace::Export::FAILURE
     end
 
+    SHUTDOWN_TIMEOUT = 5       # seconds, total across all of Flare
+    TRACE_SHUTDOWN_TIMEOUT = 1 # seconds; sampled traces are expendable
+
+    # Stop everything Flare runs in the background under one budget, in
+    # priority order. Runs from at_exit in every forked worker, so it must
+    # finish well before the platform's kill deadline even if endpoints hang.
+    # Metrics (a minute of aggregated counts) get first claim on the time;
+    # span/trace processors get what's left, capped at TRACE_SHUTDOWN_TIMEOUT.
+    def shutdown(timeout: SHUTDOWN_TIMEOUT)
+      deadline = Deadline.new(timeout)
+
+      shutdown_step("rule manager") { @rule_manager&.stop(timeout: 0) }
+      shutdown_step("metrics") { @metric_flusher&.stop(timeout: [deadline.remaining - TRACE_SHUTDOWN_TIMEOUT, 0].max) }
+
+      traces = Deadline.new([deadline.remaining, TRACE_SHUTDOWN_TIMEOUT].min)
+      if configuration.spans_enabled && @span_processor
+        shutdown_step("span processor") { span_processor.shutdown(timeout: traces.remaining) }
+      end
+      shutdown_step("trace processor") { @trace_span_processor&.shutdown(timeout: traces.remaining) }
+    end
+
+    # Each step is isolated so one failure doesn't skip the rest.
+    def shutdown_step(name)
+      yield
+    rescue => e
+      warn "[Flare] #{name} shutdown error: #{e.message}"
+    end
+
+    def install_shutdown_hook
+      return if @shutdown_hook_installed
+
+      @shutdown_hook_installed = true
+      at_exit { shutdown }
+    end
+
     def tracer_provider_for_flush
       OpenTelemetry.tracer_provider
     end

data/lib/flare/metric_flusher.rb

@@ -116,6 +116,8 @@ module Flare
     # on first span in the new process, or manually from Puma/Unicorn
     # after_fork hooks.
     def after_fork
+      return if @pid == $$
+
       @pid = $$
       @storage.after_fork if @storage.respond_to?(:after_fork)
       initialize_synchronization

data/lib/flare/rule_manager.rb

@@ -60,10 +60,10 @@ module Flare
       self
     end
 
-    def stop
+    def stop(timeout: 1)
       if @timer
         @timer.shutdown
-        @timer.wait_for_termination(1)
+        @timer.wait_for_termination(timeout)
         @timer.kill unless @timer.shutdown?
         @timer = nil
       end

data/lib/flare/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Flare
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

data/lib/flare.rb

@@ -230,20 +230,7 @@ module Flare
       subscribe_to_notifications
     end
 
-    at_exit do
-      log "Shutting down..."
-      if configuration.spans_enabled && @span_processor
-        span_processor.force_flush
-        span_processor.shutdown
-        log "Span processor flushed and stopped"
-      end
-      if @trace_span_processor
-        @trace_span_processor.force_flush
-        @trace_span_processor.shutdown
-        log "Trace span processor flushed and stopped"
-      end
-      log "Shutdown complete"
-    end
+    install_shutdown_hook
 
     @otel_configured = true
   end
@@ -272,7 +259,7 @@ module Flare
     @rule_manager.start
     log "Rule manager started (poll=#{configuration.tracing_poll_interval}s)"
 
-    at_exit { @rule_manager&.stop }
+    install_shutdown_hook
   end
 
   def setup_tracing_components
@@ -357,7 +344,7 @@ module Flare
       @metric_flusher.start
       log "Metrics flusher started (interval=#{configuration.metrics_flush_interval}s)"
 
-      at_exit { @metric_flusher&.stop }
+      install_shutdown_hook
     else
       log "Metrics submission not configured (missing url or key)"
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flare
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - John Nunemaker