Module: Datadog::Tracing::Contrib::Patcher::CommonMethods

Defined in:
lib/datadog/tracing/contrib/patcher.rb

Overview

Prepended instance methods for all patchers

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#patch_error_resultObject

Returns the value of attribute patch_error_result.



22
23
24
# File 'lib/datadog/tracing/contrib/patcher.rb', line 22

def patch_error_result
  @patch_error_result
end

#patch_successfulObject

Returns the value of attribute patch_successful.



22
23
24
# File 'lib/datadog/tracing/contrib/patcher.rb', line 22

def patch_successful
  @patch_successful
end

Instance Method Details

#default_tagsObject



69
70
71
72
73
74
# File 'lib/datadog/tracing/contrib/patcher.rb', line 69

def default_tags
  ["patcher:#{patch_name}"].tap do |tags|
    tags << "target_version:#{target_version}" if respond_to?(:target_version) && !target_version.nil?
    super.each { |t| tags << t } if defined?(super)
  end
end

#on_patch_error(e) ⇒ Object

Processes patching errors. This default implementation logs the error and reports relevant metrics.

Parameters:

  • e (Exception)


52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
# File 'lib/datadog/tracing/contrib/patcher.rb', line 52

def on_patch_error(e)
  Datadog.logger.error("Failed to apply #{patch_name} patch. Cause: #{e} Location: #{Array(e.backtrace).first}")
  Datadog::Core::Telemetry::Logger.report(e, description: "Failed to apply #{patch_name} patch")

  @patch_error_result = {
    type: e.class.name,
    message: e.message,
    line: Array(e.backtrace).first
  }

  # Emit a metric
  tags = default_tags
  tags << "error:#{e.class.name}"

  Datadog.health_metrics.error_instrumentation_patch(1, tags: tags)
end

#patchObject



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# File 'lib/datadog/tracing/contrib/patcher.rb', line 34

def patch
  return unless defined?(super)

  patch_only_once.run do
    begin
      super.tap do
        # Emit a metric
        Datadog.health_metrics.instrumentation_patched(1, tags: default_tags)
        @patch_successful = true
      end
    rescue StandardError => e
      on_patch_error(e)
    end
  end
end

#patch_nameObject



26
27
28
# File 'lib/datadog/tracing/contrib/patcher.rb', line 26

def patch_name
  self.class != Class && self.class != Module ? self.class.name : name
end

#patched?Boolean

Returns:

  • (Boolean)


30
31
32
# File 'lib/datadog/tracing/contrib/patcher.rb', line 30

def patched?
  patch_only_once.ran?
end