rails-profiler 0.30.12 → 0.30.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc826508539b9892ab3317d52a95d77cdb162b4439a4086ae3c538239edb7eaa
-  data.tar.gz: 05c364a0cfeca030f37e635b35b150819f81f266de13137f98d33b9a9be29a53
+  metadata.gz: e09eb31d9bcb170273cd7c9df1f6e149d772d38cd52fd0f6d2930644054ccc8d
+  data.tar.gz: 5b8996d059b59b4a69e702ff238060dd83e08614fa416ae09ed8ed077d0d550f
 SHA512:
-  metadata.gz: b0439a929e4b29fb9cc74ea0806135bfe10fb619bac6664c375aac1ae2b969f5adcd51a1f2d04322878c952d79430e6dec6350f4bda37665df26fe459b63ac0f
-  data.tar.gz: cedc00eb32c405fa556be7723fe2adde3ae7704c57e2053d6fcf8828c933deecb1b300833f7975fdd3239679c25512435c8ccf107e7d84925400f00ea661aa02
+  metadata.gz: 5042a2f2c93acb5fd91e27907880d01b51aecaa7316a34886b827ec73584d9e3dcf356d07079f368066511fe447b06ecbeba1520e5a245befd82eb10f45b2d46
+  data.tar.gz: 8ca5df627c525ad56bddfcfa01771f0e8d23f2c3b6ade75d71dde0ea9db85a2d06ca2b2807f834f6195aba3423197d674986033427edae7d612ada1b7398b028

data/CHANGELOG.md

@@ -19,6 +19,74 @@ every commit of every tag interval is accounted for one way or the other.
 
 ## [Unreleased]
 
+## [0.30.14] - 2026-10-05
+
+<!-- stamped -->
+
+### Fixed
+
+- **Railtie:** Honor `config.enabled` set in `config/initializers/profiler.rb`. The profiler
+  decided before the application's initializers had run, so `enabled = false` there still put its
+  middlewares in the stack, configured Sidekiq, included its ActiveJob instrumentation and, in
+  the test environment, loaded the test profiler, and `enabled = true` in production got none of
+  them. Those decisions are now taken once the application's initializers have run. An active
+  profiler keeps its place in the middleware stack, and its Sidekiq middlewares and ActiveJob
+  callbacks stay ahead of the ones the application installs. The profiler is now the outermost
+  layer around a job: it runs before every other Sidekiq middleware, including those of gems
+  loaded before it and those the application prepends (such as `Sidekiq::CurrentAttributes`),
+  and before the callbacks Rails adds to ActiveJob (logging, instrumentation, and on Rails 7.0
+  time zone and locale), so the duration of a profiled job now includes them.
+- **Railtie:** Keep the `enabled`, `storage` and `track_tests` values set with
+  `Profiler.configure` in `config/application.rb`, which the Rails defaults overwrote at boot, and
+  apply `config.profiler` (`config.profiler.enabled = false` in `config/application.rb`), which was
+  accepted and never read. A `config.profiler` key that is not a profiler option logs a warning.
+  `config/initializers/profiler.rb` still has the last word. Check these places when upgrading:
+  an `enabled` set with `Profiler.configure` in `config/application.rb` or in a
+  `config/environments` file, or with `config.profiler.enabled`, now takes effect, in production
+  too, where it was overwritten or ignored before.
+
+## [0.30.13] - 2026-10-04
+
+<!-- stamped -->
+
+### Fixed
+
+- **Middleware:** A request that raises below the profiler no longer runs your application a
+  second time, and no longer leaves the collectors installed. Until now the exception made the
+  profiler call the application again, duplicating its side effects (two emails sent, two
+  records written), and every SQL, view, cache, mailer and controller subscriber, the log sink on
+  `Rails.logger`, the StackProf sampler or the `TracePoint` of the function profiler stayed active
+  for the life of the process: memory and request time grew with each failed request until the
+  process was killed. Any exception between the profiler and `ShowExceptions` triggers it, for
+  example `ActionDispatch::RemoteIp::IpSpoofAttackError` on contradictory `Client-IP` and
+  `X-Forwarded-For` headers, and in tests every exception a controller raises. The exception now
+  goes on to the server unchanged, and the profile of the failed request is kept, with status 500
+  and the exception in the Exception tab.
+- **Collectors:** Collectors gain `unsubscribe`, which releases what `subscribe` installed and runs
+  after `collect` and on every error path, for requests, jobs, console commands and tests alike.
+  A collector that fails to subscribe no longer leaves the others installed: the work runs once,
+  unprofiled. A custom collector that subscribes to something should implement `unsubscribe`, as
+  the README example now does.
+- **Logs:** On Rails 7.0, the log collector no longer extends `Rails.logger` with a new module on
+  every request; one shared sink is attached once, and only records while a profile runs on the
+  thread.
+- **Collectors:** A job performed inline during a profiled request (`perform_now`, or the
+  `:inline` adapter) no longer takes the request's records with it. The job's collectors now hand
+  back the thread-local slots they borrow, so the request keeps its logs, dumps, outbound HTTP
+  calls and timeline events from before and after the job, and the job's profile gets only what
+  the job did. Until now the job erased the request's logs and dumps recorded before it, and the
+  request lost its HTTP calls and timeline events from after it.
+- **Middleware:** A request cut short by a timeout (`Timeout::ExitException`,
+  `Rack::Timeout::RequestTimeoutException`) keeps its profile too, with status 500. A request
+  stopped by a signal or by `exit` keeps none. An exception outside `StandardError` raised while
+  the collectors are being set up no longer leaves them installed.
+- **Function profiler:** In sampling (`lite`) mode, a request no longer stops the StackProf
+  sampler that a concurrent request started, nor takes its samples: its profile says the sampler
+  was busy instead.
+- **Dumps:** `Profiler.dump` called outside a profile that collects dumps (a request the profiler
+  skips, a test profile) no longer keeps the value on the thread. Nothing ever read those dumps,
+  and the thread held on to them, and to everything they referenced, for good.
+
 ## [0.30.12] - 2026-10-04
 
 <!-- stamped -->

data/lib/profiler/collectors/base_collector.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "../redaction"
+require_relative "lifecycle"
 
 module Profiler
   module Collectors
@@ -59,6 +60,13 @@ module Profiler
         # Override in subclasses to subscribe to ActiveSupport::Notifications
       end
 
+      # Releases whatever subscribe installed: notification subscribers, samplers, log sinks,
+      # thread-local slots. Called after collect, and on every path where collect never runs,
+      # so it has to be idempotent and safe when subscribe failed part way or never ran.
+      def unsubscribe
+        # Override in subclasses that install something in subscribe
+      end
+
       def collect
         # Override in subclasses to collect data
       end
@@ -89,6 +97,27 @@ module Profiler
         @data = data
         @profile.add_collector_data(name, data)
       end
+
+      # Thread-local slots follow a stack: subscribe takes one over and remembers what it held,
+      # unsubscribe hands it back. A job performed inline during a request thus records into
+      # its own slots, and the request gets its own back, with what it recorded before the job.
+      def claim_thread_slot(key, value)
+        @claimed_thread_slots ||= {}
+        @claimed_thread_slots[key] = Thread.current[key] unless @claimed_thread_slots.key?(key)
+        Thread.current[key] = value
+      end
+
+      def restore_thread_slots
+        @claimed_thread_slots&.each { |key, previous| Thread.current[key] = previous }
+        @claimed_thread_slots = nil
+      end
+
+      def unsubscribe_notifications(subscriptions)
+        return unless defined?(ActiveSupport::Notifications)
+
+        subscriptions.each { |sub| ActiveSupport::Notifications.unsubscribe(sub) }
+        subscriptions.clear
+      end
     end
   end
 end

data/lib/profiler/collectors/cache_collector.rb

@@ -62,7 +62,7 @@ module Profiler
       end
 
       def collect
-        @subscriptions.each { |sub| ActiveSupport::Notifications.unsubscribe(sub) }
+        unsubscribe
 
         hits = @cache_reads.count { |r| r[:hit] }
         misses = @cache_reads.count { |r| !r[:hit] }
@@ -82,6 +82,10 @@ module Profiler
         store_data(data)
       end
 
+      def unsubscribe
+        unsubscribe_notifications(@subscriptions)
+      end
+
       def toolbar_summary
         hits = @cache_reads.count { |r| r[:hit] }
         total = @cache_reads.size

data/lib/profiler/collectors/database_collector.rb

@@ -55,8 +55,7 @@ module Profiler
       end
 
       def collect
-        # Unsubscribe from notifications
-        ActiveSupport::Notifications.unsubscribe(@subscription) if @subscription
+        unsubscribe
 
         data = {
           total_queries: @queries.size,
@@ -69,6 +68,13 @@ module Profiler
         store_data(data)
       end
 
+      def unsubscribe
+        return unless @subscription
+
+        ActiveSupport::Notifications.unsubscribe(@subscription)
+        @subscription = nil
+      end
+
       def toolbar_summary
         total = @queries.size
         slow = @queries.select { |q| q.slow?(Profiler.configuration.slow_query_threshold) }.size

data/lib/profiler/collectors/dump_collector.rb

@@ -30,7 +30,8 @@ module Profiler
       end
 
       def collect
-        dumps = Thread.current[:profiler_dumps] || []
+        dumps = @dumps || Thread.current[:profiler_dumps] || []
+        unsubscribe
 
         formatted_dumps = dumps.map do |dump|
           {
@@ -47,9 +48,15 @@ module Profiler
           count: formatted_dumps.size,
           dumps: formatted_dumps
         })
+      end
+
+      # Profiler.dump fills this slot while the profile runs.
+      def subscribe
+        @dumps = claim_thread_slot(:profiler_dumps, [])
+      end
 
-        # Clear dumps for next request
-        Thread.current[:profiler_dumps] = []
+      def unsubscribe
+        restore_thread_slots
       end
 
       def toolbar_summary

data/lib/profiler/collectors/exception_collector.rb

@@ -43,11 +43,18 @@ module Profiler
       end
 
       def collect
-        ActiveSupport::Notifications.unsubscribe(@subscriber) if @subscriber
+        unsubscribe
 
         store_data(@exception_data || {})
       end
 
+      def unsubscribe
+        return unless @subscriber
+
+        ActiveSupport::Notifications.unsubscribe(@subscriber)
+        @subscriber = nil
+      end
+
       def has_data?
         !@exception_data.nil? && !@exception_data.empty?
       end

data/lib/profiler/collectors/flamegraph_collector.rb

@@ -35,7 +35,7 @@ module Profiler
       def subscribe
         return unless defined?(ActiveSupport::Notifications)
 
-        Thread.current[:profiler_flamegraph_collector] = self
+        claim_thread_slot(:profiler_flamegraph_collector, self)
 
         # Controller action
         @subscriptions << ActiveSupport::Notifications.monotonic_subscribe("process_action.action_controller") do |_name, started, finished, _unique_id, payload|
@@ -133,8 +133,7 @@ module Profiler
       end
 
       def collect
-        @subscriptions.each { |sub| ActiveSupport::Notifications.unsubscribe(sub) }
-        Thread.current[:profiler_flamegraph_collector] = nil
+        unsubscribe
 
         root_events = build_hierarchy(@events)
 
@@ -145,6 +144,11 @@ module Profiler
         })
       end
 
+      def unsubscribe
+        unsubscribe_notifications(@subscriptions)
+        restore_thread_slots
+      end
+
       def toolbar_summary
         {
           text: "#{@events.size} events",

data/lib/profiler/collectors/function_profiler_collector.rb

@@ -55,42 +55,66 @@ module Profiler
 
         mode  = Profiler.function_profiling_mode
         clock = Profiler.function_profiling_clock
-        Thread.current[:fn_profiler_mode]  = mode
-        Thread.current[:fn_profiler_clock] = clock
+        @subscribed = true
+        claim_thread_slot(:fn_profiler_mode, mode)
+        claim_thread_slot(:fn_profiler_clock, clock)
 
         if mode == "lite" && defined?(StackProf)
           # Always record wall + cpu at request level for the comparison stat
-          Thread.current[:fn_profiler_wall_start] = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-          Thread.current[:fn_profiler_cpu_start]  = Process.clock_gettime(Process::CLOCK_PROCESS_CPUTIME_ID)
+          claim_thread_slot(:fn_profiler_wall_start, Process.clock_gettime(Process::CLOCK_MONOTONIC))
+          claim_thread_slot(:fn_profiler_cpu_start, Process.clock_gettime(Process::CLOCK_PROCESS_CPUTIME_ID))
 
           sp_mode = case clock
                     when "cpu"    then :cpu
                     when "object" then :object
                     else               :wall
                     end
-          StackProf.start(mode: sp_mode, interval: 1000, raw: true)
+          # false when another request already runs the process-wide sampler: then it is not
+          # this collector's to stop on release.
+          @stackprof_started = StackProf.start(mode: sp_mode, interval: 1000, raw: true)
         else
           subscribe_tracepoint(mode)
         end
       end
 
       def collect
+        # Disabled: subscribe stored the "off" data, and there is no sampler of ours to read.
+        return unless @subscribed
+
         mode  = Thread.current[:fn_profiler_mode]  || Profiler.function_profiling_mode
         clock = Thread.current[:fn_profiler_clock] || Profiler.function_profiling_clock
-        Thread.current[:fn_profiler_mode]  = nil
-        Thread.current[:fn_profiler_clock] = nil
 
         if mode == "lite" && defined?(StackProf)
+          # The sampler is process-wide: when another request started it, its samples are not
+          # this request's to take, nor is it this collector's to stop.
+          return store_sampler_busy(mode, clock) unless @stackprof_started
+
           StackProf.stop
+          @stackprof_started = false
           result   = StackProf.results
           wall_ms  = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - (Thread.current[:fn_profiler_wall_start] || 0)) * 1000
           cpu_ms   = (Process.clock_gettime(Process::CLOCK_PROCESS_CPUTIME_ID) - (Thread.current[:fn_profiler_cpu_start] || 0)) * 1000
-          Thread.current[:fn_profiler_wall_start] = nil
-          Thread.current[:fn_profiler_cpu_start]  = nil
           collect_stackprof(result, mode, clock, wall_ms, cpu_ms)
         else
           collect_tracepoint(mode)
         end
+      ensure
+        unsubscribe
+      end
+
+      def unsubscribe
+        if @stackprof_started
+          @stackprof_started = false
+          if StackProf.running?
+            StackProf.stop
+            StackProf.results # discards the samples and frees the sampler's buffers
+          end
+        end
+
+        @trace&.disable
+        @trace = nil
+
+        restore_thread_slots
       end
 
       def toolbar_summary
@@ -105,6 +129,12 @@ module Profiler
 
       # ── StackProf (lite mode) ──────────────────────────────────────────────────
 
+      def store_sampler_busy(mode, clock)
+        store_data({ enabled: true, mode: mode, clock: clock, sampler_busy: true, max_frames: 0,
+                     frame_cap_reached: false, total_calls: 0, total_duration: 0,
+                     functions: [], root_calls: [] })
+      end
+
       def collect_stackprof(result, mode, clock, wall_ms, cpu_ms)
         unless result
           store_data({ enabled: true, mode: mode, clock: clock, max_frames: 0,
@@ -261,10 +291,10 @@ module Profiler
         app_root   = app_root_path
         max_frames = Profiler.function_profiling_max_frames
 
-        Thread.current[:fn_profiler_stack] = []
-        Thread.current[:fn_profiler_roots] = []
-        Thread.current[:fn_profiler_count] = 0
-        Thread.current[:fn_profiler_depth] = Hash.new(0)
+        claim_thread_slot(:fn_profiler_stack, [])
+        claim_thread_slot(:fn_profiler_roots, [])
+        claim_thread_slot(:fn_profiler_count, 0)
+        claim_thread_slot(:fn_profiler_depth, Hash.new(0))
 
         @trace = TracePoint.new(:call, :return) do |tp|
           next unless tp.path&.start_with?(app_root)
@@ -336,11 +366,6 @@ module Profiler
           end
         end
 
-        Thread.current[:fn_profiler_stack] = nil
-        Thread.current[:fn_profiler_roots] = nil
-        Thread.current[:fn_profiler_count] = nil
-        Thread.current[:fn_profiler_depth] = nil
-
         stats = {}
         aggregate(roots, stats)
         sorted_functions = stats.values.sort_by { |s| -s[:total_duration] }

data/lib/profiler/collectors/http_collector.rb

@@ -36,11 +36,17 @@ module Profiler
         return unless Profiler.configuration.track_http
 
         Profiler::Instrumentation::NetHttpInstrumentation.install!
-        Thread.current[:profiler_http_collector] = self
+        claim_thread_slot(:profiler_http_collector, self)
+      end
+
+      # The Net::HTTP patch installed by subscribe stays: it is installed once per process and
+      # records nothing when no collector holds the thread-local slot.
+      def unsubscribe
+        restore_thread_slots
       end
 
       def collect
-        Thread.current[:profiler_http_collector] = nil
+        unsubscribe
 
         data = @mutex.synchronize do
           @collected = true

data/lib/profiler/collectors/i18n_collector.rb

@@ -53,11 +53,17 @@ module Profiler
           I18n.singleton_class.prepend(Profiler::I18nLookupTracker)
         end
 
-        Thread.current[:profiler_i18n_collector] = self
+        claim_thread_slot(:profiler_i18n_collector, self)
+      end
+
+      # The I18n patch installed by subscribe stays: it is prepended once per process and
+      # records nothing when no collector holds the thread-local slot.
+      def unsubscribe
+        restore_thread_slots
       end
 
       def collect
-        Thread.current[:profiler_i18n_collector] = nil
+        unsubscribe
 
         missing_count = @lookups.count { |l| l[:missing] }
 

data/lib/profiler/collectors/lifecycle.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Profiler
+  module Collectors
+    # Subscribes and releases the collectors of one profile, for every entry point that runs
+    # them (the request middleware, jobs, console commands, tests).
+    module Lifecycle
+      module_function
+
+      # Subscribes each collector in turn. When one fails, releases them all, the ones that
+      # never subscribed included, and returns false: the caller then runs the work unprofiled.
+      def subscribe_all(collectors, label)
+        collectors.each { |collector| collector.subscribe if collector.respond_to?(:subscribe) }
+        true
+      rescue => e
+        warn "Profiler #{label}: Collector subscribe failed: #{e.message}"
+        release_all(collectors)
+        false
+      end
+
+      # Releases every collector, whatever happened before, one failure not stopping the others.
+      def release_all(collectors)
+        collectors&.each do |collector|
+          collector.unsubscribe if collector.respond_to?(:unsubscribe)
+        rescue => e
+          warn "Profiler: Collector #{collector.class} release failed: #{e.message}"
+        end
+      end
+    end
+  end
+end

data/lib/profiler/collectors/log_collector.rb

@@ -8,18 +8,26 @@ module Profiler
     class LogCollector < BaseCollector
       SEVERITY_LABELS = %w[DEBUG INFO WARN ERROR FATAL UNKNOWN].freeze
 
+      # Records into the thread's buffer, which only exists while a LogCollector of this thread
+      # is subscribed: lines logged by other threads, or after release, are not kept. A logger
+      # bound to one collector's buffer records only while that buffer is the thread's current
+      # one, so a job performed inline during a request does not log twice into the job.
       class CaptureLogger < ::Logger
-        def initialize
+        def initialize(buffer = nil)
           super(File::NULL)
+          @buffer = buffer
         end
 
         def add(severity, message = nil, progname = nil)
+          logs = Thread.current[:profiler_logs]
+          return true unless logs
+          return true if @buffer && !logs.equal?(@buffer)
+
           msg = message || progname
           msg = yield if block_given? && msg.nil?
           return true if msg.nil?
 
-          Thread.current[:profiler_logs] ||= []
-          Thread.current[:profiler_logs] << {
+          logs << {
             level: SEVERITY_LABELS[severity] || "UNKNOWN",
             message: msg.to_s.strip,
             timestamp: Time.now.iso8601(3)
@@ -55,31 +63,48 @@ module Profiler
         }
       end
 
+      # Rails 7.0 broadcasts by extending the logger with a module, which cannot be taken off
+      # again: the logger gets one shared CaptureLogger, once, instead of one per request.
+      LEGACY_CAPTURE_LOGGER = CaptureLogger.new
+      LEGACY_BROADCAST_MUTEX = Mutex.new
+
+      def self.attach_legacy_broadcast(logger)
+        LEGACY_BROADCAST_MUTEX.synchronize do
+          return if logger.instance_variable_get(:@profiler_capture_attached)
+
+          logger.extend(ActiveSupport::Logger.broadcast(LEGACY_CAPTURE_LOGGER))
+          logger.instance_variable_set(:@profiler_capture_attached, true)
+        end
+      end
+
       def subscribe
-        Thread.current[:profiler_logs] = []
-        @capture_logger = CaptureLogger.new
+        @logs = claim_thread_slot(:profiler_logs, [])
 
         if defined?(Rails) && Rails.logger
           if Rails.logger.respond_to?(:broadcast_to)
-            Rails.logger.broadcast_to(@capture_logger)
-          elsif defined?(ActiveSupport::Logger)
-            Rails.logger.extend(ActiveSupport::Logger.broadcast(@capture_logger))
+            @capture_logger = CaptureLogger.new(@logs)
+            @broadcaster = Rails.logger
+            @broadcaster.broadcast_to(@capture_logger)
+          elsif defined?(ActiveSupport::Logger) && ActiveSupport::Logger.respond_to?(:broadcast)
+            self.class.attach_legacy_broadcast(Rails.logger)
           end
         end
       rescue => e
         warn "LogCollector#subscribe failed: #{e.message}"
       end
 
-      def collect
-        logs = Thread.current[:profiler_logs] || []
-
-        if defined?(Rails) && Rails.logger && @capture_logger
-          if Rails.logger.respond_to?(:stop_broadcasting_to)
-            Rails.logger.stop_broadcasting_to(@capture_logger)
-          end
+      def unsubscribe
+        if @capture_logger
+          @broadcaster.stop_broadcasting_to(@capture_logger) if @broadcaster.respond_to?(:stop_broadcasting_to)
+          @capture_logger = nil
+          @broadcaster = nil
         end
+        restore_thread_slots
+      end
 
-        Thread.current[:profiler_logs] = []
+      def collect
+        logs = @logs || Thread.current[:profiler_logs] || []
+        unsubscribe
 
         errors   = logs.count { |l| %w[ERROR FATAL].include?(l[:level]) }
         warnings = logs.count { |l| l[:level] == "WARN" }

data/lib/profiler/collectors/mailer_collector.rb

@@ -45,7 +45,7 @@ module Profiler
         @subscriber_thread = Thread.current
 
         # Use a stack so multiple deliver_later calls in the same request are all tracked.
-        Thread.current[:profiler_pending_processes] ||= []
+        claim_thread_slot(:profiler_pending_processes, [])
 
         @subscriptions << ActiveSupport::Notifications.monotonic_subscribe("process.action_mailer") do |_name, started, finished, _id, payload|
           next unless Thread.current.equal?(@subscriber_thread)
@@ -53,7 +53,10 @@ module Profiler
 
           mailer_class = payload[:mailer].to_s
           action = payload[:action].to_s
-          (Thread.current[:profiler_pending_processes] ||= []) << {
+          pending = Thread.current[:profiler_pending_processes]
+          next unless pending
+
+          pending << {
             mailer_class: mailer_class,
             action: action,
             duration_ms: ((finished - started) * 1000).round(2),
@@ -67,7 +70,7 @@ module Profiler
           next if rails_preview_request?
 
           delivery_ms = ((finished - started) * 1000).round(2)
-          process_info = (Thread.current[:profiler_pending_processes] ||= []).pop || {}
+          process_info = Thread.current[:profiler_pending_processes]&.pop || {}
           mail = payload[:mail]
 
           mailer_class = process_info[:mailer_class] || payload[:mailer_class].to_s
@@ -87,7 +90,7 @@ module Profiler
         # Any remaining pending process entries had no matching deliver event:
         # they were enqueued via deliver_later in the HTTP context.
         pending = Thread.current[:profiler_pending_processes] || []
-        Thread.current[:profiler_pending_processes] = nil
+        unsubscribe
 
         pending.each do |info|
           @queued << {
@@ -102,8 +105,6 @@ module Profiler
           }
         end
 
-        @subscriptions.each { |sub| ActiveSupport::Notifications.unsubscribe(sub) }
-
         detect_loops
 
         truncated = @emails.size > MAX_EMAILS
@@ -124,6 +125,11 @@ module Profiler
         )
       end
 
+      def unsubscribe
+        unsubscribe_notifications(@subscriptions)
+        restore_thread_slots
+      end
+
       def has_data?
         @emails.any? || @errors.any? || @queued.any?
       end

data/lib/profiler/collectors/view_collector.rb

@@ -53,7 +53,7 @@ module Profiler
       end
 
       def collect
-        @subscriptions.each { |sub| ActiveSupport::Notifications.unsubscribe(sub) }
+        unsubscribe
 
         data = {
           views: @views,
@@ -66,6 +66,10 @@ module Profiler
         store_data(data)
       end
 
+      def unsubscribe
+        unsubscribe_notifications(@subscriptions)
+      end
+
       def toolbar_summary
         total_duration = (@views + @partials).sum { |v| v[:duration] }.round(2)
 

data/lib/profiler/configuration.rb

@@ -25,7 +25,11 @@ module Profiler
       BUNDLE_GEMFILE BUNDLE_PATH BUNDLE_WITHOUT GEM_HOME GEM_PATH BOOTSNAP_CACHE_DIR
     ].freeze
 
-    attr_accessor :enabled, :storage_options, :collectors,
+    # Options whose default depends on the Rails environment: the railtie sets them only when
+    # the application has not assigned them itself (see #default).
+    RAILS_DEFAULTED = %i[enabled storage track_tests].freeze
+
+    attr_accessor :storage_options, :collectors,
                   :skip_paths, :slow_query_threshold, :max_queries_warning,
                   :track_memory, :memory_warning_threshold,
                   :mcp_enabled, :mcp_transport, :mcp_port,
@@ -36,7 +40,7 @@ module Profiler
                   :track_jobs,
                   :track_console,
                   :apply_env_overrides_when_disabled,
-                  :track_tests, :test_runner_allow_undiscovered_files,
+                  :test_runner_allow_undiscovered_files,
                   :track_mailers, :capture_mail_body, :sanitize_mailer_recipients, :mailer_skip_actions,
                   :compress_bodies, :compress_body_threshold,
                   :redact_sensitive_data, :filter_parameters, :env_allowlist,
@@ -47,9 +51,10 @@ module Profiler
 
     attr_writer :tmp_path
 
-    attr_reader :authorize_block
+    attr_reader :authorize_block, :enabled, :track_tests
 
     def initialize
+      @assigned = []
       @enabled = false
       @storage = :memory
       @storage_options = {}
@@ -112,6 +117,26 @@ module Profiler
       @tmp_path || default_tmp_path
     end
 
+    def enabled=(value)
+      @assigned |= [:enabled]
+      @enabled = value
+    end
+
+    def track_tests=(value)
+      @assigned |= [:track_tests]
+      @track_tests = value
+    end
+
+    # Sets one of RAILS_DEFAULTED to value unless the application assigned it, in
+    # config/application.rb for instance, which runs before the railtie's initializers.
+    def default(option, value)
+      raise ArgumentError, "#{option} has no Rails default" unless RAILS_DEFAULTED.include?(option)
+      return if @assigned.include?(option)
+
+      public_send("#{option}=", value)
+      @assigned.delete(option)
+    end
+
     def slave?
       !master_url.nil? && !master_url.empty?
     end
@@ -162,6 +187,7 @@ module Profiler
     end
 
     def storage=(value)
+      @assigned |= [:storage]
       @storage = value
       @storage_backend = nil
     end

data/lib/profiler/console_profiler.rb

@@ -44,7 +44,7 @@ module Profiler
 
       console_collector = Collectors::ConsoleCollector.new(profile, expression: @expression)
       collectors = [console_collector] + CONSOLE_COLLECTOR_CLASSES.map { |klass| klass.new(profile) }
-      collectors.each { |c| c.subscribe if c.respond_to?(:subscribe) }
+      return block.call unless Collectors::Lifecycle.subscribe_all(collectors, "ConsoleProfiler")
 
       exception_collector = collectors.find { |c| c.is_a?(Collectors::ExceptionCollector) }
 
@@ -82,6 +82,9 @@ module Profiler
 
         Profiler.storage.save(profile.token, profile)
       end
+    ensure
+      # After collect, and also when collect or the storage failed.
+      Collectors::Lifecycle.release_all(collectors)
     end
 
     private

data/lib/profiler/instrumentation/active_job_instrumentation.rb

@@ -8,11 +8,12 @@ module Profiler
       included do
         attr_accessor :profiler_parent_token
 
-        before_enqueue do |job|
+        # Ahead of the application's callbacks, which may already be there when this is included.
+        before_enqueue(prepend: true) do |job|
           job.profiler_parent_token = Profiler::CurrentContext.token
         end
 
-        around_perform do |job, block|
+        around_perform(prepend: true) do |job, block|
           Profiler::JobProfiler.profile(
             job_class: job.class.name,
             job_id: job.job_id,

data/lib/profiler/job_profiler.rb

@@ -67,7 +67,7 @@ module Profiler
       })
 
       collectors = [job_collector] + JOB_COLLECTOR_CLASSES.map { |klass| klass.new(profile) }
-      collectors.each { |c| c.subscribe if c.respond_to?(:subscribe) }
+      return block.call unless Collectors::Lifecycle.subscribe_all(collectors, "JobProfiler")
 
       exception_collector = collectors.find { |c| c.is_a?(Collectors::ExceptionCollector) }
 
@@ -109,6 +109,9 @@ module Profiler
 
         Profiler.storage.save(profile.token, profile)
       end
+    ensure
+      # After collect, and also when collect or the storage failed.
+      Collectors::Lifecycle.release_all(collectors)
     end
 
     private

data/lib/profiler/middleware/profiler_middleware.rb

@@ -2,6 +2,7 @@
 
 require_relative "../models/profile"
 require_relative "../current_context"
+require_relative "../collectors/lifecycle"
 require_relative "toolbar_injector"
 
 module Profiler
@@ -14,28 +15,55 @@ module Profiler
       def call(env)
         return @app.call(env) unless should_profile?(env)
 
-        status = nil
-        headers = nil
-        body = nil
         collectors = nil
+        begin
+          begin
+            profile = Models::Profile.new(build_request(env))
+            profile.gem_version = Profiler::VERSION
+            Profiler::CurrentContext.token = profile.token
+
+            # Capture request body before app processes it
+            req_body_raw = read_rack_input(env)
+
+            # Store profile in env for collectors
+            env["profiler.profile"] = profile
+
+            collectors = create_collectors(profile)
+            env["profiler.collectors"] = collectors
+            subscribed = Collectors::Lifecycle.subscribe_all(collectors, "ProfilerMiddleware")
+          rescue => e
+            warn "Profiler error: #{e.message}\n#{e.backtrace.join("\n")}"
+            subscribed = false
+          end
 
-        profile = Models::Profile.new(build_request(env))
-        profile.gem_version = Profiler::VERSION
-        Profiler::CurrentContext.token = profile.token
+          unless subscribed
+            # The application has not run yet: serve the request once, unprofiled.
+            release(collectors)
+            return @app.call(env)
+          end
 
-        # Capture request body before app processes it
-        req_body_raw = read_rack_input(env)
+          # Measure memory before
+          memory_before = current_memory if Profiler.configuration.track_memory
 
-        # Store profile in env for collectors
-        env["profiler.profile"] = profile
+          begin
+            response = @app.call(env)
+          rescue Exception => e # rubocop:disable Lint/RescueException
+            record_failed_request(env, profile, collectors, req_body_raw, memory_before, e) if failed_request?(e)
+            raise
+          end
 
-        collectors = create_collectors(profile)
-        env["profiler.collectors"] = collectors
+          complete_profile(env, profile, collectors, req_body_raw, memory_before, response)
+        ensure
+          # Opened before the first subscribe: whatever happens from there on, an exception
+          # outside StandardError included, nothing a collector installed outlives the request.
+          release(collectors)
+        end
+      end
 
-        # Measure memory before
-        memory_before = current_memory if Profiler.configuration.track_memory
+      private
 
-        status, headers, body = @app.call(env)
+      def complete_profile(env, profile, collectors, req_body_raw, memory_before, response)
+        status, headers, body = response
         headers = headers.dup
 
         # Measure memory after
@@ -56,17 +84,9 @@ module Profiler
           resp_content_type: (headers["content-type"] || headers["Content-Type"]).to_s
         )
 
-        collectors.each do |collector|
-          begin
-            collector.collect if collector.respond_to?(:collect)
-            profile.add_collector_metadata(collector)
-          rescue => e
-            warn "Collector #{collector.class} failed: #{e.message}"
-          end
-        end
+        collect_all(profile, collectors)
 
         Profiler.storage.save(profile.token, profile)
-        Profiler::CurrentContext.clear
 
         headers["X-Profiler-Token"] = profile.token
 
@@ -77,13 +97,50 @@ module Profiler
 
         [status, headers, body]
       rescue => e
+        # The application has run: its response goes out, profiled or not.
         warn "Profiler error: #{e.message}\n#{e.backtrace.join("\n")}"
-        collectors&.each { |c| c.unsubscribe if c.respond_to?(:unsubscribe) }
-        Profiler::CurrentContext.clear
-        status ? [status, headers, body || []] : @app.call(env)
+        [status, headers, body || []]
       end
 
-      private
+      # A request cut short by a timeout (Timeout::ExitException, Rack::Timeout) is profiled like
+      # one that raised; one stopped by a signal or an exit is not, the process is going away.
+      def failed_request?(error)
+        !error.is_a?(SignalException) && !error.is_a?(SystemExit)
+      end
+
+      # The profile of a request that raised is kept: status 500, which the server answers once
+      # the exception leaves the stack, and the exception itself. Never masks the exception.
+      def record_failed_request(env, profile, collectors, req_body_raw, memory_before, error)
+        collectors.each { |collector| collector.capture(error) if collector.respond_to?(:capture) }
+        profile.memory = current_memory - memory_before if Profiler.configuration.track_memory
+        profile.finish(500)
+        profile.set_bodies(
+          request_body: req_body_raw,
+          response_body: "",
+          req_content_type: env["CONTENT_TYPE"].to_s,
+          resp_content_type: ""
+        )
+        collect_all(profile, collectors)
+        Profiler.storage.save(profile.token, profile)
+      rescue => e
+        warn "Profiler error while recording a failed request: #{e.message}"
+      end
+
+      def collect_all(profile, collectors)
+        collectors.each do |collector|
+          begin
+            collector.collect if collector.respond_to?(:collect)
+            profile.add_collector_metadata(collector)
+          rescue => e
+            warn "Collector #{collector.class} failed: #{e.message}"
+          end
+        end
+      end
+
+      def release(collectors)
+        Collectors::Lifecycle.release_all(collectors)
+        Profiler::CurrentContext.clear
+      end
 
       def should_profile?(env)
         return false unless Profiler.enabled?
@@ -104,12 +161,10 @@ module Profiler
         end
       end
 
+      # Builds the collectors without subscribing them: Lifecycle.subscribe_all does, so that
+      # a failure part way leaves every collector reachable for release.
       def create_collectors(profile)
-        Profiler.configuration.collectors.map do |collector_class|
-          collector = collector_class.new(profile)
-          collector.subscribe if collector.respond_to?(:subscribe)
-          collector
-        end
+        Profiler.configuration.collectors.map { |collector_class| collector_class.new(profile) }
       end
 
       def html_response?(headers)

data/lib/profiler/railtie.rb

@@ -6,27 +6,38 @@ module Profiler
   class Railtie < Rails::Railtie
     config.profiler = ActiveSupport::OrderedOptions.new
 
+    # Runs before the application's config/initializers, so that they override what it sets.
+    # The Rails defaults go only where config/application.rb, which runs earlier still, has not
+    # assigned the option, and config.profiler, also set there, is applied on top.
     initializer "profiler.set_configs" do |app|
-      # Set default configuration for Rails environment
+      development_or_test = Rails.env.development? || Rails.env.test?
       Profiler.configure do |config|
-        config.enabled = Rails.env.development? || Rails.env.test?
-        config.storage = (Rails.env.development? || Rails.env.test?) ? :file : :memory
-        config.tmp_path = Rails.root.join("tmp", "rails-profiler")
-        config.track_tests = Rails.env.test?
+        config.default(:enabled, development_or_test)
+        config.default(:storage, development_or_test ? :file : :memory)
+        config.default(:track_tests, Rails.env.test?)
+
+        app.config.profiler.each do |key, value|
+          if config.respond_to?("#{key}=")
+            config.public_send("#{key}=", value)
+          else
+            Rails.logger&.warn("[Profiler] config.profiler.#{key} is not a profiler option, ignored")
+          end
+        end
       end
     end
 
+    # Always inserted here, before the application's initializers have decided `enabled`, so
+    # that the profiler keeps its place in the stack relative to the middlewares they insert;
+    # profiler.remove_disabled_middleware takes it out again once they have run.
     initializer "profiler.insert_middleware", before: :build_middleware_stack do |app|
-      if Profiler.configuration.enabled
-        require_relative "middleware/profiler_middleware"
+      require_relative "middleware/profiler_middleware"
 
-        # Always inserted: it sets the framing headers of every profiler response, and its
-        # CORS headers only when extension_cors_enabled is set.
-        require_relative "middleware/cors_middleware"
-        app.middleware.insert_before 0, Profiler::Middleware::CorsMiddleware
+      # It sets the framing headers of every profiler response, and its CORS headers only
+      # when extension_cors_enabled is set.
+      require_relative "middleware/cors_middleware"
+      app.middleware.insert_before 0, Profiler::Middleware::CorsMiddleware
 
-        app.middleware.insert_before 0, Profiler::Middleware::ProfilerMiddleware
-      end
+      app.middleware.insert_before 0, Profiler::Middleware::ProfilerMiddleware
     end
 
     initializer "profiler.load_collectors" do
@@ -52,6 +63,17 @@ module Profiler
       end
     end
 
+    # Everything below runs after the application's config/initializers, where `enabled` is
+    # decided, and before the middleware stack is built. An initializer declared without
+    # `after:` runs after the one declared before it, so these stay declared last, in order.
+    initializer "profiler.remove_disabled_middleware", after: :load_config_initializers do |app|
+      next if Profiler.configuration.enabled
+
+      # Rails applies every delete after the other middleware operations, whatever their order.
+      app.middleware.delete Profiler::Middleware::ProfilerMiddleware
+      app.middleware.delete Profiler::Middleware::CorsMiddleware
+    end
+
     initializer "profiler.setup_test_profiler" do
       next unless Profiler.configuration.enabled && Profiler.configuration.track_tests
 
@@ -68,16 +90,19 @@ module Profiler
 
       require_relative "job_profiler"
 
+      # This runs after the application's initializers: prepend, not add, keeps the profiler
+      # ahead of the middlewares and callbacks they install, so that a job's profile covers them.
+      # Sidekiq::Middleware::Chain#prepend is there from Sidekiq 3.3 (2014) to 8.1 at least.
       if defined?(Sidekiq)
         require_relative "instrumentation/sidekiq_middleware"
         Sidekiq.configure_server do |config|
           config.server_middleware do |chain|
-            chain.add Profiler::Instrumentation::SidekiqMiddleware
+            chain.prepend Profiler::Instrumentation::SidekiqMiddleware
           end
         end
         Sidekiq.configure_client do |config|
           config.client_middleware do |chain|
-            chain.add Profiler::Instrumentation::SidekiqClientMiddleware
+            chain.prepend Profiler::Instrumentation::SidekiqClientMiddleware
           end
         end
       end

data/lib/profiler/test_profiler.rb

@@ -52,7 +52,7 @@ module Profiler
       )
 
       collectors = [test_collector] + TEST_COLLECTOR_CLASSES.map { |klass| klass.new(profile) }
-      collectors.each { |c| c.subscribe if c.respond_to?(:subscribe) }
+      return block.call unless Collectors::Lifecycle.subscribe_all(collectors, "TestProfiler")
 
       exception_collector = collectors.find { |c| c.is_a?(Collectors::ExceptionCollector) }
 
@@ -120,6 +120,9 @@ module Profiler
 
         Profiler.storage.save(profile.token, profile)
       end
+    ensure
+      # After collect, and also when collect or the storage failed.
+      Collectors::Lifecycle.release_all(collectors)
     end
 
     private

data/lib/profiler/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Profiler
-  VERSION = "0.30.12"
+  VERSION = "0.30.14"
 end

data/lib/profiler.rb

@@ -77,16 +77,18 @@ module Profiler
     def dump(value, label = nil)
       return unless enabled?
 
+      # The slot exists only while a DumpCollector profiles this thread: outside of one, nobody
+      # would ever read the dump, and the thread would keep it for good.
+      dumps = Thread.current[:profiler_dumps]
+      return value unless dumps
+
       # Get caller location
       caller_location = caller_locations(1, 1).first
       file = caller_location.path
       line = caller_location.lineno
 
-      # Initialize dumps array if needed
-      Thread.current[:profiler_dumps] ||= []
-
       # Store the dump
-      Thread.current[:profiler_dumps] << {
+      dumps << {
         value: value,
         label: label,
         file: file,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails-profiler
 version: !ruby/object:Gem::Version
-  version: 0.30.12
+  version: 0.30.14
 platform: ruby
 authors:
 - Sébastien Duplessy
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-04 00:00:00.000000000 Z
+date: 2026-10-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -152,6 +152,7 @@ files:
 - lib/profiler/collectors/http_collector.rb
 - lib/profiler/collectors/i18n_collector.rb
 - lib/profiler/collectors/job_collector.rb
+- lib/profiler/collectors/lifecycle.rb
 - lib/profiler/collectors/log_collector.rb
 - lib/profiler/collectors/mailer_collector.rb
 - lib/profiler/collectors/request_collector.rb