solarwinds_apm 5.1.9 → 6.0.0.preV1

data/lib/solarwinds_apm/sdk/tracing.rb

@@ -1,432 +0,0 @@
-#--
-# Copyright (c) 2016 SolarWinds, LLC.
-# All rights reserved.
-#++
-
-module SolarWindsAPM
-  module SDK
-
-    ##
-    # Traces are best created with an <tt>SolarWindsAPM::SDK.start_trace</tt> block and
-    # <tt>SolarWindsAPM::SDK.trace</tt> blocks around calls to be traced.
-    # These two methods guarantee proper nesting of traces, handling of the tracing context, as well as avoiding
-    # broken traces in case of exceptions.
-    #
-    # Some optional keys that can be used in the +kvs+ hash:
-    # * +:Controller+
-    # * +:Action+
-    # * +:HTTP-Host+
-    # * +:URL+
-    # * +:Method+
-    #
-    # as well as custom keys. The information will show up in the raw data view of a span.
-    #
-    # Invalid keys: +:Label+, +:Layer+, +:Edge+, +:Timestamp+, +:Timestamp_u+, +:TransactionName+ (allowed in start_trace)
-    #
-    # The methods are exposed as singleton methods for SolarWindsAPM::SDK.
-    #
-    # === Usage:
-    # * +SolarWindsAPM::SDK.solarwinds_ready?+
-    # * +SolarWindsAPM::SDK.get_transaction_name+
-    # * +SolarWindsAPM::SDK.set_transaction_name+
-    # * +SolarWindsAPM::SDK.start_trace+
-    # * +SolarWindsAPM::SDK.start_trace_with_target+
-    # * +SolarWindsAPM::SDK.trace+
-    # * +SolarWindsAPM::SDK.trace_method+
-    # * +SolarWindsAPM::SDK.tracing?+
-    #
-    # === Example:
-    #   class MonthlyCouponEmailJob
-    #     def perform(*args)
-    #
-    #       # KVs to report to the dashboard
-    #       report_kvs = {}
-    #       report_kvs[:Spec] = :job
-    #       report_kvs[:Controller] = :MonthlyEmailJob
-    #       report_kvs[:Action] = :CouponEmailer
-    #
-    #       # Start tracing this job with start_trace
-    #       SolarWindsAPM::SDK.start_trace('monthly_coupons', kvs: report_kvs) do
-    #         monthly = MonthlyEmail.new(:CouponEmailer)
-    #
-    #         # Trace a sub-component of this trace
-    #         SolarWindsAPM::SDK.trace(self.class.name) do
-    #
-    #           # The work to be done
-    #           users = User.all
-    #           users.each do |u|
-    #             monthly.send(u.email)
-    #           end
-    #
-    #         end
-    #       end
-    #     end
-    #   end
-    #
-    module Tracing
-
-      # Trace a given block of code.
-      #
-      # Also detects any exceptions thrown by the block and report errors.
-      #
-      # === Arguments:
-      # * +name+        - Name for the span to be used as label in the trace view.
-      # * +kvs:+        - (optional) A hash containing key/value pairs that will be reported along with the first event of this span.
-      # * +protect_op:+ - (optional) The operation being traced.  Used to avoid double tracing operations that call each other.
-      #
-      # === Example:
-      #
-      #   def computation_with_sw_apm(n)
-      #     SolarWindsAPM::SDK.trace('computation', kvs: { :number => n }, protect_op: :computation) do
-      #       return n if n == 0
-      #       n + computation_with_sw_apm(n-1)
-      #     end
-      #   end
-      #
-      #   result = computation_with_sw_apm(100)
-      #
-      # === Returns:
-      # * The result of the block.
-      #
-      def trace(name, kvs: {}, protect_op: nil)
-        return yield if !SolarWindsAPM.loaded || !SolarWindsAPM.tracing? || SolarWindsAPM.tracing_layer_op?(protect_op)
-
-        kvs.delete(:TransactionName)
-        kvs.delete('TransactionName')
-
-        SolarWindsAPM::API.log_entry(name, kvs, protect_op)
-        kvs[:Backtrace] && kvs.delete(:Backtrace) # to avoid sending backtrace twice (faster to check presence here)
-        begin
-          yield
-        rescue Exception => e
-          SolarWindsAPM::API.log_exception(name, e)
-          raise
-        ensure
-          SolarWindsAPM::API.log_exit(name, kvs, protect_op)
-        end
-      end
-
-      # Collect metrics and start tracing a given block of code.
-      #
-      # This will start a trace depending on configuration and probability, detect any exceptions
-      # thrown by the block, and report errors.
-      #
-      # This method is for request entry points where no trace has been started yet
-      # Nested calls to start_trace() will have the inner call override the outer call
-      # The behavior may be unexpected. After a trace is started with start_trace()
-      # trace() should be used to create spans within the started trace
-      #
-      # When start_trace returns control to the calling context, the trace will be
-      # completed and the tracing context will be cleared.
-      #
-      # === Arguments:
-      #
-      # * +name+   - Name for the span to be used as label in the trace view.
-      # * +kvs:+    - (optional) hash containing key/value pairs that will be reported with this span.
-      #              The value of :TransactionName entry will set the transaction_name.
-      # * +headers:+ - hash containing incoming headers to extract w3c trace context
-      #
-      # === Example:
-      #
-      #   def handle_request(request, response)
-      #     # ... code that processes request and response ...
-      #   end
-      #
-      #   def handle_request_with_sw_apm(request, response)
-      #     SolarWindsAPM::SDK.start_trace('custom_trace', kvs: { :TransactionName => 'handle_request' }) do
-      #       handle_request(request, response)
-      #     end
-      #   end
-      #
-      # === Returns:
-      # * The result of the block.
-      #
-      def start_trace(name, kvs: {}, headers: {})
-        start_trace_with_target(name, target: {}, kvs: kvs, headers: headers) { yield }
-      end
-
-      # Collect metrics, trace a given block of code, and assign trace info to target.
-      #
-      # This will start a trace depending on configuration and probability, detect any exceptions
-      # thrown by the block, report errors, and assign an X-Trace to the target.
-      #
-      # The motivating use case for this is HTTP streaming in rails3. We need
-      # access to the exit event's trace id so we can set the header before any
-      # work is done, and before any headers are sent back to the client.
-      #
-      # === Arguments:
-      # * +name+   - Name for the span to be used as label in the trace view.
-      # * +target:+ - (optional) has to respond to #[]=, The target object in which to place the trace information.
-      # * +kvs:+    - (optional) Hash containing key/value pairs that will be reported with this span.
-      # * +headers:+ - (optional) Hash containing incoming headers to extract w3c trace context
-      #
-      # === Example:
-      #
-      #   def handle_request(request, response)
-      #     # ... code that processes request and response ...
-      #   end
-      #
-      #   def handle_request_with_sw_apm(request, response)
-      #     SolarWindsAPM::SDK.start_trace_with_target('rails', headers: request.headers, target: response) do
-      #       handle_request(request, response)
-      #     end
-      #   end
-      #
-      # === Returns:
-      # * The result of the block.
-      #
-      def start_trace_with_target(name, target: {}, kvs: {}, headers: {})
-        return yield unless SolarWindsAPM.loaded
-
-        SolarWindsAPM.transaction_name = kvs.delete('TransactionName') || kvs.delete(:TransactionName)
-
-        SolarWindsAPM::API.log_start(name, kvs, headers)
-        kvs[:Backtrace] && kvs.delete(:Backtrace) # to avoid sending backtrace twice (faster to check presence here)
-
-        # SolarWindsAPM::Event.startTrace creates an Event without an Edge
-        exit_evt = SolarWindsAPM::Event.startTrace(SolarWindsAPM::Context.get)
-
-        result = begin
-          SolarWindsAPM::API.send_metrics(name, kvs) do
-            target['X-Trace'] = SolarWindsAPM::EventUtil.metadataString(exit_evt)
-            yield
-          end
-        rescue Exception => e
-          SolarWindsAPM::API.log_exception(name, e)
-          exit_evt.addEdge(SolarWindsAPM::Context.get)
-          trace_parent = SolarWindsAPM::API.log_end(name, kvs, exit_evt)
-          e.instance_variable_set(:@tracestring, trace_parent)
-          raise
-        end
-
-        exit_evt.addEdge(SolarWindsAPM::Context.get)
-        SolarWindsAPM::API.log_end(name, kvs, exit_evt)
-
-        result
-      end
-
-      ##
-      # Add tracing to a given method
-      #
-      # This instruments the given method so that every time it is called it
-      # will create a span depending on the current context.
-      #
-      # The method can be of any (accessible) type (instance, singleton,
-      # private, protected etc.).
-      #
-      # The motivating use case for this is MetalController methods in Rails,
-      # which can't be auto-instrumented.
-      #
-      # === Arguments:
-      # * +klass+  - The module/class the method belongs to.
-      # * +method+ - The method name as symbol
-      # * +config:+   - (optional) possible keys are:
-      #              :name the name of the span (default: the method name)
-      #              :backtrace true/false (default: false) if true the backtrace will be added to the space
-      # * +kvs:+     - (optional) hash containing key/value pairs that will be reported with this span.
-      #
-      # === Example:
-      #
-      #   module ExampleModule
-      #     def do_sum(a, b)
-      #       a + b
-      #     end
-      #   end
-      #
-      #  SolarWindsAPM::SDK.trace_method(ExampleModule,
-      #                                 :do_sum,
-      #                                 config: {name: 'computation', backtrace: true},
-      #                                 kvs: { CustomKey: "some_info"})
-      #
-      def trace_method(klass, method, config: {}, kvs: {})
-        # If we're on an unsupported platform (ahem Mac), just act
-        # like we did something to nicely play the no-op part.
-        return true unless SolarWindsAPM.loaded
-
-        if !klass.is_a?(Module)
-          SolarWindsAPM.logger.warn "[solarwinds_apm/error] trace_method: Not sure what to do with #{klass}.  Send a class or module."
-          return false
-        end
-
-        if method.is_a?(String)
-          method = method.to_sym
-        elsif !method.is_a?(Symbol)
-          SolarWindsAPM.logger.warn "[solarwinds_apm/error] trace_method: Not sure what to do with #{method}.  Send a string or symbol for method."
-          return false
-        end
-
-        instance_method = klass.instance_methods.include?(method) || klass.private_instance_methods.include?(method)
-        class_method = klass.singleton_methods.include?(method)
-
-        # Make sure the request klass::method exists
-        if !instance_method && !class_method
-          SolarWindsAPM.logger.warn "[solarwinds_apm/error] trace_method: Can't instrument #{klass}.#{method} as it doesn't seem to exist."
-          SolarWindsAPM.logger.warn "[solarwinds_apm/error] #{__FILE__}:#{__LINE__}"
-          return false
-        end
-
-        # Strip '!' or '?' from method if present
-        safe_method_name = method.to_s.chop if method.to_s =~ /\?$|\!$/
-        safe_method_name ||= method
-
-        without_sw_apm = "#{safe_method_name}_without_sw_apm"
-        with_sw_apm    = "#{safe_method_name}_with_sw_apm"
-
-        # Check if already profiled
-        if instance_method && klass.instance_methods.include?(with_sw_apm.to_sym) ||
-          class_method && klass.singleton_methods.include?(with_sw_apm.to_sym)
-          SolarWindsAPM.logger.warn "[solarwinds_apm/error] trace_method: #{klass}::#{method} already instrumented.\n#{__FILE__}:#{__LINE__}"
-          return false
-        end
-
-        report_kvs = kvs.dup
-        if defined?(::AbstractController::Base) && klass.ancestors.include?(::AbstractController::Base)
-          report_kvs[:Controller] = klass.to_s
-          report_kvs[:Action] = method.to_s
-        else
-          klass.is_a?(Class) ? report_kvs[:Class] = klass.to_s : report_kvs[:Module] = klass.to_s
-          report_kvs[:MethodName] = safe_method_name
-        end
-        backtrace = config[:backtrace]
-
-        name = config[:name] || method
-        if instance_method
-          klass.class_eval do
-            define_method(with_sw_apm) do |*args, &block|
-              # if this is a rails controller we want to set the transaction for the outbound metrics
-              if report_kvs[:Controller] && defined?(request) && defined?(request.env)
-                request.env['solarwinds_apm.controller'] = report_kvs[:Controller]
-                request.env['solarwinds_apm.action'] = report_kvs[:Action]
-              end
-
-              SolarWindsAPM::SDK.trace(name, kvs: report_kvs) do
-                report_kvs[:Backtrace] = SolarWindsAPM::API.backtrace if backtrace
-                send(without_sw_apm, *args, &block)
-              end
-            end
-
-            alias_method without_sw_apm, method.to_s
-            alias_method method.to_s, with_sw_apm
-          end
-        elsif class_method
-          klass.define_singleton_method(with_sw_apm) do |*args, &block|
-            SolarWindsAPM::SDK.trace(name, kvs: report_kvs) do
-              report_kvs[:Backtrace] = SolarWindsAPM::API.backtrace if backtrace
-              send(without_sw_apm, *args, &block)
-            end
-          end
-
-          klass.singleton_class.class_eval do
-            alias_method without_sw_apm, method.to_s
-            alias_method method.to_s, with_sw_apm
-          end
-        end
-        true
-      end
-
-      ##
-      # Provide a custom transaction name
-      #
-      # The SolarWindsAPM gem tries to create meaningful transaction names from controller+action
-      # or something similar depending on the framework used. However, you may want to override the
-      # transaction name to better describe your instrumented operation.
-      #
-      # Take note that on the dashboard the transaction name is converted to lowercase, and might be
-      # truncated with invalid characters replaced. Method calls with an empty string or a non-string
-      # argument won't change the current transaction name.
-      #
-      # The configuration +SolarWindsAPM.Config+['transaction_name']+['prepend_domain']+ can be set to
-      # true to have the domain name prepended to the transaction name when an event or a metric are
-      # logged. This is a global setting.
-      #
-      # === Argument:
-      #
-      # * +name+ - A non-empty string with the custom transaction name
-      #
-      # === Example:
-      #
-      #   class DogfoodsController < ApplicationController
-      #
-      #     def create
-      #       @dogfood = Dogfood.new(params.permit(:brand, :name))
-      #       @dogfood.save
-      #
-      #       SolarWindsAPM::SDK.set_transaction_name("dogfoodscontroller.create_for_#{params[:brand]}")
-      #
-      #       redirect_to @dogfood
-      #     end
-      #
-      #   end
-      #
-      # === Returns:
-      # * (String or nil) the current transaction name
-      #
-      def set_transaction_name(name)
-        if name.is_a?(String) && name.strip != ''
-          SolarWindsAPM.transaction_name = name
-        else
-          SolarWindsAPM.logger.debug "[solarwinds_apm/api] Could not set transaction name, provided name is empty or not a String."
-        end
-        SolarWindsAPM.transaction_name
-      end
-
-      # Get the currently set custom transaction name.
-      #
-      # This is provided for testing
-      #
-      # === Returns:
-      # * (String or nil) the current transaction name (without domain prepended)
-      #
-      def get_transaction_name
-        SolarWindsAPM.transaction_name
-      end
-
-      # Determine if this transaction is being traced.
-      #
-      # Tracing puts some extra load on a system, therefore not all transaction are traced.
-      # The +tracing?+ method helps to determine this so that extra work can be avoided when not tracing.
-      #
-      # === Example:
-      #
-      #   kvs = expensive_info_gathering_method if SolarWindsAPM::SDK.tracing?
-      #   SolarWindsAPM::SDK.trace('some_span', kvs: kvs) do
-      #     db_request
-      #   end
-      #
-      def tracing?
-        SolarWindsAPM.tracing?
-      end
-
-      # Wait for SolarWinds to be ready to send traces.
-      #
-      # This may be useful in short lived background processes when it is important to capture
-      # information during the whole time the process is running. Usually SolarWinds doesn't block an
-      # application while it is starting up.
-      #
-      # === Argument:
-      #
-      # * +wait_milliseconds+ (int, default 3000) the maximum time to wait in milliseconds
-      #
-      # === Example:
-      #
-      #   unless SolarWindsAPM::SDK.solarwinds_ready?(10_000)
-      #     Logger.info "SolarWindsAPM not ready after 10 seconds, no metrics will be sent"
-      #   end
-      #
-      def solarwinds_ready?(wait_milliseconds = 3000)
-        return false unless SolarWindsAPM.loaded
-        # These codes are returned by isReady:
-        # OBOE_SERVER_RESPONSE_UNKNOWN 0
-        # OBOE_SERVER_RESPONSE_OK 1
-        # OBOE_SERVER_RESPONSE_TRY_LATER 2
-        # OBOE_SERVER_RESPONSE_LIMIT_EXCEEDED 3
-        # OBOE_SERVER_RESPONSE_INVALID_API_KEY 4
-        # OBOE_SERVER_RESPONSE_CONNECT_ERROR 5
-        SolarWindsAPM::Context.isReady(wait_milliseconds) == 1
-      end
-    end
-
-    extend Tracing
-
-  end
-end

data/lib/solarwinds_apm/support/profiling.rb

@@ -1,25 +0,0 @@
-# Copyright (c) 2020 SolarWinds, LLC.
-# All rights reserved.
-
-module SolarWindsAPM
-
-  # *
-  # * This class only got defined if Init_profiling defined in init_solarwinds_apm.cc
-  class Profiling
-
-    def self.run
-      # TODO
-      #  add back at some point but for now NH is not ready for profiling
-      SolarWindsAPM::Config.profiling = :disabled
-
-      # allow enabling and disabling and setting interval interactively
-      return yield unless SolarWindsAPM::Config.profiling == :enabled && SolarWindsAPM.tracing?
-
-      CProfiler.run(Thread.current, SolarWindsAPM::Config.profiling_interval) do
-        # for some reason `return` is needed here
-        # this is yielded by c-code, but why it needs `return` ... ????
-        return yield
-      end
-    end
-  end
-end

data/lib/solarwinds_apm/support/trace_context.rb

@@ -1,53 +0,0 @@
-# Copyright (c) SolarWinds, LLC.
-# All rights reserved.
-
-module SolarWindsAPM
-
-  class TraceContext
-
-    attr_reader :traceparent, :tracestate, :tracestring, :sw_member_value
-
-    def initialize(headers = {})
-      return if headers.nil? || headers.empty?
-
-      # we won't propagate this context if the traceparent is invalid
-      traceparent, tracestate = ingest(headers)
-      return unless traceparent.is_a?(String) && SolarWindsAPM::TraceString.valid?(traceparent)
-
-      @traceparent = traceparent
-      @tracestate = tracestate
-
-      if @tracestate
-        @sw_member_value = TraceState.sw_member_value(@tracestate)
-        @tracestring = SolarWindsAPM::TraceString.replace_span_id_flags(@traceparent, @sw_member_value)
-      end
-
-      @tracestring ||= @traceparent
-    end
-
-    # these are event kvs, not headers
-    # called by log_start, lets reset to nil if there is no info
-    def add_traceinfo(kvs = {})
-      kvs['sw.tracestate_parent_id'] = @sw_member_value ? @sw_member_value[0...-3] : nil
-      kvs['sw.w3c.tracestate'] = @tracestate ? @tracestate : nil
-      kvs
-    end
-
-    private
-
-    def ingest(headers)
-      traceparent_key = headers.keys.find do |key|
-        key.to_s.downcase =~ /^(http){0,1}[_-]{0,1}traceparent$/
-      end
-
-      tracestate_key = headers.keys.find do |key|
-        key.to_s.downcase =~ /^(http){0,1}[_-]{0,1}tracestate$/
-      end
-
-      return nil, nil unless traceparent_key && tracestate_key
-
-      [headers[traceparent_key], headers[tracestate_key]]
-    end
-
-  end
-end

data/lib/solarwinds_apm/support/trace_state.rb

@@ -1,69 +0,0 @@
-# Copyright (c) 2021 SolarWinds, LLC.
-# All rights reserved.
-
-module SolarWindsAPM
-
-  # test coverage through instrumentation_mocked and inst tests
-  module TraceState
-    class << self
-
-      # prepends our kv to tracestate string
-      # value has to be in W3C format
-      def add_sw_member(tracestate, value)
-        return tracestate unless sw_value_valid?(value)
-
-        result = "#{SW_APM_TRACESTATE_ID}=#{value}#{remove_sw(tracestate)}"
-
-        if result.bytesize > SW_APM_MAX_TRACESTATE_BYTES
-          return reduce_size(result)
-        end
-
-        result
-      end
-
-      # extract the 'sw' tracestate member, parent_id/edge, and flags
-      def sw_member_value(tracestate)
-        regex = /^.*(#{SW_APM_TRACESTATE_ID}=(?<sw_member_value>[a-f0-9]{16}-[a-f0-9]{2})).*$/.freeze
-
-        matches = regex.match(tracestate)
-
-        return nil unless matches
-
-        matches[:sw_member_value]
-      end
-
-      private
-
-      # returns tracestate with leading comma for specific use
-      # in add_sw_member
-      def remove_sw(tracestate)
-        return "" unless tracestate
-        tracestate.gsub!(/,{0,1}\s*#{SW_APM_TRACESTATE_ID}=[^,]*/, '')
-        (tracestate.size > 0 && tracestate[0] != ',') ? ",#{tracestate}" : tracestate
-      end
-
-      # this validates the format of the value of our vendor entry
-      def sw_value_valid?(value)
-        value =~ /^[a-f0-9]{16}-0[01]$/.freeze
-      end
-
-      def reduce_size(tracestate)
-        size = tracestate.bytesize
-        members = tracestate.split(',').reverse
-
-        large_members = members.select { |m| m.bytesize > SW_APM_MAX_TRACESTATE_MEMBER_BYTES }
-        while large_members[0] && size > SW_APM_MAX_TRACESTATE_BYTES
-          size -= large_members[0].bytesize + 1 # add 1 for comma
-          members.delete(large_members.shift)
-        end
-
-        tracestate = members.reverse.join(',')
-        until tracestate.bytesize <= SW_APM_MAX_TRACESTATE_BYTES do
-          tracestate.gsub!(/,[^,]*$/, '')
-        end
-        tracestate
-      end
-
-    end
-  end
-end

data/lib/solarwinds_apm/support/trace_string.rb

@@ -1,89 +0,0 @@
-# Copyright (c) SolarWinds, LLC.
-# All rights reserved.
-
-module SolarWindsAPM
-  module TraceString
-    # This module processes and queries strings of the format defined in
-    # https://www.w3.org/TR/trace-context/#traceparent-header
-
-    # Regexp copied from Ruby OT trace_string.rb
-    REGEXP = /^(?<tracestring>(?<version>[a-f0-9]{2})-(?<trace_id>[a-f0-9]{32})-(?<span_id>[a-f0-9]{16})-(?<flags>[a-f0-9]{2}))$/.freeze
-    private_constant :REGEXP
-
-    class << self
-
-      def split(tracestring)
-        matches = REGEXP.match(tracestring)
-
-        matches
-      end
-
-      # un-initialized (all 0 trace-id) tracestrings are not valid
-      def valid?(tracestring)
-        matches = REGEXP.match(tracestring)
-
-        matches && matches[:trace_id] != ("0" * 32)
-      end
-
-      def sampled?(tracestring)
-        matches = REGEXP.match(tracestring)
-
-        matches && matches[:flags][-1].to_i & 1 == 1
-      end
-
-      def trace_id(tracestring)
-        matches = REGEXP.match(tracestring)
-
-        matches && matches[:trace_id]
-      end
-
-      def span_id(tracestring)
-        matches = REGEXP.match(tracestring)
-
-        matches && matches[:span_id]
-      end
-
-      # Extract and return the span_id and flags
-      def span_id_flags(tracestring)
-        matches = REGEXP.match(tracestring)
-
-        matches && "#{matches[:span_id]}-#{matches[:flags]}"
-      end
-
-      def set_sampled(tracestring)
-        return unless REGEXP.match(tracestring)
-
-        last = tracestring[-2..-1].hex | 0x00000001
-        last = last.to_s(16).rjust(2, '0')
-
-        tracestring[-2..-1] = last
-        tracestring
-      end
-
-      def unset_sampled(tracestring)
-        return unless REGEXP.match(tracestring)
-
-        # shift left and right to set last bit to zero
-        last = tracestring[-2..-1].hex >> 1 << 1
-        last = last.to_s(16).rjust(2, '0')
-
-        tracestring[-2..-1] = last
-        tracestring
-      end
-
-      # !!! garbage in garbage out !!!
-      # span_id_flag are not checked for validity
-      # method is only used in TraceContext, where span_id_flags arg
-      # is created and is either valid or nil
-      def replace_span_id_flags(tracestring, span_id_flags)
-        return unless REGEXP.match(tracestring)
-        return tracestring unless span_id_flags =~ /^[a-f0-9]{16}-[a-f0-9]{2}$/
-
-        matches = REGEXP.match(tracestring)
-
-        "#{matches[:version]}-#{matches[:trace_id]}-#{span_id_flags}"
-      end
-
-    end
-  end
-end