dead_bro 0.2.18 → 0.2.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa43ba99a6fb0fd4007b856a24ac5844236f2d0102f9ec71175c81981a91bb17
-  data.tar.gz: c91f7fee25858bafd2edabfb162239ea8d8833405a3b4965f55e403a06dbfd05
+  metadata.gz: 46ac9efa7b56801c96f5f9e20f113613fa60c10337b94ee84adc59d0ea38234f
+  data.tar.gz: fa10f3f9436a350d8cea97caa71541ade145c88e479cd84195a2814dc43e4395
 SHA512:
-  metadata.gz: b436b94d8d36d0b3407b09481326e443aa342c4398d4973fb517016bd3ee1f4a159a163d12a76b2294f2e4de36505b0cb568010bd8e0aecbbd0e3b4dc544069e
-  data.tar.gz: 7981b5ea511dad34ce67c0a71afe8a09f12045a0ae778311fa42ae0426f3a689d38377528939c6f757192bd973c3d3c782f9f2124831cfac5505d4bf1ab2d177
+  metadata.gz: 935d4045021860632e6121b844afe1adca986297e03b0c54c0322721b6877112e1dd1e34ccda5ad1b91d52a6a5a05e829fc8c5f045ad74623d6a1b0a5e19ef66
+  data.tar.gz: 9171b13a16ba440015e4df1e44f260b362224c8f0ed8752f6c1a3420c97667f35ffffc97879ed2c34a829be2f95b216b552bb5b52525aa1403c988d1c3955b24

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 ## [Unreleased]
 
+### Added
+- Monitor thread now sends a synchronous heartbeat on startup before the first collection tick. This ensures remote settings — including `monitor_enabled` — are applied from the very first reporting cycle, so Sidekiq workers and other non-web processes that have not yet sent any metrics still receive the correct configuration immediately on boot rather than waiting up to 60 seconds for the first scheduled tick.
+
 ## [0.2.17] - 2026-05-25
 
 ### Added

data/lib/dead_bro/client.rb

@@ -32,18 +32,33 @@ module DeadBro
       nil
     end
 
-    def post_heartbeat
+    def post_heartbeat(sync: false)
       return if @configuration.api_key.nil?
 
       @configuration.last_heartbeat_attempt_at = Time.now.utc
-      body = {event: "heartbeat", payload: {}, sent_at: Time.now.utc.iso8601, revision: @configuration.resolve_deploy_id, gem_version: DeadBro::VERSION}
-
-      dispatch_request(
-        url: metrics_endpoint_url,
-        body: body,
-        event_name: "heartbeat",
-        apply_settings: true
-      )
+      body = {event: "heartbeat", payload: {rails_env: DeadBro.env}, sent_at: Time.now.utc.iso8601, revision: @configuration.resolve_deploy_id, gem_version: DeadBro::VERSION}
+
+      if sync
+        # Called from the monitor thread on startup — run inline so settings are
+        # applied before the first collection tick.
+        uri = URI.parse(metrics_endpoint_url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = (uri.scheme == "https")
+        http.open_timeout = @configuration.open_timeout
+        http.read_timeout = @configuration.read_timeout
+        request = Net::HTTP::Post.new(uri.request_uri)
+        request["Content-Type"] = "application/json"
+        request["Authorization"] = "Bearer #{@configuration.api_key}"
+        request.body = JSON.dump(body)
+        perform_request(http, request, event_name: "heartbeat", apply_settings: true)
+      else
+        dispatch_request(
+          url: metrics_endpoint_url,
+          body: body,
+          event_name: "heartbeat",
+          apply_settings: true
+        )
+      end
 
       nil
     end
@@ -52,7 +67,7 @@ module DeadBro
       return if @configuration.api_key.nil?
       return unless @configuration.enabled
       return if @configuration.skip_tracking?
-      return unless @configuration.job_queue_monitoring_enabled
+      return unless @configuration.monitor_enabled
       return if circuit_open?
 
       body = {payload: payload, sent_at: Time.now.utc.iso8601, revision: @configuration.resolve_deploy_id, gem_version: DeadBro::VERSION}
@@ -206,12 +221,5 @@ module DeadBro
       )
     end
 
-    def log_debug(message)
-      if defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger
-        Rails.logger.debug(message)
-      else
-        $stdout.puts(message)
-      end
-    end
   end
 end

data/lib/dead_bro/collectors/process_info.rb

@@ -18,6 +18,7 @@ module DeadBro
         now = Time.now.utc
 
         {
+          kind: DeadBro.process_kind,
           pid: Process.pid,
           hostname: safe_hostname,
           boot_time: rails_boot_time,

data/lib/dead_bro/configuration.rb

@@ -12,7 +12,7 @@ module DeadBro
     # Remote-managed settings (overwritten by backend JSON `settings` on successful API responses)
     attr_accessor :memory_tracking_enabled, :allocation_tracking_enabled,
       :sample_rate, :slow_query_threshold_ms, :explain_analyze_enabled,
-      :job_queue_monitoring_enabled, :enable_db_stats, :enable_process_stats, :enable_system_stats,
+      :monitor_enabled, :enable_db_stats, :enable_process_stats, :enable_system_stats,
       :max_sql_queries_to_send, :max_logs_to_send
 
     # Readers for exclusion lists. Writers are defined below so we can compile
@@ -58,7 +58,7 @@ module DeadBro
       enabled sample_rate memory_tracking_enabled allocation_tracking_enabled
       explain_analyze_enabled slow_query_threshold_ms max_sql_queries_to_send max_logs_to_send
       excluded_controllers excluded_jobs exclusive_controllers exclusive_jobs
-      job_queue_monitoring_enabled enable_db_stats enable_process_stats enable_system_stats
+      monitor_enabled enable_db_stats enable_process_stats enable_system_stats
     ].freeze
 
     def initialize
@@ -87,7 +87,7 @@ module DeadBro
       self.excluded_jobs = []
       self.exclusive_controllers = []
       self.exclusive_jobs = []
-      @job_queue_monitoring_enabled = false
+      @monitor_enabled = false
       @enable_db_stats = false
       @enable_process_stats = false
       @enable_system_stats = false
@@ -145,7 +145,7 @@ module DeadBro
           when "sample_rate", "slow_query_threshold_ms", "max_sql_queries_to_send", "max_logs_to_send"
             send(:"#{k}=", value.to_i)
           when "enabled", "memory_tracking_enabled", "allocation_tracking_enabled", "explain_analyze_enabled",
-               "job_queue_monitoring_enabled", "enable_db_stats", "enable_process_stats", "enable_system_stats"
+               "monitor_enabled", "enable_db_stats", "enable_process_stats", "enable_system_stats"
             send(:"#{k}=", !!value)
           when "excluded_controllers", "excluded_jobs", "exclusive_controllers", "exclusive_jobs"
             send(:"#{k}=", Array(value).map(&:to_s))

data/lib/dead_bro/error_middleware.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "digest"
 require "rack"
 
 module DeadBro
@@ -35,6 +36,8 @@ module DeadBro
         exception_class: exception.class.name,
         message: truncate(exception.message.to_s, 1000),
         backtrace: safe_backtrace(exception),
+        fingerprint: compute_fingerprint(exception),
+        cause_chain: build_cause_chain(exception),
         occurred_at: Time.now.utc.to_i,
         rack:
           {
@@ -51,6 +54,7 @@ module DeadBro
         rails_env: DeadBro.env,
         app: safe_app_name,
         pid: Process.pid,
+        process_kind: DeadBro.process_kind,
         logs: DeadBro.logger.logs
       }
     end
@@ -67,6 +71,42 @@ module DeadBro
       []
     end
 
+    def normalize_message(msg)
+      msg.to_s
+        .gsub(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/i, "UUID")
+        .gsub(/\b\d+\b/, "N")
+        .gsub(/"[^"]*"/, '"?"')
+        .gsub(/'[^']*'/, "'?'")
+        .strip
+    end
+
+    def compute_fingerprint(exception)
+      top_frame = Array(exception.backtrace).first.to_s.gsub(/:\d+:in /, ":N:in ")
+      input = "#{exception.class.name}|#{normalize_message(exception.message)}|#{top_frame}"
+      Digest::SHA256.hexdigest(input)[0, 16]
+    rescue
+      nil
+    end
+
+    def build_cause_chain(exception)
+      return [] unless exception
+      chain = []
+      cause = exception.cause
+      depth = 0
+      while cause && depth < 5
+        chain << {
+          exception_class: cause.class.name,
+          message: truncate(cause.message.to_s, 500),
+          backtrace_top: Array(cause.backtrace).first(3)
+        }
+        cause = cause.cause
+        depth += 1
+      end
+      chain
+    rescue
+      []
+    end
+
     def safe_params(req)
       return {} unless req
 

data/lib/dead_bro/job_subscriber.rb

@@ -115,6 +115,7 @@ module DeadBro
           sql_queries: sql_queries,
           rails_env: DeadBro.env,
           host: safe_host,
+          process_kind: DeadBro.process_kind,
           memory_usage: memory_usage_mb,
           gc_stats: gc_stats,
           memory_events: memory_events,
@@ -213,6 +214,7 @@ module DeadBro
           backtrace: Array(exception&.backtrace).first(50),
           rails_env: DeadBro.env,
           host: safe_host,
+          process_kind: DeadBro.process_kind,
           memory_usage: memory_usage_mb,
           gc_stats: gc_stats,
           memory_events: memory_events,

data/lib/dead_bro/monitor.rb

@@ -24,6 +24,16 @@ module DeadBro
       @running = true
       @thread = Thread.new do
         Thread.current.abort_on_exception = false
+
+        # Fetch initial settings before the first collection tick so processes
+        # that haven't yet posted any metrics (e.g. Sidekiq at boot) still get
+        # monitor_enabled and other remote settings from the backend.
+        begin
+          @client.post_heartbeat(sync: true)
+        rescue => e
+          log_error("Error fetching initial settings: #{e.message}")
+        end
+
         loop do
           break unless @running
 
@@ -59,6 +69,7 @@ module DeadBro
         environment: DeadBro.env,
         host: process_hostname,
         pid: Process.pid,
+        process_kind: DeadBro.process_kind,
         current_time: Time.now.utc.iso8601,
         jobs: DeadBro::Collectors::Jobs.collect,
         network: DeadBro::Collectors::Network.collect
@@ -86,10 +97,11 @@ module DeadBro
     end
 
     def log_error(message)
+      msg = "[DeadBro::Monitor] #{message}"
       if defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger
-        Rails.logger.error("[DeadBro::Monitor] #{message}")
+        Rails.logger.error(msg)
       else
-        $stderr.puts("[DeadBro::Monitor] #{message}")
+        warn(msg)
       end
     end
 

data/lib/dead_bro/railtie.rb

@@ -68,7 +68,7 @@ if defined?(Rails) && defined?(Rails::Railtie)
           end
 
           # Always start the monitor thread. The thread runs every 60s but
-          # post_monitor_stats skips the HTTP POST when job_queue_monitoring_enabled
+          # post_monitor_stats skips the HTTP POST when monitor_enabled
           # is false, so the backend can toggle monitoring on/off mid-process.
           require "dead_bro/monitor"
           DeadBro.monitor = DeadBro::Monitor.new(client: shared_client)

data/lib/dead_bro/subscriber.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "digest"
 require "active_support/notifications"
 
 module DeadBro
@@ -133,12 +134,15 @@ module DeadBro
               duration_ms: duration_ms,
               rails_env: DeadBro.env,
               host: safe_host,
+              process_kind: DeadBro.process_kind,
               params: safe_params(data),
               user_agent: safe_user_agent(data),
               user_id: extract_user_id(data),
               exception_class: exception_class || exception_obj&.class&.name,
               message: (exception_message || exception_obj&.message).to_s[0, 1000],
               backtrace: backtrace,
+              fingerprint: compute_error_fingerprint(exception_obj),
+              cause_chain: build_cause_chain(exception_obj),
               error: true,
               logs: DeadBro.logger.logs
             }
@@ -163,6 +167,7 @@ module DeadBro
           db_runtime_ms: data[:db_runtime],
           host: safe_host,
           rails_env: DeadBro.env,
+          process_kind: DeadBro.process_kind,
           params: safe_params(data),
           user_agent: safe_user_agent(data),
           user_id: extract_user_id(data),
@@ -401,5 +406,42 @@ module DeadBro
     rescue
       nil
     end
+
+    def self.normalize_error_message(msg)
+      msg.to_s
+        .gsub(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/i, "UUID")
+        .gsub(/\b\d+\b/, "N")
+        .gsub(/"[^"]*"/, '"?"')
+        .gsub(/'[^']*'/, "'?'")
+        .strip
+    end
+
+    def self.compute_error_fingerprint(exception)
+      return nil unless exception
+      top_frame = Array(exception.backtrace).first.to_s.gsub(/:\d+:in /, ":N:in ")
+      input = "#{exception.class.name}|#{normalize_error_message(exception.message)}|#{top_frame}"
+      Digest::SHA256.hexdigest(input)[0, 16]
+    rescue
+      nil
+    end
+
+    def self.build_cause_chain(exception)
+      return [] unless exception
+      chain = []
+      cause = exception.cause
+      depth = 0
+      while cause && depth < 5
+        chain << {
+          exception_class: cause.class.name,
+          message: cause.message.to_s[0, 500],
+          backtrace_top: Array(cause.backtrace).first(3)
+        }
+        cause = cause.cause
+        depth += 1
+      end
+      chain
+    rescue
+      []
+    end
   end
 end

data/lib/dead_bro/version.rb

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

data/lib/dead_bro.rb

@@ -127,6 +127,30 @@ module DeadBro
     "development"
   end
 
+  def self.process_kind
+    @process_kind ||= begin
+      fingerprint = "#{$PROGRAM_NAME} #{process_command_line}".downcase
+      case
+      when fingerprint.match?(/sidekiq|good_job|solid_queue|delayed_job/) then "worker"
+      when fingerprint.match?(/puma|passenger|unicorn|falcon/)            then "web"
+      when fingerprint.include?("console")                                then "console"
+      when fingerprint.include?("rake")                                   then "task"
+      else "app"
+      end
+    end
+  rescue
+    "app"
+  end
+
+  def self.process_command_line
+    # /proc/self/cmdline is Linux-only; on macOS/Windows the fallback to
+    # $PROGRAM_NAME is used, which may miss some process fingerprints (e.g.
+    # a Sidekiq invocation that uses a wrapper script).
+    File.readable?("/proc/self/cmdline") ? File.read("/proc/self/cmdline").tr("\0", " ").strip : $PROGRAM_NAME.to_s
+  rescue
+    $PROGRAM_NAME.to_s
+  end
+
   # Returns the monitor instance
   def self.monitor
     @monitor

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dead_bro
 version: !ruby/object:Gem::Version
-  version: 0.2.18
+  version: 0.2.20
 platform: ruby
 authors:
 - Emanuel Comsa
@@ -18,7 +18,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- FEATURES.md
 - README.md
 - lib/dead_bro.rb
 - lib/dead_bro/ar_object_tracker.rb
@@ -75,7 +74,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.9
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Minimal APM for Rails apps.
 test_files: []

data/FEATURES.md

@@ -1,333 +0,0 @@
-# ApmBro Feature List
-
-A comprehensive feature list for comparing ApmBro with other APM (Application Performance Monitoring) tools.
-
-## Core Architecture
-
-- **Rails Integration**: Automatic subscription to Rails events via ActiveSupport::Notifications
-- **Zero-Configuration Setup**: Works out of the box with minimal configuration
-- **Asynchronous Metrics Posting**: Non-blocking HTTP requests using background threads
-- **Thread-Local Storage**: Per-request metric collection using thread-local variables
-- **Circuit Breaker Pattern**: Built-in circuit breaker to prevent cascading failures when APM endpoint is down
-- **Deploy Tracking**: Automatic deploy ID resolution from multiple sources (Rails settings, ENV vars, Heroku, Git)
-
-## Request Tracking
-
-### Controller Action Monitoring
-- **Automatic Tracking**: Tracks all controller actions automatically
-- **Request Duration**: Measures total request processing time
-- **HTTP Method & Path**: Captures HTTP method and request path
-- **Status Codes**: Tracks HTTP response status codes
-- **View Runtime**: Separate tracking of view rendering time
-- **Database Runtime**: Separate tracking of database query time
-- **Request Parameters**: Captures request parameters (with sensitive data filtering)
-- **User Agent**: Tracks user agent strings
-- **User ID Extraction**: Extracts authenticated user ID (supports Warden)
-- **Environment Context**: Tracks Rails environment (development, staging, production)
-
-### Request Sampling
-- **Configurable Sample Rate**: Percentage-based sampling (1-100%)
-- **Random Sampling**: Each request has random chance of being tracked
-- **Consistent Per-Request**: Sampling decision applies to all metrics for a request
-- **Error Override**: Errors are always tracked regardless of sampling
-- **Cost Optimization**: Reduces data volume and costs for high-traffic applications
-
-### Exclusion Rules
-- **Controller Exclusion**: Exclude entire controllers from tracking
-- **Action Exclusion**: Exclude specific controller#action combinations
-- **Wildcard Support**: Pattern matching with `*` wildcards (e.g., `Admin::*`, `Admin::*#*`)
-- **Job Exclusion**: Exclude specific background jobs from tracking
-- **Flexible Configuration**: Configure via initializer, Rails settings, or environment variables
-
-## SQL Query Tracking
-
-### Query Details
-- **Full SQL Tracking**: Captures all SQL queries executed during requests and jobs
-- **Query Sanitization**: Automatically sanitizes SQL to remove sensitive data
-- **Query Name**: Tracks query names (e.g., "User Load", "User Update")
-- **Duration Measurement**: Precise query execution time in milliseconds
-- **Cache Detection**: Identifies cached queries
-- **Connection ID**: Tracks database connection ID
-- **Call Stack Traces**: Full backtrace showing where queries were executed
-- **Object Allocations**: Optional tracking of object allocations per query
-
-### Query Performance Analysis
-- **Slow Query Detection**: Configurable threshold for identifying slow queries
-- **EXPLAIN ANALYZE**: Automatic execution plan capture for slow queries
-- **Background Execution**: EXPLAIN ANALYZE runs in separate thread (non-blocking)
-- **Multi-Database Support**: Works with PostgreSQL, MySQL, SQLite, and others
-- **Smart Filtering**: Automatically skips transaction queries (BEGIN, COMMIT, ROLLBACK)
-- **Execution Plan Details**: 
-  - PostgreSQL: Full EXPLAIN ANALYZE with buffer usage statistics
-  - MySQL: EXPLAIN ANALYZE with actual execution times
-  - SQLite: EXPLAIN QUERY PLAN output
-- **Query Optimization Insights**: Helps identify missing indexes, full table scans, JOIN issues
-
-## View Rendering Tracking
-
-### View Performance
-- **Template Rendering**: Tracks main template rendering
-- **Partial Rendering**: Tracks partial template rendering with cache key information
-- **Collection Rendering**: Tracks collection rendering (partials in loops)
-- **Rendering Duration**: Precise timing for each view component
-- **Virtual Path Tracking**: Tracks view virtual paths
-- **Layout Information**: Captures layout usage
-
-### View Analysis
-- **Slow View Detection**: Identifies the slowest rendering views
-- **Frequency Analysis**: Tracks most frequently rendered views
-- **Cache Hit Rate**: Calculates cache hit rates for partials
-- **Collection Cache Analysis**: Tracks cache hit rates for collection rendering
-- **Performance Metrics**: 
-  - Total views rendered per request
-  - Total view rendering duration
-  - Average view rendering duration
-  - Breakdown by view type (template, partial, collection)
-
-## Memory Tracking & Leak Detection
-
-### Lightweight Memory Tracking (Default)
-- **Memory Usage Monitoring**: Tracks memory consumption per request using GC stats
-- **Memory Growth Tracking**: Measures memory growth during request processing
-- **GC Statistics**: Tracks garbage collection count and heap pages
-- **Minimal Performance Impact**: ~0.1ms overhead per request
-- **Memory Before/After**: Captures memory state at request start and end
-
-### Detailed Allocation Tracking (Optional)
-- **Object Allocation Tracking**: Detailed tracking of object allocations (disabled by default)
-- **Allocation Sampling**: Configurable sampling rate for allocations
-- **Large Object Detection**: Identifies objects larger than 1MB threshold
-- **Memory Snapshots**: Periodic memory snapshots during request processing
-- **Object Count Tracking**: Tracks object counts before and after requests
-- **Performance Impact**: ~2-5ms overhead per request (only when enabled)
-
-### Memory Leak Detection
-- **Pattern Detection**: Detects growing memory patterns over time
-- **GC Efficiency Analysis**: Monitors garbage collection effectiveness
-- **Heap Page Tracking**: Tracks heap page growth
-- **Request Correlation**: Correlates memory growth with specific controllers/actions
-
-## Background Job Tracking
-
-### Job Execution Monitoring
-- **ActiveJob Integration**: Automatic tracking when ActiveJob is available
-- **Job Class Tracking**: Tracks job class names
-- **Job ID**: Captures unique job identifiers
-- **Queue Name**: Tracks which queue processed the job
-- **Job Arguments**: Captures job arguments (with sensitive data filtering)
-- **Duration Measurement**: Precise job execution time in milliseconds
-- **Status Tracking**: Tracks job status (completed or failed)
-
-### Job Error Tracking
-- **Exception Capture**: Captures exceptions from failed jobs
-- **Exception Class**: Tracks exception class names
-- **Exception Messages**: Captures exception messages (truncated to 1000 chars)
-- **Backtraces**: Full exception backtraces (first 50 lines)
-- **SQL Query Context**: Includes SQL queries executed during failed jobs
-- **Memory Context**: Includes memory usage during job execution
-
-### Job SQL Tracking
-- **SQL Query Tracking**: Tracks all SQL queries executed during job processing
-- **Query Details**: Same detailed SQL tracking as request tracking
-- **Query Context**: Full context of database operations in background jobs
-
-## Cache Tracking
-
-### Cache Operations
-- **Read Operations**: Tracks cache read operations
-- **Write Operations**: Tracks cache write operations
-- **Delete Operations**: Tracks cache delete operations
-- **Existence Checks**: Tracks cache existence checks
-- **Fetch Operations**: Tracks cache fetch with hit/miss detection
-- **Multi-Read Operations**: Tracks cache read_multi operations
-- **Multi-Write Operations**: Tracks cache write_multi operations
-- **Cache Generation**: Tracks cache generation events
-
-### Cache Analysis
-- **Cache Hit Detection**: Identifies cache hits vs misses
-- **Cache Key Tracking**: Tracks cache keys (truncated to 200 chars)
-- **Store Information**: Identifies which cache store was used
-- **Namespace Tracking**: Tracks cache namespaces
-- **Duration Measurement**: Precise timing for each cache operation
-- **Hit Rate Calculation**: Calculates cache hit rates per request
-
-## Redis Tracking
-
-### Redis Command Tracking
-- **Command Monitoring**: Tracks all Redis commands executed
-- **Command Name**: Captures Redis command names (GET, SET, etc.)
-- **Key Tracking**: Tracks Redis keys (truncated to 200 chars)
-- **Argument Count**: Tracks number of arguments per command
-- **Database Selection**: Tracks which Redis database is used
-- **Duration Measurement**: Precise timing for each Redis command
-- **Error Tracking**: Captures Redis command errors
-
-### Advanced Redis Features
-- **Pipeline Support**: Tracks Redis pipeline operations with command counts
-- **Multi/Transaction Support**: Tracks Redis MULTI/EXEC transactions
-- **ActiveSupport Integration**: Subscribes to ActiveSupport::Notifications for Redis events
-- **Client Instrumentation**: Direct instrumentation of Redis::Client for comprehensive coverage
-
-## Error Tracking
-
-### Exception Handling
-- **Automatic Exception Capture**: Captures exceptions from controller actions
-- **Exception Class**: Tracks exception class names
-- **Exception Messages**: Captures exception messages (truncated to 1000 chars)
-- **Full Backtraces**: Captures complete exception backtraces (first 50 lines)
-- **Request Context**: Includes full request context with exceptions
-- **Error Flagging**: Errors are marked and always tracked (even with sampling)
-
-### Error Context
-- **Controller/Action**: Identifies where the error occurred
-- **Request Parameters**: Includes request parameters at time of error
-- **User Information**: Includes user ID if available
-- **SQL Queries**: Includes SQL queries executed before error
-- **Memory State**: Includes memory usage at time of error
-- **Log Messages**: Includes application logs captured during request
-
-## HTTP Instrumentation
-
-### Outgoing HTTP Tracking
-- **HTTP Request Tracking**: Tracks outgoing HTTP requests (via middleware)
-- **Request Context**: Captures HTTP request details
-- **Response Context**: Captures HTTP response details
-- **Duration Measurement**: Tracks HTTP request duration
-
-## Configuration & Flexibility
-
-### Configuration Options
-- **API Key Management**: Multiple sources (config, Rails credentials, ENV)
-- **Endpoint Configuration**: Configurable endpoint URL
-- **Timeout Settings**: Configurable open and read timeouts
-- **Enable/Disable Toggle**: Can be enabled/disabled via configuration
-- **Environment Detection**: Automatic Rails environment detection
-
-### Circuit Breaker Configuration
-- **Failure Threshold**: Configurable failure threshold (default: 3)
-- **Recovery Timeout**: Configurable recovery timeout (default: 60 seconds)
-- **Retry Timeout**: Configurable retry timeout (default: 300 seconds)
-- **Enable/Disable**: Can enable/disable circuit breaker
-
-### Memory Tracking Configuration
-- **Memory Tracking Toggle**: Enable/disable memory tracking
-- **Allocation Tracking Toggle**: Enable/disable detailed allocation tracking
-- **Sampling Configuration**: Configurable request sampling rate
-
-### Query Analysis Configuration
-- **Slow Query Threshold**: Configurable threshold in milliseconds (default: 500ms)
-- **EXPLAIN ANALYZE Toggle**: Enable/disable automatic EXPLAIN ANALYZE
-
-## Data Safety & Privacy
-
-### Data Sanitization
-- **SQL Sanitization**: Automatically sanitizes SQL queries
-- **Parameter Filtering**: Filters sensitive parameters (password, token, secret, key)
-- **Argument Truncation**: Limits and truncates job arguments
-- **Key Truncation**: Truncates cache and Redis keys to 200 characters
-- **Value Truncation**: Recursively truncates nested values to prevent huge payloads
-- **String Limits**: Limits string values (e.g., user agent to 200 chars, messages to 1000 chars)
-
-### Data Limits
-- **Array Limits**: Limits array sizes (e.g., first 10 job arguments, first 5 array elements)
-- **Hash Limits**: Limits hash key counts (e.g., first 20 hash keys, first 30 params)
-- **Backtrace Limits**: Limits backtraces to first 50 lines
-- **Allocation Limits**: Limits allocations tracked per request (max 1000)
-
-## Performance & Reliability
-
-### Performance Optimizations
-- **Asynchronous Posting**: Non-blocking HTTP requests
-- **Lightweight Default Mode**: Minimal overhead in default configuration
-- **Sampling Support**: Reduces data volume for high-traffic applications
-- **Thread-Local Storage**: Efficient per-request data collection
-- **Background EXPLAIN**: EXPLAIN ANALYZE runs in background thread
-
-### Reliability Features
-- **Circuit Breaker**: Prevents cascading failures
-- **Error Handling**: Comprehensive error handling to prevent instrumentation failures
-- **Graceful Degradation**: Continues working even if some features fail
-- **Timeout Protection**: Configurable timeouts prevent hanging requests
-
-## Integration & Compatibility
-
-### Framework Support
-- **Rails Integration**: Full Rails integration via Railtie
-- **ActiveSupport Notifications**: Uses ActiveSupport::Notifications for event subscription
-- **ActiveRecord Integration**: Tracks ActiveRecord SQL queries
-- **ActiveJob Integration**: Tracks ActiveJob background jobs
-- **ActionView Integration**: Tracks ActionView rendering
-
-### Database Support
-- **PostgreSQL**: Full support with EXPLAIN ANALYZE
-- **MySQL**: Full support with EXPLAIN ANALYZE
-- **SQLite**: Full support with EXPLAIN QUERY PLAN
-- **Other Databases**: Basic support with standard EXPLAIN
-
-### Cache Store Support
-- **All Cache Stores**: Works with any Rails cache store
-- **Multi-Store Support**: Tracks cache operations across different stores
-
-### Redis Support
-- **Redis Gem**: Works with redis gem
-- **Client Instrumentation**: Direct instrumentation of Redis::Client
-- **Pipeline Support**: Tracks Redis pipelines
-- **Transaction Support**: Tracks Redis MULTI/EXEC transactions
-
-## Logging & Debugging
-
-### Application Logging
-- **Log Capture**: Captures application logs during request processing
-- **Log Context**: Includes logs in metric payloads
-- **Debug Logging**: Optional debug logging for skipped requests
-
-## Deployment & Environment
-
-### Deploy Tracking
-- **Deploy ID Resolution**: Multiple sources for deploy identification (`Configuration#deploy_id=` wins when set, then ENV in `Configuration::DEPLOY_REVISION_ENV_KEYS` order—including `DEAD_BRO_DEPLOY_ID`, git/CI vars, `DD_VERSION`, etc.), otherwise a **per-process UUID** (fine for single dyno/process; unusable alone for fleets like ECS replicas)
-- **Revision Tracking**: Includes deploy/revision ID in all metric payloads
-
-### Environment Support
-- **Rails Environment**: Automatic Rails environment detection
-- **Rack Environment**: Fallback to RACK_ENV or RAILS_ENV
-- **Environment Context**: Includes environment in all metric payloads
-
-## Data Collection & Transmission
-
-### Metric Payload Structure
-- **Structured Data**: Well-structured JSON payloads
-- **Event Names**: Descriptive event names for different metric types
-- **Timestamp Tracking**: ISO8601 timestamps for all metrics
-- **Metadata**: Rich metadata including environment, host, deploy ID
-
-### HTTP Client
-- **HTTPS Support**: Secure HTTPS communication
-- **Bearer Token Auth**: API key authentication via Bearer tokens
-- **JSON Encoding**: JSON-encoded payloads
-- **Custom Headers**: Proper Content-Type and Authorization headers
-
-## Comparison-Ready Features
-
-### Unique Differentiators
-1. **Automatic EXPLAIN ANALYZE**: Background execution plan capture for slow queries
-2. **Lightweight Memory Tracking**: Low-overhead memory monitoring by default
-3. **Comprehensive Cache Tracking**: Detailed cache operation tracking
-4. **Redis Instrumentation**: Full Redis command tracking including pipelines
-5. **View Rendering Analysis**: Detailed view performance analysis with cache hit rates
-6. **Flexible Exclusion Rules**: Wildcard support for controller/job exclusion
-7. **Request Sampling**: Configurable percentage-based sampling
-8. **Circuit Breaker**: Built-in resilience for APM endpoint failures
-9. **Multi-Source Configuration**: Flexible configuration from multiple sources
-10. **Deploy Tracking**: Automatic deploy ID resolution from multiple sources
-
-### Standard APM Features
-- Request/response tracking
-- SQL query tracking
-- Error tracking
-- Background job tracking
-- Memory tracking
-- Performance metrics
-- Exception handling
-- User context
-- Environment tracking
-