ruby_event_store-outbox 0.0.9 → 0.0.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da07b2263a96dbbfaad959ab5dd5636d5bb3398d810894080ab6e3f80750c29f
-  data.tar.gz: 53cd5a2de183f9c821eacf6c05689f42e1fdc39120aac25aa450f90601bbd964
+  metadata.gz: 91feb43e38aa95c274645362994ea620af420b7321c5a687b03a65e68c316ef2
+  data.tar.gz: 8bba1d8a2ef44cf6d7a64ba971da9fc4efe12f78b7fc1dc9bc7ab05134525dfe
 SHA512:
-  metadata.gz: d6e7cb309a64e4743ae5e6d182987c7b1d35378b0a371ce784c2f0695de026903a92d58106e98fdbab73687bf0c35f89912a614982f8347e5b4d0f0ab0daabf4
-  data.tar.gz: 1d7fe76b631564b4205dab9f928da9487e6db08cf93cee9b52a975b7cad65dddd07de97babd586851855c262f1428f902a3612185b9bc0fc7f3a4fa848c0024c
+  metadata.gz: a88686e4e9f129f7f51064c3cd35cffdb5547c256a19a6b8ec3214c430bcf421e8298981088bba09ffd1179fdddc6a115166e887e57f04c7291b9c7d1a38000f
+  data.tar.gz: 9ad2ce798f8793c9660c974c126729bc1d740194f976da41d2e5697de10a4001aa58671304b776c7634e6466efba86beb6ad9b8b9624c9a0f1a60ae25359ef5c

data/lib/generators/ruby_event_store/outbox/templates/create_event_store_outbox_template.rb

@@ -11,5 +11,13 @@ class CreateEventStoreOutbox < ActiveRecord::Migration<%= migration_version %>
     end
     add_index :event_store_outbox, [:format, :enqueued_at, :split_key], name: "index_event_store_outbox_for_pool"
     add_index :event_store_outbox, [:created_at, :enqueued_at], name: "index_event_store_outbox_for_clear"
+
+    create_table(:event_store_outbox_locks, force: false) do |t|
+      t.string :format, null: false
+      t.string :split_key, null: false
+      t.datetime :locked_at, null: true
+      t.string :locked_by, null: true, limit: 36
+    end
+    add_index :event_store_outbox_locks, [:format, :split_key], name: "index_event_store_outbox_locks_for_locking", unique: true
   end
 end

data/lib/ruby_event_store/outbox.rb

@@ -5,6 +5,7 @@ module RubyEventStore
   end
 end
 
+require_relative 'outbox/fetch_specification'
 require_relative 'outbox/record'
 require_relative 'outbox/sidekiq_scheduler'
 require_relative 'outbox/consumer'

data/lib/ruby_event_store/outbox/cli.rb

@@ -59,7 +59,8 @@ module RubyEventStore
       end
 
       def build_consumer(options)
-        logger = Logger.new(STDOUT, level: options.log_level, progname: "RES-Outbox")
+        consumer_uuid = SecureRandom.uuid
+        logger = Logger.new(STDOUT, level: options.log_level, progname: "RES-Outbox #{consumer_uuid}")
         consumer_configuration = Consumer::Configuration.new(
           split_keys: options.split_keys,
           message_format: options.message_format,
@@ -69,6 +70,7 @@ module RubyEventStore
         )
         metrics = Metrics.from_url(options.metrics_url)
         outbox_consumer = RubyEventStore::Outbox::Consumer.new(
+          consumer_uuid,
           options,
           logger: logger,
           metrics: metrics,

data/lib/ruby_event_store/outbox/consumer.rb

@@ -3,11 +3,14 @@ require "redis"
 require "active_record"
 require "ruby_event_store/outbox/record"
 require "ruby_event_store/outbox/sidekiq5_format"
+require "ruby_event_store/outbox/sidekiq_processor"
+require "ruby_event_store/outbox/fetch_specification"
 
 module RubyEventStore
   module Outbox
     class Consumer
       SLEEP_TIME_WHEN_NOTHING_TO_DO = 0.1
+      MAXIMUM_BATCH_FETCHES_IN_ONE_LOCK = 10
 
       class Configuration
         def initialize(
@@ -38,28 +41,26 @@ module RubyEventStore
         attr_reader :split_keys, :message_format, :batch_size, :database_url, :redis_url
       end
 
-      def initialize(configuration, clock: Time, logger:, metrics:)
+      def initialize(consumer_uuid, configuration, clock: Time, logger:, metrics:)
         @split_keys = configuration.split_keys
         @clock = clock
-        @redis = Redis.new(url: configuration.redis_url)
         @logger = logger
         @metrics = metrics
         @batch_size = configuration.batch_size
+        @consumer_uuid = consumer_uuid
         ActiveRecord::Base.establish_connection(configuration.database_url) unless ActiveRecord::Base.connected?
         if ActiveRecord::Base.connection.adapter_name == "Mysql2"
-          ActiveRecord::Base.connection.execute("SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED;")
           ActiveRecord::Base.connection.execute("SET SESSION innodb_lock_wait_timeout = 1;")
         end
 
         raise "Unknown format" if configuration.message_format != SIDEKIQ5_FORMAT
-        @message_format = SIDEKIQ5_FORMAT
+        @processor = SidekiqProcessor.new(Redis.new(url: configuration.redis_url))
 
         @gracefully_shutting_down = false
         prepare_traps
       end
 
       def init
-        @redis.sadd("queues", split_keys)
         logger.info("Initiated RubyEventStore::Outbox v#{VERSION}")
         logger.info("Handling split keys: #{split_keys ? split_keys.join(", ") : "(all of them)"}")
       end
@@ -76,51 +77,129 @@ module RubyEventStore
       end
 
       def one_loop
-        Record.transaction do
-          records_scope = Record.lock.where(format: message_format, enqueued_at: nil)
-          records_scope = records_scope.where(split_key: split_keys) if !split_keys.nil?
-          records = records_scope.order("id ASC").limit(batch_size).to_a
-          if records.empty?
-            metrics.write_point_queue(status: "ok")
-            return false
+        remaining_split_keys = @split_keys.dup
+
+        was_something_changed = false
+        while (split_key = remaining_split_keys.shift)
+          was_something_changed |= handle_split(FetchSpecification.new(processor.message_format, split_key))
+        end
+        was_something_changed
+      end
+
+      def handle_split(fetch_specification)
+        obtained_lock = obtain_lock_for_process(fetch_specification)
+        return false unless obtained_lock
+
+        something_processed = false
+
+        MAXIMUM_BATCH_FETCHES_IN_ONE_LOCK.times do
+          batch = retrieve_batch(fetch_specification)
+          if batch.empty?
+            break
           end
 
-          now = @clock.now.utc
           failed_record_ids = []
-          records.each do |record|
+          updated_record_ids = []
+          batch.each do |record|
             begin
-              handle_one_record(now, record)
+              now = @clock.now.utc
+              processor.process(record, now)
+
+              record.update_column(:enqueued_at, now)
+              something_processed |= true
+              updated_record_ids << record.id
             rescue => e
               failed_record_ids << record.id
               e.full_message.split($/).each {|line| logger.error(line) }
             end
           end
 
-          updated_record_ids = records.map(&:id) - failed_record_ids
-          Record.where(id: updated_record_ids).update_all(enqueued_at: now)
-          metrics.write_point_queue(status: "ok", enqueued: updated_record_ids.size, failed: failed_record_ids.size)
+          metrics.write_point_queue(
+            enqueued: updated_record_ids.size,
+            failed: failed_record_ids.size,
+            format: fetch_specification.message_format,
+            split_key: fetch_specification.split_key,
+            remaining: get_remaining_count(fetch_specification)
+          )
+
+          logger.info "Sent #{updated_record_ids.size} messages from outbox table"
 
-          logger.info "Sent #{records.size} messages from outbox table"
-          true
+          obtained_lock = refresh_lock_for_process(obtained_lock)
+          break unless obtained_lock
         end
-      rescue ActiveRecord::Deadlocked
-        logger.warn "Outbox fetch deadlocked"
-        metrics.write_point_queue(status: "deadlocked")
-        false
-      rescue ActiveRecord::LockWaitTimeout
-        logger.warn "Outbox fetch lock timeout"
-        metrics.write_point_queue(status: "lock_timeout")
-        false
+
+        metrics.write_point_queue(
+          format: fetch_specification.message_format,
+          split_key: fetch_specification.split_key,
+          remaining: get_remaining_count(fetch_specification)
+        ) unless something_processed
+
+        release_lock_for_process(fetch_specification)
+
+        processor.after_batch
+
+        something_processed
       end
 
       private
-      attr_reader :split_keys, :logger, :message_format, :batch_size, :metrics
+      attr_reader :split_keys, :logger, :batch_size, :metrics, :processor, :consumer_uuid
+
+      def obtain_lock_for_process(fetch_specification)
+        result = Lock.obtain(fetch_specification, consumer_uuid, clock: @clock)
+        case result
+        when :deadlocked
+          logger.warn "Obtaining lock for split_key '#{fetch_specification.split_key}' failed (deadlock)"
+          metrics.write_operation_result("obtain", "deadlocked")
+          return false
+        when :lock_timeout
+          logger.warn "Obtaining lock for split_key '#{fetch_specification.split_key}' failed (lock timeout)"
+          metrics.write_operation_result("obtain", "lock_timeout")
+          return false
+        when :taken
+          logger.debug "Obtaining lock for split_key '#{fetch_specification.split_key}' unsuccessful (taken)"
+          metrics.write_operation_result("obtain", "taken")
+          return false
+        else
+          return result
+        end
+      end
 
-      def handle_one_record(now, record)
-        hash_payload = JSON.parse(record.payload)
-        @redis.lpush("queue:#{hash_payload.fetch("queue")}", JSON.generate(JSON.parse(record.payload).merge({
-          "enqueued_at" => now.to_f,
-        })))
+      def release_lock_for_process(fetch_specification)
+        result = Lock.release(fetch_specification, consumer_uuid)
+        case result
+        when :ok
+        when :deadlocked
+          logger.warn "Releasing lock for split_key '#{fetch_specification.split_key}' failed (deadlock)"
+          metrics.write_operation_result("release", "deadlocked")
+        when :lock_timeout
+          logger.warn "Releasing lock for split_key '#{fetch_specification.split_key}' failed (lock timeout)"
+          metrics.write_operation_result("release", "lock_timeout")
+        when :not_taken_by_this_process
+          logger.debug "Releasing lock for split_key '#{fetch_specification.split_key}' failed (not taken by this process)"
+          metrics.write_operation_result("release", "not_taken_by_this_process")
+        else
+          raise "Unexpected result #{result}"
+        end
+      end
+
+      def refresh_lock_for_process(lock)
+        result = lock.refresh(clock: @clock)
+        case result
+        when :deadlocked
+          logger.warn "Refreshing lock for split_key '#{lock.split_key}' failed (deadlock)"
+          metrics.write_operation_result("refresh", "deadlocked")
+          return false
+        when :lock_timeout
+          logger.warn "Refreshing lock for split_key '#{lock.split_key}' failed (lock timeout)"
+          metrics.write_operation_result("refresh", "lock_timeout")
+          return false
+        when :stolen
+          logger.debug "Refreshing lock for split_key '#{lock.split_key}' unsuccessful (stolen)"
+          metrics.write_operation_result("refresh", "stolen")
+          return false
+        else
+          return result
+        end
       end
 
       def prepare_traps
@@ -135,6 +214,14 @@ module RubyEventStore
       def initiate_graceful_shutdown
         @gracefully_shutting_down = true
       end
+
+      def retrieve_batch(fetch_specification)
+        Record.remaining_for(fetch_specification).order("id ASC").limit(batch_size).to_a
+      end
+
+      def get_remaining_count(fetch_specification)
+        Record.remaining_for(fetch_specification).count
+      end
     end
   end
 end

data/lib/ruby_event_store/outbox/consumer_process.rb

@@ -0,0 +1,6 @@
+module RubyEventStore
+  module Outbox
+    class ConsumerProcess
+    end
+  end
+end

data/lib/ruby_event_store/outbox/fetch_specification.rb

@@ -0,0 +1,13 @@
+module RubyEventStore
+  module Outbox
+    class FetchSpecification
+      def initialize(message_format, split_key)
+        @message_format = message_format
+        @split_key = split_key
+        freeze
+      end
+
+      attr_reader :message_format, :split_key
+    end
+  end
+end

data/lib/ruby_event_store/outbox/metrics.rb

@@ -1,13 +1,12 @@
-require "ruby_event_store/outbox/metrics/null"
-require "ruby_event_store/outbox/metrics/influx"
-
 module RubyEventStore
   module Outbox
     module Metrics
       def self.from_url(metrics_url)
         if metrics_url.nil?
+          require "ruby_event_store/outbox/metrics/null"
           Null.new
         else
+          require "ruby_event_store/outbox/metrics/influx"
           Influx.new(metrics_url)
         end
       end

data/lib/ruby_event_store/outbox/metrics/influx.rb

@@ -17,14 +17,28 @@ module RubyEventStore
           @influxdb_client = InfluxDB::Client.new(**options)
         end
 
-        def write_point_queue(status:, enqueued: 0, failed: 0)
+        def write_operation_result(operation, result)
+          write_point("ruby_event_store.outbox.lock", {
+            values: {
+              value: 1,
+            },
+            tags: {
+              operation: operation,
+              result: result,
+            }
+          })
+        end
+
+        def write_point_queue(enqueued: 0, failed: 0, remaining: 0, format: nil, split_key: nil)
           write_point("ruby_event_store.outbox.queue", {
             values: {
               enqueued: enqueued,
               failed: failed,
+              remaining: remaining,
             },
             tags: {
-              status: status,
+              format: format,
+              split_key: split_key,
             }
           })
         end

data/lib/ruby_event_store/outbox/metrics/null.rb

@@ -2,6 +2,9 @@ module RubyEventStore
   module Outbox
     module Metrics
       class Null
+        def write_operation_result(operation, result)
+        end
+
         def write_point_queue(**kwargs)
         end
       end

data/lib/ruby_event_store/outbox/record.rb

@@ -8,9 +8,96 @@ module RubyEventStore
       self.primary_key = :id
       self.table_name = 'event_store_outbox'
 
+      def self.remaining_for(fetch_specification)
+        where(format: fetch_specification.message_format, split_key: fetch_specification.split_key, enqueued_at: nil)
+      end
+
       def hash_payload
         JSON.parse(payload).deep_symbolize_keys
       end
+
+      def enqueued?
+        !enqueued_at.nil?
+      end
+    end
+
+    class Lock < ::ActiveRecord::Base
+      self.table_name = 'event_store_outbox_locks'
+
+      def self.obtain(fetch_specification, process_uuid, clock:)
+        l = nil
+        transaction do
+          l = get_lock_record(fetch_specification)
+
+          return :taken if l.recently_locked?
+
+          l.update!(
+            locked_by: process_uuid,
+            locked_at: clock.now,
+          )
+        end
+        l
+      rescue ActiveRecord::Deadlocked
+        :deadlocked
+      rescue ActiveRecord::LockWaitTimeout
+        :lock_timeout
+      end
+
+      def refresh(clock:)
+        transaction do
+          current_process_uuid = locked_by
+          lock!
+          if locked_by == current_process_uuid
+            update!(locked_at: clock.now)
+            return self
+          else
+            return :stolen
+          end
+        end
+      rescue ActiveRecord::Deadlocked
+        :deadlocked
+      rescue ActiveRecord::LockWaitTimeout
+        :lock_timeout
+      end
+
+      def self.release(fetch_specification, process_uuid)
+        transaction do
+          l = get_lock_record(fetch_specification)
+          return :not_taken_by_this_process if !l.locked_by?(process_uuid)
+
+          l.update!(locked_by: nil, locked_at: nil)
+        end
+        :ok
+      rescue ActiveRecord::Deadlocked
+        :deadlocked
+      rescue ActiveRecord::LockWaitTimeout
+        :lock_timeout
+      end
+
+      def locked_by?(process_uuid)
+        locked_by.eql?(process_uuid)
+      end
+
+      def recently_locked?
+        locked_by && locked_at > 10.minutes.ago
+      end
+
+      private
+      def self.lock_for_split_key(fetch_specification)
+        lock.find_by(format: fetch_specification.message_format, split_key: fetch_specification.split_key)
+      end
+
+      def self.get_lock_record(fetch_specification)
+        l = lock_for_split_key(fetch_specification)
+        if l.nil?
+          begin
+            l = create!(format: fetch_specification.message_format, split_key: fetch_specification.split_key)
+          rescue ActiveRecord::RecordNotUnique
+            l = lock_for_split_key(fetch_specification)
+          end
+        end
+        l
+      end
     end
   end
 end

data/lib/ruby_event_store/outbox/sidekiq_processor.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "ruby_event_store/outbox/sidekiq5_format"
+
+module RubyEventStore
+  module Outbox
+    class SidekiqProcessor
+      InvalidPayload = Class.new(StandardError)
+
+      def initialize(redis)
+        @redis = redis
+        @recently_used_queues = Set.new
+      end
+
+      def process(record, now)
+        parsed_record = JSON.parse(record.payload)
+
+        queue = parsed_record["queue"]
+        raise InvalidPayload.new("Missing queue") if queue.nil? || queue.empty?
+        payload = JSON.generate(parsed_record.merge({
+          "enqueued_at" => now.to_f,
+        }))
+
+        redis.lpush("queue:#{queue}", payload)
+
+        @recently_used_queues << queue
+      end
+
+      def after_batch
+        if !@recently_used_queues.empty?
+          redis.sadd("queues", @recently_used_queues.to_a)
+          @recently_used_queues.clear
+        end
+      end
+
+      def message_format
+        SIDEKIQ5_FORMAT
+      end
+
+      private
+      attr_reader :redis
+    end
+  end
+end

data/lib/ruby_event_store/outbox/sidekiq_producer.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'sidekiq'
+require "ruby_event_store/outbox/sidekiq5_format"
+
+module RubyEventStore
+  module Outbox
+    class SidekiqProducer
+      def call(klass, args)
+        sidekiq_client = Sidekiq::Client.new(Sidekiq.redis_pool)
+        item = {
+          'class' => klass,
+          'args' => args,
+        }
+        normalized_item = sidekiq_client.__send__(:normalize_item, item)
+        payload = sidekiq_client.__send__(:process_single, normalized_item.fetch('class'), normalized_item)
+        if payload
+          Record.create!(
+            format: SIDEKIQ5_FORMAT,
+            split_key: payload.fetch('queue'),
+            payload: payload.to_json
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ruby_event_store/outbox/sidekiq_scheduler.rb

@@ -1,31 +1,24 @@
 # frozen_string_literal: true
 
-require 'sidekiq'
-require "ruby_event_store/outbox/sidekiq5_format"
+require "ruby_event_store/outbox/sidekiq_producer"
 
 module RubyEventStore
   module Outbox
     class SidekiqScheduler
+      def initialize
+        @sidekiq_producer = SidekiqProducer.new
+      end
+
       def call(klass, serialized_event)
-        sidekiq_client = Sidekiq::Client.new(Sidekiq.redis_pool)
-        item = {
-          'class' => klass,
-          'args' => [serialized_event.to_h],
-        }
-        normalized_item = sidekiq_client.__send__(:normalize_item, item)
-        payload = sidekiq_client.__send__(:process_single, normalized_item.fetch('class'), normalized_item)
-        if payload
-          Record.create!(
-            format: SIDEKIQ5_FORMAT,
-            split_key: payload.fetch('queue'),
-            payload: payload.to_json
-          )
-        end
+        sidekiq_producer.call(klass, [serialized_event.to_h])
       end
 
       def verify(subscriber)
         Class === subscriber && subscriber.respond_to?(:through_outbox?) && subscriber.through_outbox?
       end
+
+      private
+      attr_reader :sidekiq_producer
     end
   end
 end

data/lib/ruby_event_store/outbox/version.rb

@@ -2,6 +2,6 @@
 
 module RubyEventStore
   module Outbox
-    VERSION = "0.0.9"
+    VERSION = "0.0.14"
   end
 end

metadata

@@ -1,27 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: ruby_event_store-outbox
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.0.14
 platform: ruby
 authors:
 - Arkency
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-26 00:00:00.000000000 Z
+date: 2020-08-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby_event_store
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.0
 - !ruby/object:Gem::Dependency
@@ -38,20 +38,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: influxdb
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.8.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.8.0
 description: 
 email:
 - dev@arkency.com
@@ -67,12 +53,16 @@ files:
 - lib/ruby_event_store/outbox.rb
 - lib/ruby_event_store/outbox/cli.rb
 - lib/ruby_event_store/outbox/consumer.rb
+- lib/ruby_event_store/outbox/consumer_process.rb
+- lib/ruby_event_store/outbox/fetch_specification.rb
 - lib/ruby_event_store/outbox/metrics.rb
 - lib/ruby_event_store/outbox/metrics/influx.rb
 - lib/ruby_event_store/outbox/metrics/null.rb
 - lib/ruby_event_store/outbox/record.rb
 - lib/ruby_event_store/outbox/sidekiq5_format.rb
 - lib/ruby_event_store/outbox/sidekiq_message_handler.rb
+- lib/ruby_event_store/outbox/sidekiq_processor.rb
+- lib/ruby_event_store/outbox/sidekiq_producer.rb
 - lib/ruby_event_store/outbox/sidekiq_scheduler.rb
 - lib/ruby_event_store/outbox/version.rb
 homepage: https://railseventstore.org