brainzlab 0.1.3 → 0.1.4

data/lib/brainzlab/instrumentation/rails_deprecation.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module BrainzLab
+  module Instrumentation
+    class RailsDeprecation
+      class << self
+        def install!
+          return unless defined?(::Rails)
+          return if @installed
+
+          install_deprecation_subscriber!
+
+          @installed = true
+          BrainzLab.debug_log('Rails deprecation instrumentation installed')
+        end
+
+        def installed?
+          @installed == true
+        end
+
+        private
+
+        # ============================================
+        # deprecation.rails
+        # Fired when a deprecated Rails API is used
+        # ============================================
+        def install_deprecation_subscriber!
+          ActiveSupport::Notifications.subscribe('deprecation.rails') do |*args|
+            event = ActiveSupport::Notifications::Event.new(*args)
+            handle_deprecation(event)
+          end
+        end
+
+        def handle_deprecation(event)
+          payload = event.payload
+
+          message = payload[:message]
+          callstack = payload[:callstack]
+          gem_name = payload[:gem_name]
+          deprecation_horizon = payload[:deprecation_horizon]
+
+          # Extract relevant caller info
+          caller_info = extract_caller_info(callstack)
+
+          # Record breadcrumb with warning level
+          if BrainzLab.configuration.reflex_effectively_enabled?
+            BrainzLab::Reflex.add_breadcrumb(
+              "Deprecation: #{truncate_message(message)}",
+              category: 'rails.deprecation',
+              level: :warning,
+              data: {
+                message: truncate_message(message, 500),
+                gem_name: gem_name,
+                deprecation_horizon: deprecation_horizon,
+                caller: caller_info
+              }.compact
+            )
+          end
+
+          # Log to Recall for tracking
+          if BrainzLab.configuration.recall_effectively_enabled?
+            BrainzLab::Recall.warn(
+              "Rails deprecation warning",
+              message: truncate_message(message, 500),
+              gem_name: gem_name,
+              deprecation_horizon: deprecation_horizon,
+              caller: caller_info,
+              callstack: truncate_callstack(callstack)
+            )
+          end
+
+          # Track deprecation count in Pulse metrics
+          record_deprecation_metric(gem_name, deprecation_horizon)
+        rescue StandardError => e
+          BrainzLab.debug_log("Rails deprecation instrumentation failed: #{e.message}")
+        end
+
+        # ============================================
+        # Helper Methods
+        # ============================================
+        def extract_caller_info(callstack)
+          return nil unless callstack.is_a?(Array) && callstack.any?
+
+          # Find the first non-Rails, non-gem caller
+          app_caller = callstack.find do |line|
+            line_str = line.to_s
+            !line_str.include?('/gems/') &&
+              !line_str.include?('/ruby/') &&
+              !line_str.include?('/bundler/')
+          end
+
+          (app_caller || callstack.first).to_s
+        end
+
+        def truncate_callstack(callstack, max_lines = 5)
+          return nil unless callstack.is_a?(Array)
+
+          callstack.first(max_lines).map(&:to_s)
+        end
+
+        def truncate_message(message, max_length = 200)
+          return 'unknown' unless message
+
+          msg_str = message.to_s
+          if msg_str.length > max_length
+            "#{msg_str[0, max_length - 3]}..."
+          else
+            msg_str
+          end
+        end
+
+        def record_deprecation_metric(gem_name, horizon)
+          return unless BrainzLab.configuration.pulse_effectively_enabled?
+
+          # If Pulse has a counter/metric API, use it here
+          # For now, we just add a span to track it
+          tracer = BrainzLab::Pulse.tracer
+          return unless tracer.current_trace
+
+          span_data = {
+            span_id: SecureRandom.uuid,
+            name: 'rails.deprecation',
+            kind: 'internal',
+            started_at: Time.now,
+            ended_at: Time.now,
+            duration_ms: 0,
+            error: false,
+            data: {
+              'deprecation.gem_name' => gem_name,
+              'deprecation.horizon' => horizon
+            }.compact
+          }
+
+          tracer.current_spans << span_data
+        end
+      end
+    end
+  end
+end

data/lib/brainzlab/instrumentation/railties.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+module BrainzLab
+  module Instrumentation
+    class Railties
+      # Thresholds for slow initializers (in milliseconds)
+      SLOW_INITIALIZER_THRESHOLD = 100   # 100ms
+      VERY_SLOW_INITIALIZER_THRESHOLD = 500  # 500ms
+
+      class << self
+        def install!
+          return unless defined?(::Rails)
+          return if @installed
+
+          install_load_config_initializer_subscriber!
+
+          @installed = true
+          BrainzLab.debug_log('Railties instrumentation installed')
+        end
+
+        def installed?
+          @installed == true
+        end
+
+        private
+
+        # ============================================
+        # load_config_initializer.railties
+        # Fired when each config initializer is loaded
+        # ============================================
+        def install_load_config_initializer_subscriber!
+          ActiveSupport::Notifications.subscribe('load_config_initializer.railties') do |*args|
+            event = ActiveSupport::Notifications::Event.new(*args)
+            handle_load_config_initializer(event)
+          end
+        end
+
+        def handle_load_config_initializer(event)
+          payload = event.payload
+          duration = event.duration.round(2)
+
+          initializer = payload[:initializer]
+
+          # Extract just the filename for cleaner display
+          initializer_name = extract_initializer_name(initializer)
+
+          # Determine level based on duration
+          level = case duration
+                  when 0...SLOW_INITIALIZER_THRESHOLD then :info
+                  when SLOW_INITIALIZER_THRESHOLD...VERY_SLOW_INITIALIZER_THRESHOLD then :warning
+                  else :error
+                  end
+
+          # Record breadcrumb (only for slow initializers to reduce noise during boot)
+          if duration >= 10 && BrainzLab.configuration.reflex_effectively_enabled?
+            BrainzLab::Reflex.add_breadcrumb(
+              "Initializer loaded: #{initializer_name} (#{duration}ms)",
+              category: 'rails.initializer',
+              level: level,
+              data: {
+                initializer: initializer_name,
+                path: initializer,
+                duration_ms: duration
+              }.compact
+            )
+          end
+
+          # Add Pulse span for tracking boot time
+          record_initializer_span(event, initializer_name, initializer, duration)
+
+          # Log slow initializers
+          log_slow_initializer(initializer_name, initializer, duration) if duration >= SLOW_INITIALIZER_THRESHOLD
+        rescue StandardError => e
+          BrainzLab.debug_log("Railties load_config_initializer instrumentation failed: #{e.message}")
+        end
+
+        # ============================================
+        # Span Recording
+        # ============================================
+        def record_initializer_span(event, name, path, duration)
+          return unless BrainzLab.configuration.pulse_effectively_enabled?
+
+          tracer = BrainzLab::Pulse.tracer
+          return unless tracer.current_trace
+
+          span_data = {
+            span_id: SecureRandom.uuid,
+            name: "rails.initializer.#{name}",
+            kind: 'internal',
+            started_at: event.time,
+            ended_at: event.end,
+            duration_ms: duration,
+            error: false,
+            data: {
+              'rails.initializer.name' => name,
+              'rails.initializer.path' => path
+            }.compact
+          }
+
+          tracer.current_spans << span_data
+        end
+
+        # ============================================
+        # Logging
+        # ============================================
+        def log_slow_initializer(name, path, duration)
+          return unless BrainzLab.configuration.recall_effectively_enabled?
+
+          level = duration >= VERY_SLOW_INITIALIZER_THRESHOLD ? :error : :warn
+
+          BrainzLab::Recall.send(
+            level,
+            "Slow initializer: #{name} (#{duration}ms)",
+            initializer: name,
+            path: path,
+            duration_ms: duration,
+            threshold_exceeded: duration >= VERY_SLOW_INITIALIZER_THRESHOLD ? 'critical' : 'warning'
+          )
+        end
+
+        # ============================================
+        # Helper Methods
+        # ============================================
+        def extract_initializer_name(path)
+          return 'unknown' unless path
+
+          # Extract filename without extension from path
+          # e.g., "/app/config/initializers/devise.rb" -> "devise"
+          File.basename(path.to_s, '.*')
+        end
+      end
+    end
+  end
+end

data/lib/brainzlab/instrumentation.rb

@@ -31,9 +31,17 @@ module BrainzLab
         # Elasticsearch instrumentation
         install_elasticsearch! if config.instrument_elasticsearch
 
-        # ActionMailer instrumentation
+        # Rails MVC instrumentation
+        install_action_controller! if config.instrument_action_controller
+        install_action_view! if config.instrument_action_view
         install_action_mailer! if config.instrument_action_mailer
 
+        # ActiveJob instrumentation (covers all job backends)
+        install_active_job! if config.instrument_active_job
+
+        # ActiveSupport::Cache instrumentation
+        install_active_support_cache! if config.instrument_active_support_cache
+
         # Delayed::Job instrumentation
         install_delayed_job! if config.instrument_delayed_job
 
@@ -55,6 +63,18 @@ module BrainzLab
         # Cloud & Payment
         install_aws! if config.instrument_aws
         install_stripe! if config.instrument_stripe
+
+        # File storage
+        install_active_storage! if config.instrument_active_storage
+
+        # WebSocket
+        install_action_cable! if config.instrument_action_cable
+
+        # Rails framework events
+        install_action_dispatch! if config.instrument_action_dispatch
+        install_rails_deprecation! if config.instrument_rails_deprecation
+        install_action_mailbox! if config.instrument_action_mailbox
+        install_railties! if config.instrument_railties
       end
 
       def install_net_http!
@@ -116,6 +136,20 @@ module BrainzLab
         ElasticsearchInstrumentation.install!
       end
 
+      def install_action_controller!
+        return unless defined?(::ActionController)
+
+        require_relative 'instrumentation/action_controller'
+        ActionController.install!
+      end
+
+      def install_action_view!
+        return unless defined?(::ActionView)
+
+        require_relative 'instrumentation/action_view'
+        ActionView.install!
+      end
+
       def install_action_mailer!
         return unless defined?(::ActionMailer)
 
@@ -123,6 +157,20 @@ module BrainzLab
         ActionMailerInstrumentation.install!
       end
 
+      def install_active_job!
+        return unless defined?(::ActiveJob)
+
+        require_relative 'instrumentation/active_job'
+        ActiveJob.install!
+      end
+
+      def install_active_support_cache!
+        return unless defined?(::ActiveSupport::Cache)
+
+        require_relative 'instrumentation/active_support_cache'
+        ActiveSupportCache.install!
+      end
+
       def install_delayed_job!
         return unless defined?(::Delayed::Job) || defined?(::Delayed::Backend)
 
@@ -193,6 +241,48 @@ module BrainzLab
         StripeInstrumentation.install!
       end
 
+      def install_active_storage!
+        return unless defined?(::ActiveStorage)
+
+        require_relative 'instrumentation/active_storage'
+        ActiveStorage.install!
+      end
+
+      def install_action_cable!
+        return unless defined?(::ActionCable)
+
+        require_relative 'instrumentation/action_cable'
+        ActionCable.install!
+      end
+
+      def install_action_dispatch!
+        return unless defined?(::ActionDispatch)
+
+        require_relative 'instrumentation/action_dispatch'
+        ActionDispatch.install!
+      end
+
+      def install_rails_deprecation!
+        return unless defined?(::Rails)
+
+        require_relative 'instrumentation/rails_deprecation'
+        RailsDeprecation.install!
+      end
+
+      def install_action_mailbox!
+        return unless defined?(::ActionMailbox)
+
+        require_relative 'instrumentation/action_mailbox'
+        ActionMailbox.install!
+      end
+
+      def install_railties!
+        return unless defined?(::Rails)
+
+        require_relative 'instrumentation/railties'
+        Railties.install!
+      end
+
       # Manual installation methods for lazy-loaded libraries
       def install_http!
         install_net_http!

data/lib/brainzlab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrainzLab
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainzlab
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Brainz Lab
@@ -123,8 +123,16 @@ files:
 - lib/brainzlab/flux/client.rb
 - lib/brainzlab/flux/provisioner.rb
 - lib/brainzlab/instrumentation.rb
+- lib/brainzlab/instrumentation/action_cable.rb
+- lib/brainzlab/instrumentation/action_controller.rb
+- lib/brainzlab/instrumentation/action_dispatch.rb
+- lib/brainzlab/instrumentation/action_mailbox.rb
 - lib/brainzlab/instrumentation/action_mailer.rb
+- lib/brainzlab/instrumentation/action_view.rb
+- lib/brainzlab/instrumentation/active_job.rb
 - lib/brainzlab/instrumentation/active_record.rb
+- lib/brainzlab/instrumentation/active_storage.rb
+- lib/brainzlab/instrumentation/active_support_cache.rb
 - lib/brainzlab/instrumentation/aws.rb
 - lib/brainzlab/instrumentation/dalli.rb
 - lib/brainzlab/instrumentation/delayed_job.rb
@@ -137,6 +145,8 @@ files:
 - lib/brainzlab/instrumentation/httparty.rb
 - lib/brainzlab/instrumentation/mongodb.rb
 - lib/brainzlab/instrumentation/net_http.rb
+- lib/brainzlab/instrumentation/rails_deprecation.rb
+- lib/brainzlab/instrumentation/railties.rb
 - lib/brainzlab/instrumentation/redis.rb
 - lib/brainzlab/instrumentation/resque.rb
 - lib/brainzlab/instrumentation/sidekiq.rb