splitclient-rb 1.0.2.wip → 8.11.1.pre.rc1-java

data/lib/splitclient-rb/split_config.rb

@@ -12,77 +12,369 @@ module SplitIoClient
     #
     # @param opts [Hash] optional hash with configuration options
     # @option opts [String] :base_uri ("https://sdk.split.io/api/") The base URL for split API end points
+    # @option opts [String] :events_uri ("https://events.split.io/api/") The events URL for events end points
     # @option opts [Int] :read_timeout (10) The read timeout for network connections in seconds.
     # @option opts [Int] :connection_timeout (2) The connect timeout for network connections in seconds.
-    # @option opts [Object] :local_store A cache store for the Faraday HTTP caching library. Defaults to the Rails cache in a Rails environment, or a thread-safe in-memory store otherwise.
     # @option opts [Int] :features_refresh_rate The SDK polls Split servers for changes to feature roll-out plans. This parameter controls this polling period in seconds.
     # @option opts [Int] :segments_refresh_rate
-    # @option opts [Int] :metrics_refresh_rate
     # @option opts [Int] :impressions_refresh_rate
     # @option opts [Object] :logger a logger to user for messages from the client. Defaults to stdout
     # @option opts [Boolean] :debug_enabled (false) The value for the debug flag
-    #
+    # @option opts [Int] :impressions_queue_size Size of the impressions queue in the memory repository. Once reached, newer impressions will be dropped
+    # @option opts [Int] :impressions_bulk_size Max number of impressions to be sent to the backend on each post
+    # @option opts [#log] :impression_listener this object will capture all impressions and process them through `#log`
+    # @option opts [Int] :cache_ttl Time to live in seconds for the memory cache values when using Redis.
+    # @option opts [Int] :max_cache_size Max number of items to be held in the memory cache before prunning when using Redis.
     # @return [type] SplitConfig with configuration options
     def initialize(opts = {})
       @base_uri = (opts[:base_uri] || SplitConfig.default_base_uri).chomp('/')
-      @local_store = opts[:local_store] || SplitConfig.default_local_store
+      @events_uri = (opts[:events_uri] || SplitConfig.default_events_uri).chomp('/')
+      @mode = opts[:mode] || SplitConfig.default_mode
+      @redis_url = opts[:redis_url] || SplitConfig.default_redis_url
+      @redis_namespace = opts[:redis_namespace] && opts[:redis_namespace].to_s.length > 0 ? "#{opts[:redis_namespace]}.#{SplitConfig.default_redis_namespace}" : SplitConfig.default_redis_namespace
+      @cache_adapter = SplitConfig.init_cache_adapter(
+        opts[:cache_adapter] || SplitConfig.default_cache_adapter, :map_adapter, nil, @redis_url
+      )
       @connection_timeout = opts[:connection_timeout] || SplitConfig.default_connection_timeout
       @read_timeout = opts[:read_timeout] || SplitConfig.default_read_timeout
-      @features_refresh_rate = opts[:features_refresh_rate] || SplitConfig.default_features_refresh_rate
-      @segments_refresh_rate = opts[:segments_refresh_rate] || SplitConfig.default_segments_refresh_rate
-      @metrics_refresh_rate = opts[:metrics_refresh_rate] || SplitConfig.default_metrics_refresh_rate
-      @impressions_refresh_rate = opts[:impressions_refresh_rate] || SplitConfig.default_impressions_refresh_rate
+
       @logger = opts[:logger] || SplitConfig.default_logger
+
+      if(opts[:reload_rate])
+        @features_refresh_rate = opts[:reload_rate]
+        @logger.warn('Localhost mode: reload_rate will be deprecated soon in favor of ' \
+          'features_refresh_rate. Take a look in our documentation.'
+        )
+      else
+        @features_refresh_rate = opts[:features_refresh_rate] || SplitConfig.default_features_refresh_rate
+      end
+
+      @segments_refresh_rate = opts[:segments_refresh_rate] || SplitConfig.default_segments_refresh_rate
+
+      @impressions_mode = init_impressions_mode(opts[:impressions_mode], opts[:cache_adapter])
+
+      @impressions_refresh_rate = SplitConfig.init_impressions_refresh_rate(@impressions_mode, opts[:impressions_refresh_rate], SplitConfig.default_impressions_refresh_rate)
+      @impressions_queue_size = opts[:impressions_queue_size] || SplitConfig.default_impressions_queue_size
+      @impressions_adapter = SplitConfig.init_cache_adapter(
+        opts[:cache_adapter] || SplitConfig.default_cache_adapter, :queue_adapter, @impressions_queue_size, @redis_url
+      )
+      #Safeguard for users of older SDK versions.
+      @impressions_bulk_size = opts[:impressions_bulk_size] || @impressions_queue_size > 0 ? @impressions_queue_size : 0
+
       @debug_enabled = opts[:debug_enabled] || SplitConfig.default_debug
-      @machine_name = SplitConfig.get_hostname
-      @machine_ip = SplitConfig.get_ip
+      @transport_debug_enabled = opts[:transport_debug_enabled] || SplitConfig.default_debug
+      @block_until_ready = SplitConfig.default_block_until_ready
+
+      @ip_addresses_enabled = opts[:ip_addresses_enabled].nil? ? SplitConfig.default_ip_addresses_enabled : opts[:ip_addresses_enabled]
+
+      @machine_name = SplitConfig.machine_hostname(@ip_addresses_enabled, opts[:machine_name], opts[:cache_adapter] || SplitConfig.default_cache_adapter)
+      @machine_ip = SplitConfig.machine_ip(@ip_addresses_enabled, opts[:machine_ip], opts[:cache_adapter] || SplitConfig.default_cache_adapter)
+
+      @cache_ttl = opts[:cache_ttl] || SplitConfig.cache_ttl
+      @max_cache_size = opts[:max_cache_size] || SplitConfig.max_cache_size
+
+      @language = opts[:language] || 'ruby'
+      @version = opts[:version] || SplitIoClient::VERSION
+
+      @labels_enabled = opts[:labels_enabled].nil? ? SplitConfig.default_labels_logging : opts[:labels_enabled]
+
+      @impression_listener = opts[:impression_listener]
+      @impression_listener_refresh_rate = opts[:impression_listener_refresh_rate] || SplitConfig.default_impression_listener_refresh_rate
+
+      @max_key_size = SplitConfig.max_key_size
+
+      @threads = {}
+
+      @events_push_rate = opts[:events_push_rate] || SplitConfig.default_events_push_rate
+      @events_queue_size = opts[:events_queue_size] || SplitConfig.default_events_queue_size
+      @events_adapter = SplitConfig.init_cache_adapter(
+        opts[:cache_adapter] || SplitConfig.default_cache_adapter, :queue_adapter, @events_queue_size, @redis_url
+      )
+
+      @telemetry_adapter = SplitConfig.init_telemetry_adapter(
+        opts[:cache_adapter] || SplitConfig.default_cache_adapter, @redis_url
+      )
+
+      @split_file = opts[:split_file] || SplitConfig.default_split_file
+
+      @valid_mode = true
+      @split_logger = SplitIoClient::SplitLogger.new(self)
+      @split_validator = SplitIoClient::Validators.new(self)
+      @localhost_mode = opts[:localhost_mode]
+
+      @streaming_enabled = consumer? ? false : (opts[:streaming_enabled].nil? ? SplitConfig.default_streaming_enabled : opts[:streaming_enabled])
+      @streaming_service_url = opts[:streaming_service_url] || SplitConfig.default_streaming_service_url
+      @auth_service_url = opts[:auth_service_url] || SplitConfig.default_auth_service_url
+      @auth_retry_back_off_base = SplitConfig.init_auth_retry_back_off(opts[:auth_retry_back_off_base] || SplitConfig.default_auth_retry_back_off_base)
+      @streaming_reconnect_back_off_base = SplitConfig.init_streaming_reconnect_back_off(opts[:streaming_reconnect_back_off_base] || SplitConfig.default_streaming_reconnect_back_off_base)
+
+      @telemetry_refresh_rate = SplitConfig.init_telemetry_refresh_rate(opts[:telemetry_refresh_rate])
+      @telemetry_service_url = opts[:telemetry_service_url] || SplitConfig.default_telemetry_service_url
+
+      @unique_keys_refresh_rate = SplitConfig.default_unique_keys_refresh_rate(@cache_adapter)
+      # @unique_keys_cache_max_size = SplitConfig.default_unique_keys_cache_max_size
+      @unique_keys_bulk_size = SplitConfig.default_unique_keys_bulk_size(@cache_adapter)
+
+      @counter_refresh_rate = SplitConfig.default_counter_refresh_rate(@cache_adapter)
+
+      @sdk_start_time = Time.now.to_f
+
+      @on_demand_fetch_retry_delay_seconds = SplitConfig.default_on_demand_fetch_retry_delay_seconds
+      @on_demand_fetch_max_retries = SplitConfig.default_on_demand_fetch_max_retries
+
+      @flag_sets_filter = SplitConfig.sanitize_flag_set_filter(opts[:flag_sets_filter], @split_validator, opts[:cache_adapter], @logger)
+
+      @fallback_treatments_configuration = SplitConfig.sanitize_fallback_config(opts[:fallback_treatments], @split_validator, @logger)
+      startup_log
     end
 
     #
     # The base URL for split API end points
     #
     # @return [String] The configured base URL for the split API end points
-    attr_reader :base_uri
+    attr_accessor :base_uri
 
     #
-    # The store for the Faraday HTTP caching library. Stores should respond to
-    # 'read', 'write' and 'delete' requests.
+    # The base URL for split events API end points
     #
-    # @return [Object] The configured store for the Faraday HTTP caching library.
-    attr_reader :local_store
+    # @return [String] The configured URL for the events API end points
+    attr_accessor :events_uri
 
     #
+    # The mode SDK will run
+    #
+    # @return [Symbol] One of the available SDK modes: standalone, consumer
+    attr_accessor :mode
+
     # The read timeout for network connections in seconds.
     #
     # @return [Int] The timeout in seconds.
-    attr_reader :read_timeout
+    attr_accessor :read_timeout
+
+    #
+    # The cache adapter to store splits/segments in
+    #
+    # @return [Object] Cache adapter instance
+    attr_accessor :cache_adapter
+
+    #
+    # The cache adapter to store impressions in
+    #
+    # @return [Object] Impressions adapter instance
+    attr_accessor :impressions_adapter
+
+    #
+    # The cache adapter to store events in
+    #
+    # @return [Object] Metrics adapter
+    attr_accessor :events_adapter
 
     #
     # The connection timeout for network connections in seconds.
     #
     # @return [Int] The connect timeout in seconds.
-    attr_reader :connection_timeout
+    attr_accessor :connection_timeout
 
     #
     # The configured logger. The client library uses the log to
     # print warning and error messages.
     #
     # @return [Logger] The configured logger
-    attr_reader :logger
+    attr_accessor :logger
+
+    #
+    # The split logger. The client library uses the split logger
+    # to use common functions around the logger
+    #
+    # @return [SplitLogger] The configured logger
+    attr_accessor :split_logger
+
+    #
+    # The split validator. The client library uses the split validator
+    # to validate inputs accross the sdk
+    #
+    # @return [SplitValidator] The validator
+    attr_accessor :split_validator
 
     #
     # The boolean that represents the state of the debug log level
     #
     # @return [Boolean] The value for the debug flag
-    attr_reader :debug_enabled
+    attr_accessor :debug_enabled
+
+    #
+    # Enable to log the content retrieved from endpoints
+    #
+    # @return [Boolean] The value for the debug flag
+    attr_accessor :transport_debug_enabled
+
+    #
+    # Enable logging labels and sending potentially sensitive information
+    #
+    # @return [Boolean] The value for the labels enabled flag
+    attr_accessor :labels_enabled
+
+    #
+    # The number of seconds to wait for SDK readiness
+    # or false to disable waiting
+    # @return [Integer]/[FalseClass]
+    attr_accessor :block_until_ready
+
+    attr_accessor :machine_ip
+    attr_accessor :machine_name
+
+    attr_accessor :cache_ttl
+    attr_accessor :max_cache_size
 
-    attr_reader :machine_ip
-    attr_reader :machine_name
+    attr_accessor :max_key_size
 
-    attr_reader :features_refresh_rate
-    attr_reader :segments_refresh_rate
-    attr_reader :metrics_refresh_rate
-    attr_reader :impressions_refresh_rate
+    attr_accessor :language
+    attr_accessor :version
+
+    attr_accessor :features_refresh_rate
+    attr_accessor :segments_refresh_rate
+    attr_accessor :impressions_refresh_rate
+
+    attr_accessor :impression_listener
+    attr_accessor :impression_listener_refresh_rate
+
+    #
+    # How big the impressions queue is before dropping impressions
+    #
+    # @return [Integer]
+    attr_accessor :impressions_queue_size
+    attr_accessor :impressions_bulk_size
+
+    attr_accessor :redis_url
+    attr_accessor :redis_namespace
+
+    attr_accessor :threads
+
+    attr_accessor :valid_mode
+
+    #
+    # The schedule time for events flush after the first one
+    #
+    # @return [Integer]
+    attr_accessor :events_push_rate
+
+    #
+    # The max size of the events queue
+    #
+    # @return [Integer]
+    attr_accessor :events_queue_size
+
+    attr_accessor :split_file
+
+    attr_accessor :localhost_mode
+
+    attr_accessor :ip_addresses_enabled
+
+    attr_accessor :auth_service_url
+
+    attr_accessor :auth_retry_back_off_base
+
+    attr_accessor :streaming_service_url
+
+    attr_accessor :streaming_reconnect_back_off_base
+
+    attr_accessor :streaming_enabled
+
+    attr_accessor :impressions_mode
+
+    attr_accessor :telemetry_adapter
+
+    attr_accessor :telemetry_refresh_rate
+
+    attr_accessor :telemetry_service_url
+
+    attr_accessor :sdk_start_time
+
+    attr_accessor :on_demand_fetch_retry_delay_seconds
+    attr_accessor :on_demand_fetch_max_retries
+
+    attr_accessor :unique_keys_refresh_rate
+    #attr_accessor :unique_keys_cache_max_size
+    attr_accessor :unique_keys_bulk_size
+
+    attr_accessor :counter_refresh_rate
+
+    #
+    # Flagsets filter
+    #
+    # @return [Array]
+    attr_accessor :flag_sets_filter
+
+    attr_accessor :fallback_treatments_configuration
+
+    def self.default_counter_refresh_rate(adapter)
+      return 300 if adapter == :redis # Send bulk impressions count - Refresh rate: 5 min.
+
+      1800 # Send bulk impressions count - Refresh rate: 30 min.
+    end
+
+    def self.default_on_demand_fetch_retry_delay_seconds
+      0.05
+    end
+
+    def self.default_on_demand_fetch_max_retries
+      10
+    end
+
+    def init_impressions_mode(impressions_mode, adapter)
+      case impressions_mode
+      when :optimized
+        return :optimized
+      when :none
+       return :none
+      when :debug
+        return :debug
+      else
+        default = adapter == :redis ? :debug : :optimized
+        @logger.error("You passed an invalid impressions_mode, impressions_mode should be one of the following values: :debug, :optimized or :none. Defaulting to #{default} mode") unless impressions_mode.nil?
+        return default
+      end
+    end
+
+    def self.init_impressions_refresh_rate(impressions_mode, refresh_rate, default_rate)
+      return (refresh_rate.nil? || refresh_rate <= 0 ? default_rate : refresh_rate) if impressions_mode == :debug
+
+      return refresh_rate.nil? || refresh_rate <= 0 ? SplitConfig.default_impressions_refresh_rate_optimized : [default_rate, refresh_rate].max
+    end
+
+    def self.init_telemetry_refresh_rate(refresh_rate)
+      return SplitConfig.default_telemetry_refresh_rate if refresh_rate.nil? || refresh_rate < 60
+
+      refresh_rate
+    end
+
+    def self.default_streaming_enabled
+      true
+    end
+
+    def self.default_streaming_service_url
+      'https://streaming.split.io/event-stream'
+    end
+
+    def self.default_auth_service_url
+      'https://auth.split.io/api/v2/auth'
+    end
+
+    def self.default_auth_retry_back_off_base
+      1
+    end
+
+    def self.default_streaming_reconnect_back_off_base
+      1
+    end
+
+    def self.init_auth_retry_back_off(auth_retry_back_off)
+      auth_retry_back_off < 1 ? SplitConfig.default_auth_retry_back_off_base : auth_retry_back_off
+    end
+
+    def self.init_streaming_reconnect_back_off(streaming_reconnect_back_off)
+      streaming_reconnect_back_off < 1 ? SplitConfig.default_streaming_reconnect_back_off_base : streaming_reconnect_back_off
+    end
 
     #
     # The default split client configuration
@@ -100,9 +392,56 @@ module SplitIoClient
       'https://sdk.split.io/api/'
     end
 
+    def self.default_events_uri
+      'https://events.split.io/api/'
+    end
+
+    def self.init_cache_adapter(adapter, data_structure, queue_size = nil, redis_url = nil)
+      case adapter
+      when :memory
+        SplitIoClient::Cache::Adapters::MemoryAdapter.new(map_memory_adapter(data_structure, queue_size))
+      when :redis
+        begin
+          require 'redis'
+        rescue LoadError
+          fail StandardError, 'To use Redis as a cache adapter you must include it in your Gemfile'
+        end
+
+        SplitIoClient::Cache::Adapters::RedisAdapter.new(redis_url)
+      end
+    end
+
+    def self.init_telemetry_adapter(adapter, redis_url)
+      case adapter
+      when :memory
+        Telemetry::Storages::Memory.new
+      when :redis
+        begin
+          require 'redis'
+        rescue LoadError
+          fail StandardError, 'To use Redis as a cache adapter you must include it in your Gemfile'
+        end
+
+        SplitIoClient::Cache::Adapters::RedisAdapter.new(redis_url)
+      end
+    end
+
+    def self.map_memory_adapter(name, queue_size)
+      case name
+      when :map_adapter
+        SplitIoClient::Cache::Adapters::MemoryAdapters::MapAdapter.new
+      when :queue_adapter
+        SplitIoClient::Cache::Adapters::MemoryAdapters::QueueAdapter.new(queue_size)
+      end
+    end
+
+    def self.default_mode
+      :standalone
+    end
+
     # @return [LocalStore] configuration value for local cache store
-    def self.default_local_store
-      defined?(Rails) && Rails.respond_to?(:cache) ? Rails.cache : LocalStore.new
+    def self.default_cache_adapter
+      :memory
     end
 
     #
@@ -122,27 +461,90 @@ module SplitIoClient
     end
 
     def self.default_features_refresh_rate
-      30
+      60
     end
 
     def self.default_segments_refresh_rate
       60
     end
 
-    def self.default_metrics_refresh_rate
+    def self.default_impressions_refresh_rate
       60
     end
 
-    def self.default_impressions_refresh_rate
+    def self.default_impressions_refresh_rate_optimized
+      300
+    end
+
+    def self.default_impression_listener_refresh_rate
+      0
+    end
+
+    def self.default_impressions_queue_size
+      5000
+    end
+
+    def self.default_events_push_rate
       60
     end
 
+    def self.default_events_queue_size
+      500
+    end
+
+    def self.default_telemetry_refresh_rate
+      3600
+    end
+
+    def self.default_unique_keys_refresh_rate(adapter)
+      return 300 if adapter == :redis
+
+      900
+    end
+
+#    def self.default_unique_keys_cache_max_size
+#      30000
+#    end
+
+    def self.default_unique_keys_bulk_size(adapter)
+      return 2000 if adapter == :redis
+
+      5000
+    end
+
+    def self.default_telemetry_service_url
+      'https://telemetry.split.io/api/v1'
+    end
+
+    def self.default_split_file
+      File.join(Dir.home, '.split')
+    end
+
+    def self.default_offline_refresh_rate
+      5
+    end
+
+    def self.sanitize_flag_set_filter(flag_sets, validator, adapter, logger)
+      return [] if flag_sets.nil?
+      if adapter == :redis
+        logger.warn("config: : flag_sets_filter is not applicable for Consumer modes where the SDK does not keep rollout data in sync. FlagSet filter was discarded")
+        return []
+      end
+      return validator.valid_flag_sets(:config, flag_sets)
+    end
+
     #
     # The default logger object
     #
     # @return [object]
     def self.default_logger
-      Logger.new($stdout)
+      if defined?(Rails) && Rails.logger
+        Rails.logger
+      elsif ENV['SPLITCLIENT_ENV'] == 'test'
+        Logger.new('/dev/null')
+      else
+       Logger.new($stdout)
+       end
     end
 
     #
@@ -153,41 +555,183 @@ module SplitIoClient
       false
     end
 
+    #
+    # The default labels logging value
+    #
+    # @return [boolean]
+    def self.default_labels_logging
+      true
+    end
+
+    def self.default_redis_url
+      'redis://127.0.0.1:6379/0'
+    end
+
+    def self.default_redis_namespace
+      'SPLITIO'
+    end
+
+    #
+    # The default block until ready value
+    #
+    # @return [int]
+    def self.default_block_until_ready
+      15
+    end
+
+    #
+    # The default ip addresses enabled value
+    #
+    # @return [boolean]
+    def self.default_ip_addresses_enabled
+      true
+    end
+
+    #
+    # The default transport_debug_enabled value
+    #
+    # @return [boolean]
+    def self.transport_debug
+      false
+    end
+
+    #
+    # The default cache time to live
+    #
+    # @return [int]
+    def self.cache_ttl
+      5
+    end
+
+    # The default max cache size
+    #
+    # @return [int]
+    def self.max_cache_size
+      500
+    end
+
+    # The default max key size
+    #
+    # @return [int]
+    def self.max_key_size
+      250
+    end
+
     #
     # custom logger of exceptions
     #
     # @return [void]
-    def log_found_exception(caller, exn)
-      error_traceback = "#{exn.inspect} #{exn}\n\t#{exn.backtrace.join("\n\t")}"
-      error = "[splitclient-rb] Unexpected exception in #{caller}: #{error_traceback}"
-      @logger.error(error)
+    def log_found_exception(caller, error)
+      message = ''
+
+      message << "[splitclient-rb] Unexpected exception in #{caller}: #{error.inspect} #{error}"
+      message << "\n\t#{error.backtrace.join("\n\t")}" if @debug_enabled
+
+      @logger.warn(message)
+    end
+
+    #
+    # log which cache class was loaded and SDK mode
+    #
+    # @return [void]
+    def startup_log
+      return if ENV['SPLITCLIENT_ENV'] == 'test'
+
+      @logger.info("Loaded Ruby SDK v#{VERSION} in the #{@mode} mode")
+      @logger.info("Loaded cache class: #{@cache_adapter.class}")
+    end
+
+    def standalone?
+      @mode.equal?(:standalone)
+    end
+
+    def consumer?
+      @mode.equal?(:consumer)
     end
 
+    def sdk_url_overriden?
+      return @base_uri != SplitConfig.default_base_uri
+    end
+    
     #
     # gets the hostname where the sdk gem is running
     #
     # @return [string]
-    def self.get_hostname
-      begin
-        Socket.gethostname
-      rescue
-        #unable to get hostname
-        'localhost'
+    def self.machine_hostname(ip_addresses_enabled, machine_name, adapter)
+      if ip_addresses_enabled
+        begin
+          return machine_name || Socket.gethostname
+        rescue
+          return 'unknown'.freeze
+        end
+      else
+        case adapter
+        when :redis
+          return 'NA'.freeze
+        end
       end
+
+      return ''.freeze
     end
 
     #
     # gets the ip where the sdk gem is running
     #
     # @return [string]
-    def self.get_ip
-      begin
-        Socket::getaddrinfo(Socket.gethostname, 'echo', Socket::AF_INET)[0][3]
-      rescue
-        #unable to get local ip
-        '127.0.0.0'
+    def self.machine_ip(ip_addresses_enabled, ip, adapter)
+      if ip_addresses_enabled
+        begin
+          return ip unless ip.nil? || ip.to_s.empty?
+
+          loopback_ip = Socket.ip_address_list.find { |ip| ip.ipv4_loopback? }
+          private_ip = Socket.ip_address_list.find { |ip| ip.ipv4_private? }
+
+          addr_info = private_ip || loopback_ip
+
+          return addr_info.ip_address
+        rescue
+          return 'unknown'.freeze
+        end
+      else
+        case adapter
+        when :redis
+          return 'NA'.freeze
+        end
       end
+
+      return ''.freeze
     end
 
+    def self.sanitize_fallback_config(fallback_config, validator, logger)
+      return fallback_config if fallback_config.nil?
+      
+      processed = Engine::Models::FallbackTreatmentsConfiguration.new
+      if !fallback_config.is_a?(Engine::Models::FallbackTreatmentsConfiguration)
+        logger.warn('Config: fallbackTreatments parameter should be of `FallbackTreatmentsConfiguration` class.')
+        return processed        
+      end
+
+      sanitized_global_fallback_treatment = fallback_config.global_fallback_treatment
+      if !fallback_config.global_fallback_treatment.nil? && !validator.validate_fallback_treatment('Config', fallback_config.global_fallback_treatment)
+        logger.warn('Config: global fallbacktreatment parameter is discarded.')
+        sanitized_global_fallback_treatment = nil
+      end
+
+      sanitized_flag_fallback_treatments = nil
+      if !fallback_config.by_flag_fallback_treatment.nil? && fallback_config.by_flag_fallback_treatment.is_a?(Hash)
+        sanitized_flag_fallback_treatments = Hash.new
+        for feature_name in fallback_config.by_flag_fallback_treatment.keys()
+          if !validator.valid_split_name?('Config', feature_name) || !validator.validate_fallback_treatment('Config', fallback_config.by_flag_fallback_treatment[feature_name])
+            logger.warn("Config: fallback treatment parameter for feature flag #{feature_name} is discarded.")
+            next
+          end   
+
+          sanitized_flag_fallback_treatments[feature_name] = fallback_config.by_flag_fallback_treatment[feature_name]
+        end
+      end          
+      processed = Engine::Models::FallbackTreatmentsConfiguration.new(sanitized_global_fallback_treatment, sanitized_flag_fallback_treatments)
+
+      processed
+    end
   end
 end