activerabbit-ai 0.6.2 → 0.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c71eb72533f7d6588444722f3ca8502230006f75bd12cee11b7f585e0a00aa1a
-  data.tar.gz: e187bb60976eda2eccd743589737240f40930897f6063c9ff6b061e517786135
+  metadata.gz: 8f857d4340fe645c130c5b892b533cd4fcb7daec16f4616402dfff2b41e8fe81
+  data.tar.gz: 864bb6b6bacbec9e8c3777400f340977df074af989c4b7130f773876c3b8d32a
 SHA512:
-  metadata.gz: 97ffc354514d50a73b8f32dd086e6d2a095bea00e0ce095464c7ea0a389fc8b1304359125a798abfabf4f456095aec51f3a086a2f6cb1d4c0d3eb5367d1744f0
-  data.tar.gz: dafed4a9c5c2de391bdc1527de3092340a093afdde7cc336a04c533c7d4898d5fad4987992fa3861dbbf806dd792eaa8e2a1037cc0a00133e235cd86747a4e3e
+  metadata.gz: afcfc21570337a0b77e70ef7da3b7f78465c0d5eb9ba9e4cefd6491728065754385dd742b93f7c97d465fc571171dc27d5e448b547639030770b268879b4f59f
+  data.tar.gz: 2687df8f73f2e4dec19ce5e55af23f92c6b66649392d341dcc9309bc8acb23300180e56fa7594286d2abed5e8ec3024a8f1016accff91665e09627691cc190e7

data/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 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
+- **HTTP client request id**: `make_request` sends a stable `X-Request-Id` header (same value across retries) so APIs can correlate or deduplicate requests after timeouts and transient failures.
+- **Explicit `securerandom` load**: `HttpClient` requires `securerandom` so `SecureRandom` is always available regardless of load order.
+
 ## [0.6.2] - 2026-01-26
 
 ### Fixed

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/cron_monitor.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module ActiveRabbit
+  module Client
+    # Sentry-style cron check-ins for Active Job: in_progress at start, ok on success, error on failure.
+    #
+    #   class BackupJob < ApplicationJob
+    #     include ActiveRabbit::Client::CronMonitor
+    #     active_rabbit_cron slug: "nightly_backup"
+    #
+    #     def perform
+    #       # ...
+    #     end
+    #   end
+    module CronMonitor
+      def self.included(base)
+        base.extend(ClassMethods)
+        base.class_eval do
+          around_perform :_active_rabbit_cron_monitor_around
+        end
+      end
+
+      module ClassMethods
+        # @param value [String, Symbol, Hash] string/symbol slug, or { slug: "..." }
+        def active_rabbit_cron(value = nil)
+          case value
+          when String, Symbol
+            @active_rabbit_cron_slug = value.to_s.strip
+          when Hash
+            s = value[:slug].to_s.strip
+            @active_rabbit_cron_slug = s.empty? ? nil : s
+          when nil
+            @active_rabbit_cron_slug = nil
+          end
+        end
+
+        def active_rabbit_cron_monitor_slug
+          slug = instance_variable_defined?(:@active_rabbit_cron_slug) ? @active_rabbit_cron_slug : nil
+          return slug if slug.is_a?(String) && !slug.strip.empty?
+
+          name.to_s.underscore.tr("/", "_")
+        end
+      end
+
+      private
+
+      def _active_rabbit_cron_monitor_around(&block)
+        slug = self.class.active_rabbit_cron_monitor_slug
+        if slug.to_s.strip.empty? || !ActiveRabbit::Client.configured?
+          block.call
+          return
+        end
+
+        ActiveRabbit::Client.capture_cron_check_in(slug, :in_progress)
+        begin
+          block.call
+        rescue StandardError => e
+          ActiveRabbit::Client.capture_cron_check_in(slug, :error)
+          raise e
+        end
+        ActiveRabbit::Client.capture_cron_check_in(slug, :ok)
+      end
+    end
+  end
+end

data/lib/active_rabbit/client/exception_tracker.rb

@@ -131,6 +131,9 @@ module ActiveRabbit
           structured_stack_trace: structured_frames,
           culprit_frame: culprit_frame,
 
+          # Error source: backend (Ruby gem) vs frontend (JS SDK)
+          source: "backend",
+
           # Timing and environment
           occurred_at: Time.now.iso8601(3),
           environment: configuration.environment || 'development',

data/lib/active_rabbit/client/http_client.rb

@@ -6,6 +6,7 @@ require "json"
 require "concurrent"
 require "time"
 require "uri"
+require "securerandom"
 
 module ActiveRabbit
   module Client
@@ -140,6 +141,12 @@ module ActiveRabbit
         { success: false, error: e.message }
       end
 
+      # Cron / heartbeat check-in (project token + monitor slug). Synchronous, not batched.
+      def post_cron_check_in(slug:, status: :ok)
+        payload = stringify_and_sanitize({ slug: slug.to_s, status: status.to_s })
+        make_request(:post, "/api/v1/cron/check_ins", payload)
+      end
+
       def flush
         return if @request_queue.empty?
 
@@ -225,12 +232,16 @@ module ActiveRabbit
         log(:debug, "[ActiveRabbit] Request headers: X-Project-Token=#{configuration.api_key}, X-Project-ID=#{configuration.project_id}")
         log(:debug, "[ActiveRabbit] Request body: #{safe_preview(data)}")
 
+        # Generate a stable request ID for dedup — same ID is reused across retries
+        # so the server can reject duplicates when we retry after a timeout.
+        request_id = SecureRandom.uuid
+
         # Retry logic with exponential backoff
         retries = 0
         max_retries = configuration.retry_count
 
         begin
-          response = perform_request(uri, method, data)
+          response = perform_request(uri, method, data, request_id: request_id)
           log(:info, "[ActiveRabbit] Response status: #{response.code}")
           log(:debug, "[ActiveRabbit] Response headers: #{response.to_hash.inspect}")
           log(:debug, "[ActiveRabbit] Response body: #{response.body}")
@@ -273,7 +284,7 @@ module ActiveRabbit
         end
       end
 
-      def perform_request(uri, method, data)
+      def perform_request(uri, method, data, request_id: nil)
         log(:debug, "[ActiveRabbit] Making HTTP request: #{method.upcase} #{uri}")
         http = Net::HTTP.new(uri.host, uri.port)
 
@@ -308,6 +319,7 @@ module ActiveRabbit
         request['Accept'] = 'application/json'
         request['User-Agent'] = "ActiveRabbit-Client/#{ActiveRabbit::Client::VERSION}"
         request['X-Project-Token'] = configuration.api_key
+        request['X-Request-Id'] = request_id if request_id
 
         if configuration.project_id
           request['X-Project-ID'] = configuration.project_id

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.2"
+    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
@@ -24,6 +25,12 @@ rescue LoadError
   # Sidekiq not available, skip integration
 end
 
+# Active Job cron monitors (optional)
+begin
+  require_relative "client/cron_monitor" if defined?(ActiveJob)
+rescue LoadError
+end
+
 module ActiveRabbit
   module Client
     class Error < StandardError; end
@@ -111,6 +118,7 @@ module ActiveRabbit
         event_processor.flush
         exception_tracker.flush
         performance_monitor.flush
+        @log_forwarder&.flush
       end
 
       # Shutdown the client gracefully
@@ -118,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)
@@ -144,6 +159,19 @@ module ActiveRabbit
         http_client.post_release(payload)
       end
 
+      # Cron / heartbeat monitor (uses project API token + slug). Status: :ok, :success, :in_progress, :error.
+      def capture_cron_check_in(slug, status = :ok)
+        return unless configured?
+
+        s = slug.to_s.strip
+        return nil if s.empty?
+
+        http_client.post_cron_check_in(slug: s, status: status)
+      rescue => e
+        log(:error, "[ActiveRabbit] capture_cron_check_in failed: #{e.class}: #{e.message}")
+        nil
+      end
+
       def log(level, message)
         cfg = configuration
         return if cfg.nil? || cfg.disable_console_logs

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: activerabbit-ai
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.6.4
 platform: ruby
 authors:
 - Alex Shapalov
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-27 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -90,11 +89,13 @@ files:
 - lib/active_rabbit/client/action_mailer_patch.rb
 - lib/active_rabbit/client/active_job_extensions.rb
 - lib/active_rabbit/client/configuration.rb
+- lib/active_rabbit/client/cron_monitor.rb
 - lib/active_rabbit/client/dedupe.rb
 - lib/active_rabbit/client/error_reporter.rb
 - 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
@@ -120,7 +121,6 @@ metadata:
   allowed_push_host: https://rubygems.org
   source_code_uri: https://github.com/bugrabbit/active_rabbit-client
   changelog_uri: https://github.com/bugrabbit/active_rabbit-client/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -135,8 +135,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.15
-signing_key:
+rubygems_version: 4.0.7
 specification_version: 4
 summary: Ruby client for ActiveRabbit.ai application monitoring and error tracking
 test_files: []