activerabbit-ai 0.6.3 → 0.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d02e83fd5992873b3b7aabb322ab9e3c914b91e7e64b4a80be335007561bc404
-  data.tar.gz: d60e55a0fcab7c981d7b7a214cff142825c613e7d32ddf15533bccd451cb6657
+  metadata.gz: 8f857d4340fe645c130c5b892b533cd4fcb7daec16f4616402dfff2b41e8fe81
+  data.tar.gz: 864bb6b6bacbec9e8c3777400f340977df074af989c4b7130f773876c3b8d32a
 SHA512:
-  metadata.gz: 32a57acfde857e55a97932f56ae1a449f04a7e51e7ad8903d2cf63380ddd338cf0930d18785559f2bf358250470ce1890f503dde670aaebddf1756f6b5675c2f
-  data.tar.gz: dad613e6edf130e26c185b2b17670366400c4a40a36ebf0d8017a77189f01c1647c0cbd3ef7f810727a47beccf46b5f482394b681424982ad64a020eb1bcd768
+  metadata.gz: afcfc21570337a0b77e70ef7da3b7f78465c0d5eb9ba9e4cefd6491728065754385dd742b93f7c97d465fc571171dc27d5e448b547639030770b268879b4f59f
+  data.tar.gz: 2687df8f73f2e4dec19ce5e55af23f92c6b66649392d341dcc9309bc8acb23300180e56fa7594286d2abed5e8ec3024a8f1016accff91665e09627691cc190e7

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.6.4] - 2026-04-01
+
+### Added
+- **Log forwarding**: New `LogForwarder` buffers Rails log lines and sends them in batches to `POST /api/v1/logs`. Enable with `config.enable_logs = true` in the ActiveRabbit initializer.
+- **Configuration**: `logs_flush_interval`, `logs_batch_size`, and optional `logs_source` for tuning batching and labeling forwarded logs.
+- **Rails integration**: Railtie registers the forwarder with `ActiveSupport::BroadcastLogger` so `Rails.logger` output is forwarded without changing application code. Flush/shutdown hooks keep the forwarder aligned with the app lifecycle.
+
 ## [0.6.3] - 2026-03-30
 
 ### Added

data/lib/active_rabbit/client/configuration.rb

@@ -11,6 +11,7 @@ module ActiveRabbit
       attr_accessor :batch_size, :flush_interval, :queue_size
       attr_accessor :enable_performance_monitoring, :enable_n_plus_one_detection
       attr_accessor :enable_pii_scrubbing, :pii_fields
+      attr_accessor :enable_logs, :logs_flush_interval, :logs_batch_size, :logs_source
       attr_accessor :ignored_exceptions, :ignored_user_agents, :ignore_404
       attr_accessor :release, :server_name, :logger
       attr_accessor :before_send_event, :before_send_exception
@@ -40,8 +41,14 @@ module ActiveRabbit
         @enable_performance_monitoring = true
         @enable_n_plus_one_detection = true
         @enable_pii_scrubbing = true
+        @enable_logs = false
         @disable_console_logs = true
 
+        # Log forwarding
+        @logs_flush_interval = 5
+        @logs_batch_size = 100
+        @logs_source = nil
+
         # PII scrubbing
         @pii_fields = %w[
           password password_confirmation token secret key

data/lib/active_rabbit/client/log_forwarder.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "logger"
+
+module ActiveRabbit
+  module Client
+    # Logger subclass that buffers log entries and forwards them in batches to
+    # the ActiveRabbit POST /api/v1/logs endpoint.
+    #
+    # Plugged into ActiveSupport::BroadcastLogger automatically by the Railtie
+    # when `config.enable_logs = true`, so every Rails.logger call is forwarded
+    # without touching application code.
+    class LogForwarder < ::Logger
+      SEVERITY_MAP = { 0 => "debug", 1 => "info", 2 => "warn",
+                       3 => "error", 4 => "fatal", 5 => "info" }.freeze
+
+      MAX_MESSAGE_LEN = 10_000
+
+      def initialize(configuration)
+        @configuration = configuration
+        @buffer = []
+        @mutex  = Mutex.new
+        @uri    = URI("#{configuration.api_url.chomp('/')}/api/v1/logs")
+        @stopped = false
+
+        super(File::NULL, level: ::Logger::DEBUG)
+        self.formatter = proc { |*, msg| msg }
+
+        start_flusher
+      end
+
+      # -- Logger interface --------------------------------------------------
+
+      def add(severity, message = nil, progname = nil, &block)
+        return true if Thread.current[:_ar_log_sending]
+
+        severity ||= UNKNOWN
+        return true if severity < level
+
+        message = block&.call if message.nil? && block
+        message ||= progname
+        return true if message.nil?
+
+        msg = message.to_s.strip
+        return true if msg.empty?
+        msg = msg[0, MAX_MESSAGE_LEN] if msg.length > MAX_MESSAGE_LEN
+
+        entry = build_entry(severity, msg)
+        @mutex.synchronize { @buffer << entry }
+        async_flush if buffer_size >= batch_size
+        true
+      end
+
+      def flush
+        entries = swap_buffer
+        send_batch(entries) if entries&.any?
+      end
+
+      def stop
+        @stopped = true
+        flush
+      end
+
+      private
+
+      def build_entry(severity, message)
+        ctx = Thread.current[:active_rabbit_request_context]
+
+        {
+          level:       SEVERITY_MAP[severity] || "info",
+          message:     message,
+          source:      @configuration.logs_source || "rails",
+          environment: @configuration.environment || (defined?(Rails) ? Rails.env.to_s : "production"),
+          occurred_at: Time.now.utc.strftime("%Y-%m-%dT%H:%M:%S.%6NZ"),
+          request_id:  ctx&.dig(:request_id),
+          context:     { pid: Process.pid }
+        }.compact
+      end
+
+      def batch_size
+        @configuration.logs_batch_size || 100
+      end
+
+      def flush_interval
+        @configuration.logs_flush_interval || 5
+      end
+
+      def buffer_size
+        @mutex.synchronize { @buffer.size }
+      end
+
+      def swap_buffer
+        @mutex.synchronize do
+          return nil if @buffer.empty?
+          out = @buffer.dup
+          @buffer.clear
+          out
+        end
+      end
+
+      def async_flush
+        Thread.new { flush }
+      end
+
+      def start_flusher
+        Thread.new do
+          loop do
+            sleep flush_interval
+            break if @stopped
+            flush
+          rescue StandardError
+            nil
+          end
+        end
+      end
+
+      def send_batch(entries)
+        return if entries.nil? || entries.empty?
+
+        Thread.current[:_ar_log_sending] = true
+
+        entries.each_slice(1000) do |chunk|
+          http = Net::HTTP.new(@uri.host, @uri.port)
+          http.use_ssl = (@uri.scheme == "https")
+          http.open_timeout = 5
+          http.read_timeout = 10
+
+          req = Net::HTTP::Post.new(@uri)
+          req["Content-Type"]    = "application/json"
+          req["X-Project-Token"] = @configuration.api_key
+          req.body = { entries: chunk }.to_json
+
+          http.request(req)
+        end
+      rescue StandardError
+        nil
+      ensure
+        Thread.current[:_ar_log_sending] = false
+      end
+    end
+  end
+end

data/lib/active_rabbit/client/railtie.rb

@@ -325,6 +325,25 @@ module ActiveRabbit
         ar_log(:info, "[ActiveRabbit] Middleware configured successfully")
       end
 
+      initializer "active_rabbit.log_forwarding", after: :initialize_logger do |app|
+        app.config.after_initialize do
+          cfg = ActiveRabbit::Client.configuration
+          next unless cfg&.enable_logs
+          next unless ActiveRabbit::Client.configured?
+
+          forwarder = ActiveRabbit::Client.log_forwarder
+          next unless forwarder
+
+          if Rails.logger.is_a?(ActiveSupport::BroadcastLogger)
+            Rails.logger.broadcast_to(forwarder)
+          else
+            Rails.logger = ActiveSupport::BroadcastLogger.new(Rails.logger, forwarder)
+          end
+
+          ar_log(:info, "[ActiveRabbit] Log forwarding enabled")
+        end
+      end
+
       initializer "active_rabbit.error_reporter" do |app|
         # DISABLED: Rails error reporter creates duplicate events because middleware already catches all errors
         # The middleware provides better context and catches errors at the right level

data/lib/active_rabbit/client/version.rb

@@ -1,5 +1,5 @@
 module ActiveRabbit
   module Client
-    VERSION = "0.6.3"
+    VERSION = "0.6.4"
   end
 end

data/lib/active_rabbit/client.rb

@@ -9,6 +9,7 @@ require_relative "client/performance_monitor"
 require_relative "client/n_plus_one_detector"
 require_relative "client/pii_scrubber"
 require_relative "client/error_reporter"
+require_relative "client/log_forwarder"
 
 # Rails integration (optional)
 begin
@@ -117,6 +118,7 @@ module ActiveRabbit
         event_processor.flush
         exception_tracker.flush
         performance_monitor.flush
+        @log_forwarder&.flush
       end
 
       # Shutdown the client gracefully
@@ -124,10 +126,17 @@ module ActiveRabbit
         return unless configured?
 
         flush
+        @log_forwarder&.stop
         event_processor.shutdown
         http_client.shutdown
       end
 
+      # Returns the LogForwarder instance (created on first access when enabled).
+      def log_forwarder
+        return nil unless configuration&.enable_logs
+        @log_forwarder ||= LogForwarder.new(configuration)
+      end
+
       # Manual capture convenience for non-Rails contexts
       def capture_exception(exception, context: {}, user_id: nil, tags: {})
         track_exception(exception, context: context, user_id: user_id, tags: tags)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activerabbit-ai
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.6.4
 platform: ruby
 authors:
 - Alex Shapalov
@@ -95,6 +95,7 @@ files:
 - lib/active_rabbit/client/event_processor.rb
 - lib/active_rabbit/client/exception_tracker.rb
 - lib/active_rabbit/client/http_client.rb
+- lib/active_rabbit/client/log_forwarder.rb
 - lib/active_rabbit/client/n_plus_one_detector.rb
 - lib/active_rabbit/client/performance_monitor.rb
 - lib/active_rabbit/client/pii_scrubber.rb