dead_bro 0.2.15 → 0.2.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2251b88befeee4d2b7668bc504cc99d94cd154dd4539258545c1084e7a388709
-  data.tar.gz: 10141477e9697b91d95290ccfc695abb304e8dfbdfb526f95646269be03be0ef
+  metadata.gz: 0bfea7b6292743b5e6a0f7226c1bd8877ebfbe1131f95d5c1679f07377768ed2
+  data.tar.gz: '08ab07422afbd9d2d340e5195f47ceda9a184faa9a870e5464d6169dfc86ee6b'
 SHA512:
-  metadata.gz: 39ec9243a8792016f7cf9bf5f8d81856c121365b5cebef91ef7d318f642e7480a66b32a92b63ec944ee3aebb9e92ffdfc27c9e284e41da7daa081661e893b38a
-  data.tar.gz: 519f6df31fb8dc567a6974052e58787098021078514eaa2877a2f582651c5a5fec316f4da58a625a4b6d00eed7fae614fe5dd79f1da17ae2d4d7227ce8f7061b
+  metadata.gz: 76822c848e35d76f6cb54d7953e9ad7bb68de09b706be6f7586c4c67a3e430074fcd33515394965aeeb1d41c74577295ce56942badb05d96fd390e1daefeb410
+  data.tar.gz: 2cd76061aa3f443723dfc3e934b1cd36e7e7576257f6637a4a1deab4e05c3154d309c9d4b59d084b46e89521774e47475a84fdc711db42d03b1dab496682d532

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## [0.2.16] - 2026-05-24
+
+### Added
+- `ArObjectTracker`: subscribes to Rails' built-in `instantiation.active_record` notification to count the total number of ActiveRecord model instances hydrated during each request or background job. The count is reported as `ar_instantiation_count` in every payload. Uses a thread-local counter with an idempotent `subscribe!` guard, matching the same start/stop lifecycle as `GcTracker`. No monkey-patching required — Rails emits this event natively with a `record_count` field that accumulates correctly across batch loads.
+
 ## [0.2.14] - 2026-05-23
 
 ### Added

data/lib/dead_bro/ar_object_tracker.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "active_support/notifications"
+
+module DeadBro
+  module ArObjectTracker
+    THREAD_KEY = :dead_bro_ar_objects
+
+    def self.subscribe!
+      return if @subscribed
+      @subscribed = true
+      ActiveSupport::Notifications.subscribe("instantiation.active_record") do |_name, _started, _finished, _id, data|
+        count = Thread.current[THREAD_KEY]
+        next unless count
+        Thread.current[THREAD_KEY] = count + (data[:record_count] || 1).to_i
+      end
+    rescue StandardError
+      # Never raise from instrumentation install
+    end
+
+    def self.start_request_tracking
+      Thread.current[THREAD_KEY] = 0
+    end
+
+    def self.stop_request_tracking
+      Thread.current[THREAD_KEY]
+    ensure
+      Thread.current[THREAD_KEY] = nil
+    end
+  end
+end

data/lib/dead_bro/job_subscriber.rb

@@ -15,6 +15,7 @@ module DeadBro
       # Snap GC state before the job runs so stop_request_tracking gets a valid diff
       ActiveSupport::Notifications.subscribe("perform_start.active_job") do |_name, _started, _finished, _unique_id, _data|
         DeadBro::GcTracker.start_request_tracking if defined?(DeadBro::GcTracker)
+        DeadBro::ArObjectTracker.start_request_tracking if defined?(DeadBro::ArObjectTracker)
       rescue
       end
 
@@ -69,6 +70,7 @@ module DeadBro
         sql_queries = DeadBro::SqlSubscriber.stop_request_tracking
         db_connection_stats = defined?(DeadBro::DbConnectionSubscriber) ? DeadBro::DbConnectionSubscriber.stop_request_tracking : {}
         gc_pressure = defined?(DeadBro::GcTracker) ? DeadBro::GcTracker.stop_request_tracking : {}
+        ar_instantiation_count = defined?(DeadBro::ArObjectTracker) ? DeadBro::ArObjectTracker.stop_request_tracking : nil
 
         # Stop memory tracking and get collected memory data
         if DeadBro.configuration.allocation_tracking_enabled && defined?(DeadBro::MemoryTrackingSubscriber)
@@ -108,6 +110,7 @@ module DeadBro
           db_connection_wait_ms: db_connection_stats[:wait_ms],
           db_connection_checkouts: db_connection_stats[:checkouts],
           gc_pressure: gc_pressure,
+          ar_instantiation_count: ar_instantiation_count,
           status: "completed",
           sql_queries: sql_queries,
           rails_env: DeadBro.env,
@@ -162,6 +165,7 @@ module DeadBro
         sql_queries = DeadBro::SqlSubscriber.stop_request_tracking
         db_connection_stats = defined?(DeadBro::DbConnectionSubscriber) ? DeadBro::DbConnectionSubscriber.stop_request_tracking : {}
         gc_pressure = defined?(DeadBro::GcTracker) ? DeadBro::GcTracker.stop_request_tracking : {}
+        ar_instantiation_count = defined?(DeadBro::ArObjectTracker) ? DeadBro::ArObjectTracker.stop_request_tracking : nil
 
         # Stop memory tracking and get collected memory data
         if DeadBro.configuration.allocation_tracking_enabled && defined?(DeadBro::MemoryTrackingSubscriber)
@@ -201,6 +205,7 @@ module DeadBro
           db_connection_wait_ms: db_connection_stats[:wait_ms],
           db_connection_checkouts: db_connection_stats[:checkouts],
           gc_pressure: gc_pressure,
+          ar_instantiation_count: ar_instantiation_count,
           status: "failed",
           sql_queries: sql_queries,
           exception_class: exception&.class&.name,
@@ -228,6 +233,7 @@ module DeadBro
       DeadBro::SqlSubscriber.stop_request_tracking if defined?(DeadBro::SqlSubscriber)
       DeadBro::DbConnectionSubscriber.stop_request_tracking if defined?(DeadBro::DbConnectionSubscriber)
       DeadBro::GcTracker.stop_request_tracking if defined?(DeadBro::GcTracker)
+      DeadBro::ArObjectTracker.stop_request_tracking if defined?(DeadBro::ArObjectTracker)
       DeadBro::LightweightMemoryTracker.stop_request_tracking if defined?(DeadBro::LightweightMemoryTracker)
       if DeadBro.configuration.allocation_tracking_enabled && defined?(DeadBro::MemoryTrackingSubscriber)
         DeadBro::MemoryTrackingSubscriber.stop_request_tracking

data/lib/dead_bro/railtie.rb

@@ -40,6 +40,10 @@ if defined?(Rails) && defined?(Rails::Railtie)
           require "dead_bro/db_connection_subscriber"
           DeadBro::DbConnectionSubscriber.install!
 
+          # Install ActiveRecord object instantiation tracking
+          require "dead_bro/ar_object_tracker"
+          DeadBro::ArObjectTracker.subscribe!
+
           # Install view rendering tracking
           require "dead_bro/view_rendering_subscriber"
           DeadBro::ViewRenderingSubscriber.subscribe!(client: shared_client)

data/lib/dead_bro/sql_tracking_middleware.rb

@@ -64,6 +64,9 @@ module DeadBro
       # Start GC pressure tracking — snapshot before any app code runs
       DeadBro::GcTracker.start_request_tracking if defined?(DeadBro::GcTracker)
 
+      # Start AR object instantiation counting for this request
+      DeadBro::ArObjectTracker.start_request_tracking if defined?(DeadBro::ArObjectTracker)
+
       # Start outgoing HTTP accumulation for this request
       Thread.current[:dead_bro_http_events] = []
 
@@ -101,6 +104,8 @@ module DeadBro
       Thread.current[:dead_bro_queue_duration_ms] = nil
       DeadBro::DbConnectionSubscriber.stop_request_tracking if defined?(DeadBro::DbConnectionSubscriber)
       Thread.current[DeadBro::GcTracker::THREAD_KEY] = nil if defined?(DeadBro::GcTracker)
+      # Bypass stop_request_tracking intentionally — cleanup only, no return value needed here.
+      Thread.current[DeadBro::ArObjectTracker::THREAD_KEY] = nil if defined?(DeadBro::ArObjectTracker)
       Thread.current[DeadBro::TRACKING_START_TIME_KEY] = nil
     end
 

data/lib/dead_bro/subscriber.rb

@@ -68,6 +68,9 @@ module DeadBro
         # Stop GC pressure tracking — diff minor/major runs, objects allocated, GC time
         gc_pressure = defined?(DeadBro::GcTracker) ? DeadBro::GcTracker.stop_request_tracking : {}
 
+        # Stop AR object instantiation tracking
+        ar_instantiation_count = defined?(DeadBro::ArObjectTracker) ? DeadBro::ArObjectTracker.stop_request_tracking : nil
+
         # Stop view rendering tracking and get collected view events
         view_events = DeadBro::ViewRenderingSubscriber.stop_request_tracking
         view_performance = DeadBro::ViewRenderingSubscriber.analyze_view_performance(view_events)
@@ -182,6 +185,7 @@ module DeadBro
           db_connection_wait_ms: db_connection_stats[:wait_ms],
           db_connection_checkouts: db_connection_stats[:checkouts],
           gc_pressure: gc_pressure,
+          ar_instantiation_count: ar_instantiation_count,
           logs: DeadBro.logger.logs
         }
         client.post_metric(event_name: name, payload: payload)
@@ -204,6 +208,7 @@ module DeadBro
       Thread.current[:dead_bro_http_events] = nil
       DeadBro::DbConnectionSubscriber.stop_request_tracking if defined?(DeadBro::DbConnectionSubscriber)
       DeadBro::GcTracker.stop_request_tracking if defined?(DeadBro::GcTracker)
+      DeadBro::ArObjectTracker.stop_request_tracking if defined?(DeadBro::ArObjectTracker)
     rescue
       # Best effort — draining must never raise from the notifications callback.
     end

data/lib/dead_bro/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DeadBro
-  VERSION = "0.2.15"
+  VERSION = "0.2.16"
 end

data/lib/dead_bro.rb

@@ -19,6 +19,7 @@ module DeadBro
   autoload :MemoryLeakDetector, "dead_bro/memory_leak_detector"
   autoload :LightweightMemoryTracker, "dead_bro/lightweight_memory_tracker"
   autoload :GcTracker, "dead_bro/gc_tracker"
+  autoload :ArObjectTracker, "dead_bro/ar_object_tracker"
   autoload :MemoryHelpers, "dead_bro/memory_helpers"
   autoload :JobSubscriber, "dead_bro/job_subscriber"
   autoload :JobSqlTrackingMiddleware, "dead_bro/job_sql_tracking_middleware"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dead_bro
 version: !ruby/object:Gem::Version
-  version: 0.2.15
+  version: 0.2.16
 platform: ruby
 authors:
 - Emanuel Comsa
@@ -21,6 +21,7 @@ files:
 - FEATURES.md
 - README.md
 - lib/dead_bro.rb
+- lib/dead_bro/ar_object_tracker.rb
 - lib/dead_bro/cache_subscriber.rb
 - lib/dead_bro/circuit_breaker.rb
 - lib/dead_bro/client.rb