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_result ⇒ Object

Returns the value of attribute patch_error_result.



19
20
21
 
# File 'lib/datadog/tracing/contrib/patcher.rb', line 19

def patch_error_result
  @patch_error_result
end

#patch_successful ⇒ Object

Returns the value of attribute patch_successful.



19
20
21
 
# File 'lib/datadog/tracing/contrib/patcher.rb', line 19

def patch_successful
  @patch_successful
end

Instance Method Details

#default_tags ⇒ Object 



66
67
68
69
70
71
 
# File 'lib/datadog/tracing/contrib/patcher.rb', line 66

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) 


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

def on_patch_error(e)
  # Log the error
  Datadog.logger.error("Failed to apply #{patch_name} patch. Cause: #{e} Location: #{Array(e.backtrace).first}")

  @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

#patch ⇒ Object 



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

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_name ⇒ Object 



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

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

#patched? ⇒ Boolean

Returns:

  • (Boolean) 


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

def patched?
  patch_only_once.ran?
end