Codecov Report

+require 'forwardable'+require 'ddtrace/configuration/settings'+require 'ddtrace/configuration/components'+require 'ddtrace/configuration/pin_setup'++module Datadog+  module Tracing+    # This class encapsulates all tracer runtime data and objects.+    #+    # Any stateful component or information that the tracer requires+    # to execute must be directly or indirectly managed by {Runtime}.+    #+    # Any object who's life cycle is not captured by {Runtime} should be+    # part of the generic tracer structure, unaffected by configuration+    # or runtime state.+    #+    # Creating a new {Runtime} will effectively configure and initialized a new+    # running instance of the tracer.+    #+    # Reconfiguration the {Runtime} will affect the running tracer instance without+    # a complete restart of the tracer internals.+    #+    # Destroying the {Runtime} will shutdown the current tracer instance.+    #+    # The tracer has started if and only if (iff) the {Runtime} has been started.+    # The tracer is shut down if and only if (iff) the {Runtime} is shut down.+    #+    # A production user of the tracer will only initialize at most a single {Runtime}+    # instance throughout the lifetime of the host application. Changes to the tracer+    # state will be handled by {Runtime#configure} invocations.+    #+    # TODO: {Runtime} currently indirectly manages the Profiler, though Components.+    # TODO: The Profiler life cycle management should be eventually extracted to its own runtime.+    class Runtime

+require 'forwardable'+require 'ddtrace/configuration/settings'+require 'ddtrace/configuration/components'+require 'ddtrace/configuration/pin_setup'++module Datadog+  module Tracing+    # This class encapsulates all tracer runtime data and objects.+    #+    # Any stateful component or information that the tracer requires+    # to execute must be directly or indirectly managed by {Runtime}.+    #+    # Any object who's life cycle is not captured by {Runtime} should be+    # part of the generic tracer structure, unaffected by configuration+    # or runtime state.+    #+    # Creating a new {Runtime} will effectively configure and initialized a new+    # running instance of the tracer.+    #+    # Reconfiguration the {Runtime} will affect the running tracer instance without+    # a complete restart of the tracer internals.+    #+    # Destroying the {Runtime} will shutdown the current tracer instance.+    #+    # The tracer has started if and only if (iff) the {Runtime} has been started.+    # The tracer is shut down if and only if (iff) the {Runtime} is shut down.+    #+    # A production user of the tracer will only initialize at most a single {Runtime}+    # instance throughout the lifetime of the host application. Changes to the tracer+    # state will be handled by {Runtime#configure} invocations.+    #+    # TODO: {Runtime} currently indirectly manages the Profiler, though Components.+    # TODO: The Profiler life cycle management should be eventually extracted to its own runtime.+    class Runtime+      extend Forwardable++      attr_reader :configuration++      # Loads configuration and initializes basic components.+      def initialize(+        configuration = Configuration::Settings.new,+        components = Configuration::Components.new(configuration)+      )+        @configuration = configuration+        @components = components+      end++      # Triggers second step of component initialization.+      def startup!+        @components.startup!(@configuration)+      end++      def_delegators \+        :components,+        :health_metrics, :logger, :profiler, :runtime_metrics, :tracer++      # Alters configuration of the active {Runtime}.+      #+      # This call triggers component re-instantiation.+      def configure(target = configuration, opts = {})+        return Configuration::PinSetup.new(target, opts).call unless target.is_a?(Configuration::Settings)++        yield(target) if block_given?

 require 'ddtrace/ext/runtime' +# TODO: suggested namespace+# Datadog::Tracing::Environment::Ruby::GC+# Datadog::Tracing::Environment::Socket+# Datadog::Tracing::Runtime/Engine

+require 'ddtrace/tracing/runtime'++module Datadog+  # Manages the {Runtime} life cycle for the host application.+  #+  # The {Runtime} is a container of all stateful tracer internals.+  #+  # {LifeCycle} ensure that the {Runtime} is created,+  # modified and decommissioned correctly during the host+  # application's life cycle.+  module LifeCycle+    extend Forwardable++    def_delegators \+        :runtime,+        :configure, :shutdown!,+        :configuration,+        :health_metrics, :logger, :profiler, :runtime_metrics, :tracer++    protected++    def start!(runtime = Tracing::Runtime.new)+      @runtime = runtime+      runtime.startup!+    end++    private++    attr_reader :runtime++    # Only used internally for testing+    def started?+      [email protected]?+    end++    # Only used internally for testing+    def tear_down!+      shutdown! if started?++      # TODO: this is actually part of contrib+      # TODO: should probably be moved to inside contrib/+      # Reset stateful registry data+      registry.each do |data|+        data.klass.reset_configuration!+      end++      @runtime = nil+    end++    # Only used internally for testing+    def restart!+      tear_down!+      start!+    end

+module Datadog+  # Responsible for the behavior the tracer after it's completely+  # loaded, but before `require 'ddtrace'` returns control to+  # the user.+  class Initialization++    # @param tracer [Datadog] an application-level Datadog APM tracer object+    def initialize(tracer)+      @tracer = tracer+    end++    # Initializes the tracer.+    #+    # This performs performs any initialization necessary+    # before control is returned to the host application.+    #+    # The tracer should be ready for use after this call.+    #+    # This method is invoked once per application life cycle.+    def initialize!

+module Datadog+  # Responsible for the behavior the tracer after it's completely+  # loaded, but before `require 'ddtrace'` returns control to+  # the user.+  class Initialization++    # @param tracer [Datadog] an application-level Datadog APM tracer object+    def initialize(tracer)

 def reduce_log_verbosity       end     end   end++  # Load and extend Contrib by default+  extend Contrib::Extensions end

 module Contrib     module Extensions       def self.extended(base)         Datadog.extend(Helpers)-        Datadog.extend(Configuration)+        Datadog::Tracing::Runtime.prepend(Configuration)         Datadog::Configuration::Settings.include(Configuration::Settings)       end        # Helper methods for Datadog module.       module Helpers+        # Registry is a global, declarative repository of all available integrations.+        #+        # Integrations should register themselves with the registry as early as+        # possible as the initial tracer configuration can only activate integrations+        # if they have already been registered.+        #+        # Despite that, integrations *can* be appended to the registry at any point+        # of the program execution. Newly appended integrations can then be+        # activated during tracer reconfiguration.+        #+        # The registry itself is stateless: it does not depend on runtime configuration+        # and must execute correctly after successive configuration changes.+        # The registered integrations themselves can depend on the stateful configuration+        # of the tracer.         def registry-          configuration.registry+          @registry ||= Registry.new         end       end

 def build_tracer(settings, agent_settings)             default_service: settings.service,             enabled: settings.tracer.enabled,             partial_flush: settings.tracer.partial_flush.enabled,-            tags: build_tracer_tags(settings)+            tags: build_tracer_tags(settings),+            sampler: PrioritySampler.new(+              base_sampler: AllSampler.new,+              post_sampler: Sampling::RuleSampler.new(+                rate_limit: settings.sampling.rate_limit,+                default_sample_rate: settings.sampling.default_rate,+              )+            )