instana 1.212.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 332da83974279a02e0ebc35086a412aa2f8640d4e40dd38957bec22c0f8a9ed8
-  data.tar.gz: cb3528e5f55e0c76e5069c0d801033d800af6c184101484690d9ead1b9cf7088
+  metadata.gz: f3e1c637f9239bf92022943ba9bd659e92fce0a7030a37adc337754e06d08245
+  data.tar.gz: c17d71a2c480b163b37c3f18a4fa6a510a94b553d5777b8192535433835b56bc
 SHA512:
-  metadata.gz: 4f372d7417bda356f6051fc6d8fb1ceb6f85537ac4c6841a9247f966350c9574335bf8c4fdc567b1c78d54ad95a8f3d0ce53b14126e964bb249c68d648616d11
-  data.tar.gz: 44ebe7c9b5716b7d323a619561c3732ba8b1145a600601ebbb6c797444db89a82486f94580ac2b20335f3f4877abaf35274abe9a14b740500c894c2b3aecffab
+  metadata.gz: 02fd637038f974a35d42f52f52878ccb27f9dd7b177b07e2bfd92b53c7f176fc8dd3ecf4cd40d088023e571c5d6f0976901cc828a7c9e826781d7e361538bc0a
+  data.tar.gz: eab1b63483157aa3e58f1aef240e90de08faeaf0edddc5c9905ebaccc89630e27d22e5431c6b3f5be84e135b082e2da8ce1738fbe62bf8eef1561f3b93bc1e77

data/README.md

@@ -8,7 +8,8 @@ Any and all feedback is welcome.  Happy Ruby visibility.
 
 [![Gem Version](https://badge.fury.io/rb/instana.svg)](https://badge.fury.io/rb/instana)
 [![CircleCI](https://circleci.com/gh/instana/ruby-sensor.svg?style=svg)](https://circleci.com/gh/instana/ruby-sensor)
-[![OpenTracing Badge](https://img.shields.io/badge/OpenTracing-enabled-blue.svg)](http://opentracing.io)
+[![OpenTracing Badge](https://img.shields.io/badge/OpenTracing-disabled-red.svg)](http://opentracing.io)
+[![OpenTelemetry Badge](https://img.shields.io/badge/OpenTelemetry-enabled-blue.svg)](http://opentelemetry.io)
 
 ## Installation
 

data/lib/instana/activators/action_view.rb

@@ -12,8 +12,11 @@ module Instana
         require 'instana/instrumentation/action_view'
 
         ::ActionView::PartialRenderer
-          .prepend(Instana::Instrumentation::ActionView)
-
+          .prepend(Instana::Instrumentation::ActionView::PartialRenderer)
+        if defined?(::ActionView::CollectionRenderer)
+          ::ActionView::CollectionRenderer
+            .prepend(Instrumentation::ActionView::CollectionRenderer)
+        end
         true
       end
     end

data/lib/instana/activators/bunny.rb

@@ -0,0 +1,23 @@
+# (c) Copyright IBM Corp. 2025
+
+module Instana
+  module Activators
+    class Bunny < Activator
+      def can_instrument?
+        defined?(::Bunny) &&
+          defined?(::Bunny::Queue) &&
+          defined?(::Bunny::Exchange) &&
+          ::Instana.config[:bunny][:enabled]
+      end
+
+      def instrument
+        require 'instana/instrumentation/bunny'
+
+        ::Bunny::Exchange.prepend(::Instana::Instrumentation::BunnyProducer)
+        ::Bunny::Queue.prepend(::Instana::Instrumentation::BunnyConsumer)
+
+        true
+      end
+    end
+  end
+end

data/lib/instana/activators/redis.rb

@@ -5,13 +5,18 @@ module Instana
   module Activators
     class Redis < Activator
       def can_instrument?
-        defined?(::Redis) && defined?(::Redis::Client) && ::Instana.config[:redis][:enabled]
+        defined?(::Redis) && defined?(::Redis::Client) && ::Instana.config[:redis][:enabled] &&
+          (Gem::Specification.find_by_name('redis').version < Gem::Version.new('5.0') || defined?(::RedisClient))
       end
 
       def instrument
         require 'instana/instrumentation/redis'
 
-        ::Redis::Client.prepend(::Instana::RedisInstrumentation)
+        if Gem::Specification.find_by_name('redis').version >= Gem::Version.new('5.0')
+          ::RedisClient.prepend(::Instana::RedisInstrumentation)
+        else
+          ::Redis::Client.prepend(::Instana::RedisInstrumentation)
+        end
 
         true
       end

data/lib/instana/activators/sequel.rb

@@ -0,0 +1,20 @@
+# (c) Copyright IBM Corp. 2024
+
+module Instana
+  module Activators
+    class Sequel < Activator
+      def can_instrument?
+        defined?(::Sequel::Database)
+      end
+
+      def instrument
+        require 'instana/instrumentation/sequel'
+
+        ::Sequel::Database
+          .prepend(Instana::Instrumentation::Sequel)
+
+        true
+      end
+    end
+  end
+end

data/lib/instana/activators/sinatra.rb

@@ -12,6 +12,9 @@ module Instana
         require 'instana/frameworks/sinatra'
 
         ::Sinatra::Base.use ::Instana::Rack
+        unless ::Sinatra::Base.respond_to?(:mustermann_opts)
+          ::Sinatra::Base.set :mustermann_opts, {}
+        end
         ::Sinatra::Base.register ::Instana::SinatraPathTemplateExtractor
 
         true

data/lib/instana/backend/host_agent.rb

@@ -12,6 +12,8 @@ module Instana
         @logger = logger
         @future = nil
         @client = nil
+        # Timer task to poll for agent liveliness
+        @agent_connection_task = Concurrent::TimerTask.new(execution_interval: 75) { announce }
       end
 
       def setup; end
@@ -27,8 +29,17 @@ module Instana
       alias start spawn_background_thread
 
       def announce
-        @client = until_not_nil { HostAgentLookup.new.call }
-        @discovery.delete_observers
+        @client = with_timeout { HostAgentLookup.new.call }
+        # Shuts down the connection task based on agent connection client.
+        @client ? @agent_connection_task.shutdown : @agent_connection_task.execute
+        # Do not continue further if the agent is down/connection to the agent is unsuccessfull
+        return nil unless @client
+
+        begin
+          @discovery.send(:observers)&.send(:notify_and_delete_observers, Time.now, nil, nil)
+        ensure
+          @discovery.delete_observers
+        end
         @discovery
           .with_observer(HostAgentActivationObserver.new(@client, @discovery))
           .with_observer(HostAgentReportingObserver.new(@client, @discovery))
@@ -70,14 +81,16 @@ module Instana
 
       private
 
-      def until_not_nil
-        loop do
+      def with_timeout
+        15.times do
           result = yield
           return result unless result.nil?
 
           @logger.debug("Waiting on a connection to the agent.")
           sleep(1)
         end
+        @logger.info("Agent connection timed out retrying after 60 seconds")
+        nil
       end
 
       def discovery_value

data/lib/instana/backend/request_client.rb

@@ -8,8 +8,10 @@ require 'json'
 # :nocov:
 begin
   require 'oj'
+  INSTANA_USE_OJ = true
 rescue LoadError => _e
   Instana.logger.warn("Unable to load Oj.")
+  INSTANA_USE_OJ = false
 end
 # :nocov:
 
@@ -66,7 +68,7 @@ module Instana
 
       def encode_body(data)
         # :nocov:
-        defined?(Oj) ? Oj.dump(data, mode: :strict) : JSON.dump(data)
+        INSTANA_USE_OJ ? Oj.dump(data, mode: :strict) : JSON.dump(data)
         # :nocov:
       end
     end

data/lib/instana/base.rb

@@ -14,6 +14,7 @@ module Instana
     attr_accessor :pid
     attr_reader :secrets
     attr_reader :serverless
+    attr_accessor :tracer_provider
 
     ##
     # setup
@@ -22,8 +23,9 @@ module Instana
     # to run" state.
     #
     def setup
-      @agent  = ::Instana::Backend::Agent.new
-      @tracer = ::Instana::Tracer.new
+      @agent = ::Instana::Backend::Agent.new
+      @tracer_provider = ::Instana::Trace::TracerProvider.new
+      @tracer = @tracer_provider.tracer('instana_tracer')
       @processor = ::Instana::Processor.new
       @secrets = ::Instana::Secrets.new
       @serverless = ::Instana::Serverless.new

data/lib/instana/config.rb

@@ -27,6 +27,9 @@ module Instana
       # Enable/disable tracing (default: enabled)
       @config[:tracing] = { :enabled => true }
 
+      # Enable/disable tracing exit spans as root spans
+      @config[:allow_exit_as_root] = ENV['INSTANA_ALLOW_EXIT_AS_ROOT'] == '1'
+
       # Enable/Disable logging
       @config[:logging] = { :enabled => true }
 
@@ -61,6 +64,7 @@ module Instana
       @config[:action_controller]  = { :enabled => true }
       @config[:action_view]        = { :enabled => true }
       @config[:active_record]      = { :enabled => true }
+      @config[:bunny]              = { :enabled => true }
       @config[:dalli]              = { :enabled => true }
       @config[:excon]              = { :enabled => true }
       @config[:grpc]               = { :enabled => true }
@@ -70,6 +74,7 @@ module Instana
       @config[:'resque-client']    = { :enabled => true, :propagate => true }
       @config[:'resque-worker']    = { :enabled => true, :'setup-fork' => true }
       @config[:'rest-client']      = { :enabled => true }
+      @config[:sequel]             = { :enabled => true }
       @config[:'sidekiq-client']   = { :enabled => true }
       @config[:'sidekiq-worker']   = { :enabled => true }
     end

data/lib/instana/frameworks/rails.rb

@@ -17,7 +17,33 @@ else
         # Configure the Instrumented Logger
         if ::Instana.config[:logging][:enabled] && !ENV.key?('INSTANA_TEST')
           logger = ::Instana::InstrumentedLogger.new('/dev/null')
-          Rails.logger.extend(ActiveSupport::Logger.broadcast(logger))
+          if ::Rails::VERSION::STRING < "7.1"
+            # Rails 7.0.3 `tagged_logging.rb` has a number of bugs.
+            # What pertains to our instrumentation here is that in
+            # https://github.com/rails/rails/blob/v7.0.3/activesupport/lib/active_support/tagged_logging.rb#L100
+            # sets the `other_logger.formatter` to `formatter` if `other_logger.formatter` is `nil`
+            # but then
+            # https://github.com/rails/rails/blob/v7.0.3/activesupport/lib/active_support/tagged_logging.rb#L102
+            # redefines `formatter.current_tags` method to a proc calling `formatter.current_tags`, itself.
+            # which is an infinite recursion.
+            #
+            # This bug starts with 7.0.3:
+            # https://github.com/rails/rails/compare/v7.0.2...v7.0.3#diff-68f90ba4998610be2f7da027e006e8ddeeb06dece66f41579c94070e12f23011
+            # And is already reverted/fixed in 7.0.4
+            # https://github.com/rails/rails/compare/v7.0.3...v7.0.4#diff-68f90ba4998610be2f7da027e006e8ddeeb06dece66f41579c94070e12f23011
+            # The commit which fixes it is:
+            # https://github.com/rails/rails/commit/ff277583e22ddfbcfbd2131789a7cb7c2f868d68
+            #
+            # Since instana does trigger this bug here we workaround it, by defining the `formatter`,
+            # to break the infinite loop. The `formatter` used here is the same as the default used in
+            # https://github.com/rails/rails/blob/v7.0.3/activesupport/lib/active_support/tagged_logging.rb#L89C9-L89C70
+            if ::Rails::VERSION::STRING == "7.0.3"
+              logger.formatter = ActiveSupport::Logger::SimpleFormatter.new
+            end
+            Rails.logger.extend(ActiveSupport::Logger.broadcast(logger))
+          else
+            Rails.logger.broadcast_to(logger)
+          end
         end
 
         if ::Instana.config[:tracing][:enabled]

data/lib/instana/instrumentation/action_cable.rb

@@ -27,8 +27,10 @@ module Instana
         }
 
         context = connection.instana_trace_context
-        ::Instana.tracer.start_or_continue_trace(:'rpc-server', rpc_tags, context) do
-          super(data, via: via)
+        Trace.with_span(OpenTelemetry::Trace.non_recording_span(context)) do
+          ::Instana.tracer.in_span(:'rpc-server', attributes: rpc_tags) do
+            super(data, via: via)
+          end
         end
       end
 
@@ -44,8 +46,10 @@ module Instana
         }
 
         context = connection.instana_trace_context
-        ::Instana.tracer.start_or_continue_trace(:'rpc-server', rpc_tags, context) do
-          super(action, data)
+        Trace.with_span(OpenTelemetry::Trace.non_recording_span(context)) do
+          ::Instana.tracer.in_span(:'rpc-server', attributes: rpc_tags) do
+            super(action, data)
+          end
         end
       end
     end

data/lib/instana/instrumentation/action_controller.rb

@@ -11,9 +11,8 @@ module Instana
             action: action_name
           }
         }
-
         request.env['INSTANA_HTTP_PATH_TEMPLATE'] = matched_path_template
-        ::Instana::Tracer.trace(:actioncontroller, call_payload) { super(*args) }
+        ::Instana.tracer.in_span(:actioncontroller, attributes: call_payload) { super(*args) }
       end
 
       def render(*args, &block)
@@ -22,8 +21,7 @@ module Instana
             name: describe_render_options(args.first) || 'Default'
           }
         }
-
-        ::Instana::Tracer.trace(:actionview, call_payload) { super(*args, &block) }
+        ::Instana.tracer.in_span(:actionview, attributes: call_payload) { super(*args, &block) }
       end
 
       private

data/lib/instana/instrumentation/action_mailer.rb

@@ -12,7 +12,7 @@ module Instana
               method: method_name.to_s
             }
           }
-          Instana::Tracer.trace(:'mail.actionmailer', tags) { super }
+          Instana.tracer.in_span(:'mail.actionmailer', attributes: tags) { super }
         else
           super
         end

data/lib/instana/instrumentation/action_view.rb

@@ -4,26 +4,52 @@
 module Instana
   module Instrumentation
     module ActionView
-      def render_partial(*args)
-        call_payload = {
-          render: {
-            type: :partial,
-            name: @options.is_a?(Hash) ? @options[:partial].to_s : 'Unknown'
+      module PartialRenderer
+        def render_partial(*args)
+          call_payload = {
+            render: {
+              type: :partial,
+              name: @options.is_a?(Hash) ? @options[:partial].to_s : 'Unknown'
+            }
           }
-        }
 
-        ::Instana::Tracer.trace(:render, call_payload) { super(*args) }
+          ::Instana.tracer.in_span(:render, attributes: call_payload) { super(*args) }
+        end
+
+        def render_collection(*args)
+          call_payload = {
+            render: {
+              type: :collection,
+              name: @path.to_s
+            }
+          }
+
+          ::Instana.tracer.in_span(:render, attributes: call_payload) { super(*args) }
+        end
+
+        def render_partial_template(*args)
+          call_payload = {
+            render: {
+              type: :partial,
+              name: @options.is_a?(Hash) ? @options[:partial].to_s : 'Unknown'
+            }
+          }
+
+          ::Instana.tracer.in_span(:render, attributes: call_payload) { super(*args) }
+        end
       end
 
-      def render_collection(*args)
-        call_payload = {
-          render: {
-            type: :collection,
-            name: @path.to_s
+      module CollectionRenderer
+        def render_collection(*args)
+          call_payload = {
+            render: {
+              type: :collection,
+              name: @options.is_a?(Hash) ? @options[:partial].to_s : 'Unknown'
+            }
           }
-        }
 
-        ::Instana::Tracer.trace(:render, call_payload) { super(*args) }
+          ::Instana.tracer.in_span(:render, attributes: call_payload) { super(*args) }
+        end
       end
     end
   end

data/lib/instana/instrumentation/active_job.rb

@@ -1,5 +1,19 @@
 # (c) Copyright IBM Corp. 2021
 # (c) Copyright Instana Inc. 2021
+module OpenTelemetry
+  module Trace
+    module Propagation
+      module TraceContext
+        # A TraceParent is an implementation of the W3C trace context specification
+        # https://www.w3.org/TR/trace-context/
+        # {Trace::SpanContext}
+        class TraceParent
+          REGEXP = /^(?<version>[A-Fa-f0-9]{2})-(?<trace_id>[A-Fa-f0-9]{32})-(?<span_id>[A-Fa-f0-9]{32})-(?<flags>[A-Fa-f0-9]{2})(?<ignored>-.*)?$/
+        end
+      end
+    end
+  end
+end
 
 module Instana
   module Instrumentation
@@ -15,12 +29,11 @@ module Instana
             }
           }
 
-          ::Instana::Tracer.trace(:activejob, tags) do
+          ::Instana.tracer.in_span(:activejob, attributes: tags) do
             context = ::Instana.tracer.context
-            job.arguments = [{
-              given_arguments: job.arguments,
-              instana_context: context ? context.to_hash : nil
-            }]
+            job.arguments.append({
+                                   instana_context: context ? context.to_hash : nil
+                                 })
 
             block.call
           end
@@ -35,15 +48,15 @@ module Instana
               job_id: job.job_id
             }
           }
-
-          incoming_context = if job.arguments.is_a?(Array) && job.arguments.first.is_a?(Hash)
-                               instana_context = job.arguments.first[:instana_context]
-                               job.arguments = job.arguments.first[:given_arguments]
-                               instana_context ? ::Instana::SpanContext.new(instana_context[:trace_id], instana_context[:span_id]) : nil
+          incoming_context = if job.arguments.is_a?(Array) && job.arguments.last.is_a?(Hash) && job.arguments.last.key?(:instana_context)
+                               instana_context = job.arguments.last[:instana_context]
+                               job.arguments.pop
+                               instana_context ? ::Instana::SpanContext.new(trace_id: instana_context[:trace_id], span_id: instana_context[:span_id]) : nil
                              end
-
-          ::Instana::Tracer.start_or_continue_trace(:activejob, tags, incoming_context) do
-            block.call
+          Trace.with_span(OpenTelemetry::Trace.non_recording_span(incoming_context)) do
+            ::Instana.tracer.in_span(:activejob, attributes: tags) do
+              block.call
+            end
           end
         end
       end

data/lib/instana/instrumentation/active_record.rb

@@ -6,7 +6,7 @@ module Instana
     module ActiveRecord
       IGNORED_NAMES = %w[SCHEMA EXPLAIN CACHE].freeze
       IGNORED_SQL = %w[BEGIN COMMIT SET].freeze
-      SANITIZE_REGEXP = /('[\s\S][^']*'|\d*\.\d+|\d+|NULL)/i.freeze
+      SANITIZE_REGEXP = /('[\s\S][^']*'|\d*\.\d+|\d+|NULL)/i
 
       def log(sql, name = 'SQL', binds = [], *args, **kwargs, &block)
         call_payload = {
@@ -35,7 +35,7 @@ module Instana
 
       def maybe_trace(call_payload, name, &blk)
         if ::Instana.tracer.tracing? && !ignored?(call_payload, name)
-          ::Instana.tracer.trace(:activerecord, call_payload, &blk)
+          ::Instana.tracer.in_span(:activerecord, attributes: call_payload, &blk)
         else
           yield
         end

data/lib/instana/instrumentation/aws_sdk_dynamodb.rb

@@ -11,7 +11,7 @@ module Instana
             table: table_name_from(context)
           }
 
-          ::Instana.tracer.trace(:dynamodb, {dynamodb: dynamo_tags}) { @handler.call(context) }
+          ::Instana.tracer.in_span(:dynamodb, attributes: {dynamodb: dynamo_tags}) { @handler.call(context) }
         end
 
         private

data/lib/instana/instrumentation/aws_sdk_lambda.rb

@@ -17,7 +17,7 @@ module Instana
               'X-INSTANA-L' => span_context.level.to_s
             }
 
-            context.params[:client_context] = JSON.dump(payload)
+            context.params[:client_context] = Base64.strict_encode64(JSON.dump(payload))
           end
 
           tags = {
@@ -25,7 +25,13 @@ module Instana
             type: context.params[:invocation_type]
           }.reject { |_, v| v.nil? }
 
-          ::Instana.tracer.trace(:"aws.lambda.invoke", {aws: {lambda: {invoke: tags}}}) { @handler.call(context) }
+          ::Instana.tracer.in_span(:"aws.lambda.invoke", attributes: {aws: {lambda: {invoke: tags}}}) do
+            response = @handler.call(context)
+            if response.respond_to? :status_code
+              ::Instana.tracer.log_info(:http => {:status => response.status_code })
+            end
+            response
+          end
         end
       end
 

data/lib/instana/instrumentation/aws_sdk_s3.rb

@@ -12,7 +12,7 @@ module Instana
             key: key_from_context(context)
           }.reject { |_, v| v.nil? }
 
-          ::Instana.tracer.trace(:s3, {s3: s3_tags}) { @handler.call(context) }
+          ::Instana.tracer.in_span(:s3, attributes: {s3: s3_tags}) { @handler.call(context) }
         end
 
         private

data/lib/instana/instrumentation/aws_sdk_sns.rb

@@ -14,7 +14,7 @@ module Instana
           }.reject { |_, v| v.nil? }
 
           if context.operation_name == :publish
-            ::Instana.tracer.trace(:sns, {sns: sns_tags}) { @handler.call(context) }
+            ::Instana.tracer.in_span(:sns, attributes: {sns: sns_tags}) { @handler.call(context) }
           else
             @handler.call(context)
           end

data/lib/instana/instrumentation/aws_sdk_sqs.rb

@@ -15,7 +15,7 @@ module Instana
 
           span_tags = tags_for(context.operation_name, context.params).reject { |_, v| v.nil? }
 
-          ::Instana.tracer.trace(:sqs, {sqs: span_tags}) do |span|
+          ::Instana.tracer.in_span(:sqs, attributes: {sqs: span_tags}) do |span|
             case context.operation_name
             when :send_message
               inject_instana_headers(span, context.params)

data/lib/instana/instrumentation/bunny.rb

@@ -0,0 +1,129 @@
+# (c) Copyright IBM Corp. 2025
+
+module Instana
+  module Instrumentation
+    module BunnyProducer
+      def publish(payload, options = {})
+        if ::Instana.tracer.tracing?
+          exchange_name = name.empty? ? 'default' : name
+          routing_key = options[:routing_key] || ''
+
+          kvs = {
+            rabbitmq: {
+              sort: 'publish',
+              address: channel.connection.host,
+              key: routing_key,
+              exchange: exchange_name
+            }
+          }
+
+          ::Instana.tracer.in_span(:rabbitmq, attributes: kvs) do |span|
+            # Inject trace context into message headers
+            options[:headers] ||= {}
+            options[:headers]['X-Instana-T'] = span.context.trace_id
+            options[:headers]['X-Instana-S'] = span.context.span_id
+            options[:headers]['X-Instana-L'] = span.context.level.to_s
+
+            super(payload, options)
+          end
+        else
+          super(payload, options)
+        end
+      rescue => e
+        ::Instana.logger.debug { "#{__method__}:#{File.basename(__FILE__)}:#{__LINE__}: #{e.message}" }
+        raise
+      end
+    end
+
+    module BunnyConsumer
+      def pop(options = {})
+        delivery_info, properties, payload = super(options)
+
+        return [delivery_info, properties, payload] unless delivery_info
+
+        trace_rabbitmq_consume(delivery_info, properties) do
+          [delivery_info, properties, payload]
+        end
+      rescue => e
+        log_error(e)
+        raise
+      end
+
+      def subscribe(options = {}, &block)
+        if block_given?
+          wrapped_block = lambda do |delivery_info, properties, payload|
+            trace_rabbitmq_consume(delivery_info, properties) do
+              block.call(delivery_info, properties, payload)
+            end
+          end
+
+          super(options, &wrapped_block)
+        else
+          super(options, &block)
+        end
+      rescue => e
+        log_error(e)
+        raise
+      end
+
+      private
+
+      def trace_rabbitmq_consume(delivery_info, properties, &block)
+        return yield unless ::Instana.tracer.tracing? || extract_context_from_headers(properties)
+
+        kvs = build_consume_attributes(delivery_info)
+        context = extract_context_from_headers(properties)
+
+        if context[:trace_id]
+          trace_with_context(context, kvs, &block)
+        else
+          ::Instana.tracer.in_span(:rabbitmq, attributes: kvs, &block)
+        end
+      end
+
+      def build_consume_attributes(delivery_info)
+        queue_name = name
+        exchange_name = delivery_info.exchange.empty? ? 'default' : delivery_info.exchange
+
+        {
+          rabbitmq: {
+            sort: 'consume',
+            address: channel.connection.host,
+            queue: queue_name,
+            exchange: exchange_name,
+            key: delivery_info.routing_key
+          }
+        }
+      end
+
+      def trace_with_context(context, kvs, &block)
+        instana_context = ::Instana::SpanContext.new(
+          trace_id: context[:trace_id],
+          span_id: context[:span_id],
+          level: context[:level]
+        )
+        span = OpenTelemetry::Trace.non_recording_span(instana_context)
+
+        Trace.with_span(span) do
+          ::Instana.tracer.in_span(:rabbitmq, attributes: kvs, &block)
+        end
+      end
+
+      def extract_context_from_headers(properties)
+        return {} unless properties && properties.headers
+
+        headers = properties.headers
+        {
+          trace_id: headers['X-Instana-T'],
+          span_id: headers['X-Instana-S'],
+          level: headers['X-Instana-L']&.to_i
+        }.reject { |_, v| v.nil? }
+      end
+
+      def log_error(error)
+        # Log errors on to console if INSTANA_DEBUG is enabled
+        ::Instana.logger.debug { "#{__method__}:#{File.basename(__FILE__)}:#{__LINE__}: #{error.message}" }
+      end
+    end
+  end
+end