brainzlab 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2ccfb8ed0a1aefc1a67e709438812194e6a6a1ce79f7044824ab3f2accd3aca
-  data.tar.gz: 99df1dbd2842a09ab90165755746a8248c5b103854dcddd8c28c1f8ee7e239f9
+  metadata.gz: bf91a415760bc97688aa6d97c80fc4aa0c2677d0f299799eaf6a52ed5762b0b7
+  data.tar.gz: fc11f28cd6e93ff15430ca2a33d2068c19a0605cc27cac1232b23b730d36f1c2
 SHA512:
-  metadata.gz: 49a8f8a4be96f4f917fef27661caa12bde990cfa88dcc19d8917c4c74c4446b63cff26ad52ee524c577d8c9bc3f6767315245e1dace168a46422858f43af2620
-  data.tar.gz: d64004b9afc21429742c61deebbfd5cfe244b83ff477bb4c4809d9fd156917652e150f0236aca3abba6d42df53a231fd6deb54c57b7914f1267d40cc4d1f9a75
+  metadata.gz: '09ae587f4463bd67d19f5d059c4fd810ce337099ad7bbe4bd3eea586d01294f22c904298aa121668329a995be3df9682624fa2b01dd57e00d6e2b8243eaf6a85'
+  data.tar.gz: 93da1a25704e85ac769c686509d98cfd950620304f4c5d90b18fa9c14cb542c6696eab29a056eaecf125dad992607f4a3050e1009c81976650226b08f34924b7

data/lib/brainzlab/configuration.rb

@@ -112,7 +112,11 @@ module BrainzLab
                   :instrument_graphql,
                   :instrument_mongodb,
                   :instrument_elasticsearch,
+                  :instrument_action_controller,
+                  :instrument_action_view,
                   :instrument_action_mailer,
+                  :instrument_active_job,
+                  :instrument_active_support_cache,
                   :instrument_delayed_job,
                   :instrument_grape,
                   :instrument_solid_queue,
@@ -123,6 +127,12 @@ module BrainzLab
                   :instrument_dalli,
                   :instrument_aws,
                   :instrument_stripe,
+                  :instrument_active_storage,
+                  :instrument_action_cable,
+                  :instrument_action_dispatch,
+                  :instrument_rails_deprecation,
+                  :instrument_action_mailbox,
+                  :instrument_railties,
                   :http_ignore_hosts,
                   :redis_ignore_commands,
                   :log_formatter_enabled,
@@ -301,7 +311,11 @@ module BrainzLab
       @instrument_graphql = true  # GraphQL query instrumentation
       @instrument_mongodb = true  # MongoDB/Mongoid instrumentation
       @instrument_elasticsearch = true  # Elasticsearch instrumentation
+      @instrument_action_controller = true  # ActionController instrumentation (requests, redirects, filters)
+      @instrument_action_view = true  # ActionView instrumentation (templates, partials, collections)
       @instrument_action_mailer = true  # ActionMailer instrumentation
+      @instrument_active_job = true  # ActiveJob instrumentation (enqueue, perform, retry, discard)
+      @instrument_active_support_cache = true  # ActiveSupport::Cache instrumentation (read, write, fetch)
       @instrument_delayed_job = true # Delayed::Job instrumentation
       @instrument_grape = true # Grape API instrumentation
       @instrument_solid_queue = true # Solid Queue job instrumentation
@@ -312,6 +326,12 @@ module BrainzLab
       @instrument_dalli = true # Dalli/Memcached instrumentation
       @instrument_aws = true # AWS SDK instrumentation
       @instrument_stripe = true # Stripe API instrumentation
+      @instrument_active_storage = true # ActiveStorage instrumentation (uploads, downloads, transforms)
+      @instrument_action_cable = true # ActionCable WebSocket instrumentation
+      @instrument_action_dispatch = true # ActionDispatch instrumentation (middleware, redirects, requests)
+      @instrument_rails_deprecation = true # Rails deprecation warnings tracking
+      @instrument_action_mailbox = true # ActionMailbox inbound email processing instrumentation
+      @instrument_railties = true # Railties config initializer loading instrumentation
       @http_ignore_hosts = %w[localhost 127.0.0.1]
       @redis_ignore_commands = %w[ping info] # Commands to skip tracking
 

data/lib/brainzlab/instrumentation/action_cable.rb

@@ -0,0 +1,351 @@
+# frozen_string_literal: true
+
+module BrainzLab
+  module Instrumentation
+    class ActionCable
+      # Thresholds for slow operations (in milliseconds)
+      SLOW_ACTION_THRESHOLD = 100
+      VERY_SLOW_ACTION_THRESHOLD = 500
+
+      class << self
+        def install!
+          return unless defined?(::ActionCable)
+          return if @installed
+
+          install_perform_action_subscriber!
+          install_transmit_subscriber!
+          install_transmit_subscription_confirmation_subscriber!
+          install_transmit_subscription_rejection_subscriber!
+          install_broadcast_subscriber!
+
+          @installed = true
+          BrainzLab.debug_log('ActionCable instrumentation installed')
+        end
+
+        def installed?
+          @installed == true
+        end
+
+        private
+
+        # ============================================
+        # perform_action.action_cable
+        # ============================================
+        def install_perform_action_subscriber!
+          ActiveSupport::Notifications.subscribe('perform_action.action_cable') do |*args|
+            event = ActiveSupport::Notifications::Event.new(*args)
+            handle_perform_action(event)
+          end
+        end
+
+        def handle_perform_action(event)
+          payload = event.payload
+          duration = event.duration.round(2)
+
+          channel_class = payload[:channel_class]
+          action = payload[:action]
+          data = payload[:data]
+
+          # Determine level based on duration
+          level = case duration
+                  when 0...SLOW_ACTION_THRESHOLD then :info
+                  when SLOW_ACTION_THRESHOLD...VERY_SLOW_ACTION_THRESHOLD then :warning
+                  else :error
+                  end
+
+          # Record breadcrumb
+          if BrainzLab.configuration.reflex_effectively_enabled?
+            BrainzLab::Reflex.add_breadcrumb(
+              "Cable action: #{channel_class}##{action} (#{duration}ms)",
+              category: 'cable.action',
+              level: level,
+              data: {
+                channel: channel_class,
+                action: action,
+                duration_ms: duration
+              }.compact
+            )
+          end
+
+          # Add Pulse span
+          record_action_span(event, channel_class, action, duration, data)
+
+          # Log slow actions
+          log_slow_action(channel_class, action, duration) if duration >= SLOW_ACTION_THRESHOLD
+        rescue StandardError => e
+          BrainzLab.debug_log("ActionCable perform_action instrumentation failed: #{e.message}")
+        end
+
+        # ============================================
+        # transmit.action_cable
+        # ============================================
+        def install_transmit_subscriber!
+          ActiveSupport::Notifications.subscribe('transmit.action_cable') do |*args|
+            event = ActiveSupport::Notifications::Event.new(*args)
+            handle_transmit(event)
+          end
+        end
+
+        def handle_transmit(event)
+          payload = event.payload
+          duration = event.duration.round(2)
+
+          channel_class = payload[:channel_class]
+          data = payload[:data]
+          via = payload[:via]
+
+          # Record breadcrumb
+          if BrainzLab.configuration.reflex_effectively_enabled?
+            message = via ? "Cable transmit via #{via}" : 'Cable transmit'
+            BrainzLab::Reflex.add_breadcrumb(
+              "#{message}: #{channel_class} (#{duration}ms)",
+              category: 'cable.transmit',
+              level: :info,
+              data: {
+                channel: channel_class,
+                via: via,
+                duration_ms: duration
+              }.compact
+            )
+          end
+
+          # Add Pulse span
+          record_transmit_span(event, channel_class, duration, via)
+        rescue StandardError => e
+          BrainzLab.debug_log("ActionCable transmit instrumentation failed: #{e.message}")
+        end
+
+        # ============================================
+        # transmit_subscription_confirmation.action_cable
+        # ============================================
+        def install_transmit_subscription_confirmation_subscriber!
+          ActiveSupport::Notifications.subscribe('transmit_subscription_confirmation.action_cable') do |*args|
+            event = ActiveSupport::Notifications::Event.new(*args)
+            handle_subscription_confirmation(event)
+          end
+        end
+
+        def handle_subscription_confirmation(event)
+          payload = event.payload
+          duration = event.duration.round(2)
+
+          channel_class = payload[:channel_class]
+
+          # Record breadcrumb
+          if BrainzLab.configuration.reflex_effectively_enabled?
+            BrainzLab::Reflex.add_breadcrumb(
+              "Cable subscribed: #{channel_class}",
+              category: 'cable.subscribe',
+              level: :info,
+              data: {
+                channel: channel_class,
+                status: 'confirmed',
+                duration_ms: duration
+              }.compact
+            )
+          end
+
+          # Add Pulse span
+          record_subscription_span(event, channel_class, 'confirmed', duration)
+        rescue StandardError => e
+          BrainzLab.debug_log("ActionCable subscription confirmation instrumentation failed: #{e.message}")
+        end
+
+        # ============================================
+        # transmit_subscription_rejection.action_cable
+        # ============================================
+        def install_transmit_subscription_rejection_subscriber!
+          ActiveSupport::Notifications.subscribe('transmit_subscription_rejection.action_cable') do |*args|
+            event = ActiveSupport::Notifications::Event.new(*args)
+            handle_subscription_rejection(event)
+          end
+        end
+
+        def handle_subscription_rejection(event)
+          payload = event.payload
+          duration = event.duration.round(2)
+
+          channel_class = payload[:channel_class]
+
+          # Record breadcrumb - rejection is a warning
+          if BrainzLab.configuration.reflex_effectively_enabled?
+            BrainzLab::Reflex.add_breadcrumb(
+              "Cable subscription rejected: #{channel_class}",
+              category: 'cable.subscribe',
+              level: :warning,
+              data: {
+                channel: channel_class,
+                status: 'rejected',
+                duration_ms: duration
+              }.compact
+            )
+          end
+
+          # Add Pulse span
+          record_subscription_span(event, channel_class, 'rejected', duration)
+
+          # Log rejection to Recall
+          if BrainzLab.configuration.recall_effectively_enabled?
+            BrainzLab::Recall.warn(
+              "ActionCable subscription rejected",
+              channel: channel_class
+            )
+          end
+        rescue StandardError => e
+          BrainzLab.debug_log("ActionCable subscription rejection instrumentation failed: #{e.message}")
+        end
+
+        # ============================================
+        # broadcast.action_cable
+        # ============================================
+        def install_broadcast_subscriber!
+          ActiveSupport::Notifications.subscribe('broadcast.action_cable') do |*args|
+            event = ActiveSupport::Notifications::Event.new(*args)
+            handle_broadcast(event)
+          end
+        end
+
+        def handle_broadcast(event)
+          payload = event.payload
+          duration = event.duration.round(2)
+
+          broadcasting = payload[:broadcasting]
+          message = payload[:message]
+          coder = payload[:coder]
+
+          # Record breadcrumb
+          if BrainzLab.configuration.reflex_effectively_enabled?
+            BrainzLab::Reflex.add_breadcrumb(
+              "Cable broadcast: #{broadcasting} (#{duration}ms)",
+              category: 'cable.broadcast',
+              level: :info,
+              data: {
+                broadcasting: broadcasting,
+                coder: coder&.to_s,
+                duration_ms: duration
+              }.compact
+            )
+          end
+
+          # Add Pulse span
+          record_broadcast_span(event, broadcasting, duration, coder)
+        rescue StandardError => e
+          BrainzLab.debug_log("ActionCable broadcast instrumentation failed: #{e.message}")
+        end
+
+        # ============================================
+        # Span Recording Helpers
+        # ============================================
+        def record_action_span(event, channel_class, action, duration, data)
+          return unless BrainzLab.configuration.pulse_effectively_enabled?
+
+          tracer = BrainzLab::Pulse.tracer
+          return unless tracer.current_trace
+
+          span_data = {
+            span_id: SecureRandom.uuid,
+            name: "cable.action.#{action}",
+            kind: 'websocket',
+            started_at: event.time,
+            ended_at: event.end,
+            duration_ms: duration,
+            error: false,
+            data: {
+              'cable.channel' => channel_class,
+              'cable.action' => action
+            }.compact
+          }
+
+          tracer.current_spans << span_data
+        end
+
+        def record_transmit_span(event, channel_class, duration, via)
+          return unless BrainzLab.configuration.pulse_effectively_enabled?
+
+          tracer = BrainzLab::Pulse.tracer
+          return unless tracer.current_trace
+
+          span_data = {
+            span_id: SecureRandom.uuid,
+            name: 'cable.transmit',
+            kind: 'websocket',
+            started_at: event.time,
+            ended_at: event.end,
+            duration_ms: duration,
+            error: false,
+            data: {
+              'cable.channel' => channel_class,
+              'cable.via' => via
+            }.compact
+          }
+
+          tracer.current_spans << span_data
+        end
+
+        def record_subscription_span(event, channel_class, status, duration)
+          return unless BrainzLab.configuration.pulse_effectively_enabled?
+
+          tracer = BrainzLab::Pulse.tracer
+          return unless tracer.current_trace
+
+          span_data = {
+            span_id: SecureRandom.uuid,
+            name: 'cable.subscribe',
+            kind: 'websocket',
+            started_at: event.time,
+            ended_at: event.end,
+            duration_ms: duration,
+            error: status == 'rejected',
+            data: {
+              'cable.channel' => channel_class,
+              'cable.subscription_status' => status
+            }.compact
+          }
+
+          tracer.current_spans << span_data
+        end
+
+        def record_broadcast_span(event, broadcasting, duration, coder)
+          return unless BrainzLab.configuration.pulse_effectively_enabled?
+
+          tracer = BrainzLab::Pulse.tracer
+          return unless tracer.current_trace
+
+          span_data = {
+            span_id: SecureRandom.uuid,
+            name: 'cable.broadcast',
+            kind: 'websocket',
+            started_at: event.time,
+            ended_at: event.end,
+            duration_ms: duration,
+            error: false,
+            data: {
+              'cable.broadcasting' => broadcasting,
+              'cable.coder' => coder&.to_s
+            }.compact
+          }
+
+          tracer.current_spans << span_data
+        end
+
+        # ============================================
+        # Logging Helpers
+        # ============================================
+        def log_slow_action(channel_class, action, duration)
+          return unless BrainzLab.configuration.recall_effectively_enabled?
+
+          level = duration >= VERY_SLOW_ACTION_THRESHOLD ? :error : :warn
+
+          BrainzLab::Recall.send(
+            level,
+            "Slow ActionCable action: #{channel_class}##{action} (#{duration}ms)",
+            channel: channel_class,
+            action: action,
+            duration_ms: duration,
+            threshold_exceeded: duration >= VERY_SLOW_ACTION_THRESHOLD ? 'critical' : 'warning'
+          )
+        end
+      end
+    end
+  end
+end