require "concurrent" require "concurrent/atomics" require "concurrent/executors" require "thread" require "time" # # Analytics event processing in the SDK involves several components. The purpose of this design is to # minimize overhead on the application threads that are generating analytics events. # # EventProcessor receives an analytics event from the SDK client, on an application thread. It places # the event in a bounded queue, the "inbox", and immediately returns. # # On a separate worker thread, EventDispatcher consumes events from the inbox. These are considered # "input events" because they may or may not actually be sent to LaunchDarkly; most flag evaluation # events are not sent, but are counted and the counters become part of a single summary event. # EventDispatcher updates those counters, creates "index" events for any users that have not been seen # recently, and places any events that will be sent to LaunchDarkly into the "outbox" queue. # # When it is time to flush events to LaunchDarkly, the contents of the outbox are handed off to # another worker thread which sends the HTTP request. # module LaunchDarkly MAX_FLUSH_WORKERS = 5 CURRENT_SCHEMA_VERSION = 3 USER_ATTRS_TO_STRINGIFY_FOR_EVENTS = [ :key, :secondary, :ip, :country, :email, :firstName, :lastName, :avatar, :name ] private_constant :MAX_FLUSH_WORKERS private_constant :CURRENT_SCHEMA_VERSION private_constant :USER_ATTRS_TO_STRINGIFY_FOR_EVENTS # @private class NullEventProcessor def add_event(event) end def flush end def stop end end # @private class EventMessage def initialize(event) @event = event end attr_reader :event end # @private class FlushMessage end # @private class FlushUsersMessage end # @private class SynchronousMessage def initialize @reply = Concurrent::Semaphore.new(0) end def completed @reply.release end def wait_for_completion @reply.acquire end end # @private class TestSyncMessage < SynchronousMessage end # @private class StopMessage < SynchronousMessage end # @private class EventProcessor def initialize(sdk_key, config, client = nil) @logger = config.logger @inbox = SizedQueue.new(config.capacity) @flush_task = Concurrent::TimerTask.new(execution_interval: config.flush_interval) do post_to_inbox(FlushMessage.new) end @flush_task.execute @users_flush_task = Concurrent::TimerTask.new(execution_interval: config.user_keys_flush_interval) do post_to_inbox(FlushUsersMessage.new) end @users_flush_task.execute @stopped = Concurrent::AtomicBoolean.new(false) @inbox_full = Concurrent::AtomicBoolean.new(false) EventDispatcher.new(@inbox, sdk_key, config, client) end def add_event(event) event[:creationDate] = (Time.now.to_f * 1000).to_i post_to_inbox(EventMessage.new(event)) end def flush # flush is done asynchronously post_to_inbox(FlushMessage.new) end def stop # final shutdown, which includes a final flush, is done synchronously if @stopped.make_true @flush_task.shutdown @users_flush_task.shutdown # Note that here we are not calling post_to_inbox, because we *do* want to wait if the inbox # is full; an orderly shutdown can't happen unless these messages are received. @inbox << FlushMessage.new stop_msg = StopMessage.new @inbox << stop_msg stop_msg.wait_for_completion end end # exposed only for testing def wait_until_inactive sync_msg = TestSyncMessage.new @inbox << sync_msg sync_msg.wait_for_completion end private def post_to_inbox(message) begin @inbox.push(message, non_block=true) rescue ThreadError # If the inbox is full, it means the EventDispatcher thread is seriously backed up with not-yet-processed # events. This is unlikely, but if it happens, it means the application is probably doing a ton of flag # evaluations across many threads-- so if we wait for a space in the inbox, we risk a very serious slowdown # of the app. To avoid that, we'll just drop the event. The log warning about this will only be shown once. if @inbox_full.make_true @logger.warn { "[LDClient] Events are being produced faster than they can be processed; some events will be dropped" } end end end end # @private class EventDispatcher def initialize(inbox, sdk_key, config, client) @sdk_key = sdk_key @config = config if client @client = client else @client = Util.new_http_client(@config.events_uri, @config) end @user_keys = SimpleLRUCacheSet.new(config.user_keys_capacity) @formatter = EventOutputFormatter.new(config) @disabled = Concurrent::AtomicBoolean.new(false) @last_known_past_time = Concurrent::AtomicReference.new(0) outbox = EventBuffer.new(config.capacity, config.logger) flush_workers = NonBlockingThreadPool.new(MAX_FLUSH_WORKERS) Thread.new { main_loop(inbox, outbox, flush_workers) } end private def now_millis() (Time.now.to_f * 1000).to_i end def main_loop(inbox, outbox, flush_workers) running = true while running do begin message = inbox.pop case message when EventMessage dispatch_event(message.event, outbox) when FlushMessage trigger_flush(outbox, flush_workers) when FlushUsersMessage @user_keys.clear when TestSyncMessage synchronize_for_testing(flush_workers) message.completed when StopMessage do_shutdown(flush_workers) running = false message.completed end rescue => e Util.log_exception(@config.logger, "Unexpected error in event processor", e) end end end def do_shutdown(flush_workers) flush_workers.shutdown flush_workers.wait_for_termination begin @client.finish rescue end end def synchronize_for_testing(flush_workers) # Used only by unit tests. Wait until all active flush workers have finished. flush_workers.wait_all end def dispatch_event(event, outbox) return if @disabled.value # Always record the event in the summary. outbox.add_to_summary(event) # Decide whether to add the event to the payload. Feature events may be added twice, once for # the event (if tracked) and once for debugging. will_add_full_event = false debug_event = nil if event[:kind] == "feature" will_add_full_event = event[:trackEvents] if should_debug_event(event) debug_event = event.clone debug_event[:debug] = true end else will_add_full_event = true end # For each user we haven't seen before, we add an index event - unless this is already # an identify event for that user. if !(will_add_full_event && @config.inline_users_in_events) if event.has_key?(:user) && !notice_user(event[:user]) && event[:kind] != "identify" outbox.add_event({ kind: "index", creationDate: event[:creationDate], user: event[:user] }) end end outbox.add_event(event) if will_add_full_event outbox.add_event(debug_event) if !debug_event.nil? end # Add to the set of users we've noticed, and return true if the user was already known to us. def notice_user(user) if user.nil? || !user.has_key?(:key) true else @user_keys.add(user[:key].to_s) end end def should_debug_event(event) debug_until = event[:debugEventsUntilDate] if !debug_until.nil? last_past = @last_known_past_time.value debug_until > last_past && debug_until > now_millis else false end end def trigger_flush(outbox, flush_workers) if @disabled.value return end payload = outbox.get_payload if !payload.events.empty? || !payload.summary.counters.empty? # If all available worker threads are busy, success will be false and no job will be queued. success = flush_workers.post do begin resp = EventPayloadSendTask.new.run(@sdk_key, @config, @client, payload, @formatter) handle_response(resp) if !resp.nil? rescue => e Util.log_exception(@config.logger, "Unexpected error in event processor", e) end end outbox.clear if success # Reset our internal state, these events now belong to the flush worker end end def handle_response(res) status = res.code.to_i if status >= 400 message = Util.http_error_message(status, "event delivery", "some events were dropped") @config.logger.error { "[LDClient] #{message}" } if !Util.http_error_recoverable?(status) @disabled.value = true end else if !res["date"].nil? begin res_time = (Time.httpdate(res["date"]).to_f * 1000).to_i @last_known_past_time.value = res_time rescue ArgumentError end end end end end # @private FlushPayload = Struct.new(:events, :summary) # @private class EventBuffer def initialize(capacity, logger) @capacity = capacity @logger = logger @capacity_exceeded = false @events = [] @summarizer = EventSummarizer.new end def add_event(event) if @events.length < @capacity @logger.debug { "[LDClient] Enqueueing event: #{event.to_json}" } @events.push(event) @capacity_exceeded = false else if !@capacity_exceeded @capacity_exceeded = true @logger.warn { "[LDClient] Exceeded event queue capacity. Increase capacity to avoid dropping events." } end end end def add_to_summary(event) @summarizer.summarize_event(event) end def get_payload return FlushPayload.new(@events, @summarizer.snapshot) end def clear @events = [] @summarizer.clear end end # @private class EventPayloadSendTask def run(sdk_key, config, client, payload, formatter) events_out = formatter.make_output_events(payload.events, payload.summary) res = nil body = events_out.to_json (0..1).each do |attempt| if attempt > 0 config.logger.warn { "[LDClient] Will retry posting events after 1 second" } sleep(1) end begin client.start if !client.started? config.logger.debug { "[LDClient] sending #{events_out.length} events: #{body}" } uri = URI(config.events_uri + "/bulk") req = Net::HTTP::Post.new(uri) req.content_type = "application/json" req.body = body req["Authorization"] = sdk_key req["User-Agent"] = "RubyClient/" + LaunchDarkly::VERSION req["X-LaunchDarkly-Event-Schema"] = CURRENT_SCHEMA_VERSION.to_s req["Connection"] = "keep-alive" res = client.request(req) rescue StandardError => exn config.logger.warn { "[LDClient] Error flushing events: #{exn.inspect}." } next end status = res.code.to_i if status < 200 || status >= 300 if Util.http_error_recoverable?(status) next end end break end # used up our retries, return the last response if any res end end # @private class EventOutputFormatter def initialize(config) @inline_users = config.inline_users_in_events @user_filter = UserFilter.new(config) end # Transforms events into the format used for event sending. def make_output_events(events, summary) events_out = events.map { |e| make_output_event(e) } if !summary.counters.empty? events_out.push(make_summary_event(summary)) end events_out end private def process_user(event) filtered = @user_filter.transform_user_props(event[:user]) Util.stringify_attrs(filtered, USER_ATTRS_TO_STRINGIFY_FOR_EVENTS) end def make_output_event(event) case event[:kind] when "feature" is_debug = event[:debug] out = { kind: is_debug ? "debug" : "feature", creationDate: event[:creationDate], key: event[:key], value: event[:value] } out[:default] = event[:default] if event.has_key?(:default) out[:variation] = event[:variation] if event.has_key?(:variation) out[:version] = event[:version] if event.has_key?(:version) out[:prereqOf] = event[:prereqOf] if event.has_key?(:prereqOf) if @inline_users || is_debug out[:user] = process_user(event) else out[:userKey] = event[:user].nil? ? nil : event[:user][:key] end out[:reason] = event[:reason] if !event[:reason].nil? out when "identify" { kind: "identify", creationDate: event[:creationDate], key: event[:user].nil? ? nil : event[:user][:key].to_s, user: process_user(event) } when "custom" out = { kind: "custom", creationDate: event[:creationDate], key: event[:key] } out[:data] = event[:data] if event.has_key?(:data) if @inline_users out[:user] = process_user(event) else out[:userKey] = event[:user].nil? ? nil : event[:user][:key] end out when "index" { kind: "index", creationDate: event[:creationDate], user: process_user(event) } else event end end # Transforms the summary data into the format used for event sending. def make_summary_event(summary) flags = {} summary[:counters].each { |ckey, cval| flag = flags[ckey[:key]] if flag.nil? flag = { default: cval[:default], counters: [] } flags[ckey[:key]] = flag end c = { value: cval[:value], count: cval[:count] } if !ckey[:variation].nil? c[:variation] = ckey[:variation] end if ckey[:version].nil? c[:unknown] = true else c[:version] = ckey[:version] end flag[:counters].push(c) } { kind: "summary", startDate: summary[:start_date], endDate: summary[:end_date], features: flags } end end end