Class: Datadog::Pin

Inherits:
Object
  • Object
show all
Defined in:
lib/ddtrace/pin.rb

Overview

A Pin (a.k.a Patch INfo) is a small class which is used to set tracing metadata on a particular traced object. This is useful if you wanted to, say, trace two different database clusters.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(service_name, options = {}) ⇒ Pin

Returns a new instance of Pin.



21
22
23
24
25
26
27
28
29
 
# File 'lib/ddtrace/pin.rb', line 21

def initialize(service_name, options = {})
  @app = options[:app]
  @tags = options[:tags]
  @app_type = options[:app_type]
  @name = nil # this would rarely be overriden as it's really span-specific
  @tracer = options[:tracer] || Datadog.tracer
  @config = options[:config]
  self.service_name = service_name
end

Instance Attribute Details

#app ⇒ Object

Returns the value of attribute app.



14
15
16
 
# File 'lib/ddtrace/pin.rb', line 14

def app
  @app
end

#app_type ⇒ Object

Returns the value of attribute app_type.



16
17
18
 
# File 'lib/ddtrace/pin.rb', line 16

def app_type
  @app_type
end

#config ⇒ Object

Returns the value of attribute config.



19
20
21
 
# File 'lib/ddtrace/pin.rb', line 19

def config
  @config
end

#name ⇒ Object

Returns the value of attribute name.



17
18
19
 
# File 'lib/ddtrace/pin.rb', line 17

def name
  @name
end

#service_name ⇒ Object Also known as: service

Returns the value of attribute service_name.



13
14
15
 
# File 'lib/ddtrace/pin.rb', line 13

def service_name
  @service_name
end

#tags ⇒ Object

Returns the value of attribute tags.



15
16
17
 
# File 'lib/ddtrace/pin.rb', line 15

def tags
  @tags
end

#tracer ⇒ Object

Returns the value of attribute tracer.



18
19
20
 
# File 'lib/ddtrace/pin.rb', line 18

def tracer
  @tracer
end

Class Method Details

.get_from(obj) ⇒ Object 



8
9
10
11
 
# File 'lib/ddtrace/pin.rb', line 8

def self.get_from(obj)
  return nil unless obj.respond_to? :datadog_pin
  obj.datadog_pin
end

Instance Method Details

#enabled? ⇒ Boolean

Returns:

  • (Boolean) 


31
32
33
34
 
# File 'lib/ddtrace/pin.rb', line 31

def enabled?
  return @tracer.enabled if @tracer
  false
end

#onto(obj) ⇒ Object

rubocop:disable Style/TrivialAccessors



37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/ddtrace/pin.rb', line 37

def onto(obj)
  unless obj.respond_to? :datadog_pin=
    obj.instance_exec do
      def datadog_pin=(pin)
        @datadog_pin = pin
      end
    end
  end

  unless obj.respond_to? :datadog_pin
    obj.instance_exec do
      def datadog_pin
        @datadog_pin
      end
    end
  end

  obj.datadog_pin = self
end

#to_s ⇒ Object 



66
67
68
 
# File 'lib/ddtrace/pin.rb', line 66

def to_s
  "Pin(service:#{service},app:#{app},app_type:#{app_type},name:#{name})"
end