Class: Datadog::RateByKeySampler

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

Overview

Samples at different rates by key.

Direct Known Subclasses

RateByServiceSampler

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(default_key, default_rate = 1.0, &block) ⇒ RateByKeySampler

Returns a new instance of RateByKeySampler.

Raises:

  • (ArgumentError) 


84
85
86
87
88
89
90
91
92
93
 
# File 'lib/ddtrace/sampler.rb', line 84

def initialize(default_key, default_rate = 1.0, &block)
  raise ArgumentError, 'No resolver given!' unless block

  @default_key = default_key
  @resolver = block
  @mutex = Mutex.new
  @samplers = {}

  set_rate(default_key, default_rate)
end

Instance Attribute Details

#default_key ⇒ Object (readonly)

Returns the value of attribute default_key.



81
82
83
 
# File 'lib/ddtrace/sampler.rb', line 81

def default_key
  @default_key
end

Instance Method Details

#default_sampler ⇒ Object 



99
100
101
 
# File 'lib/ddtrace/sampler.rb', line 99

def default_sampler
  @samplers[default_key]
end

#delete(key) ⇒ Object 



139
140
141
142
143
 
# File 'lib/ddtrace/sampler.rb', line 139

def delete(key)
  @mutex.synchronize do
    @samplers.delete(key)
  end
end

#delete_if(&block) ⇒ Object 



145
146
147
148
149
 
# File 'lib/ddtrace/sampler.rb', line 145

def delete_if(&block)
  @mutex.synchronize do
    @samplers.delete_if(&block)
  end
end

#length ⇒ Object 



151
152
153
 
# File 'lib/ddtrace/sampler.rb', line 151

def length
  @samplers.length
end

#resolve(span) ⇒ Object 



95
96
97
 
# File 'lib/ddtrace/sampler.rb', line 95

def resolve(span)
  @resolver.call(span)
end

#sample!(span) ⇒ Object 



111
112
113
114
115
116
117
 
# File 'lib/ddtrace/sampler.rb', line 111

def sample!(span)
  key = resolve(span)

  @mutex.synchronize do
    @samplers.fetch(key, default_sampler).sample!(span)
  end
end

#sample?(span) ⇒ Boolean

Returns:

  • (Boolean) 


103
104
105
106
107
108
109
 
# File 'lib/ddtrace/sampler.rb', line 103

def sample?(span)
  key = resolve(span)

  @mutex.synchronize do
    @samplers.fetch(key, default_sampler).sample?(span)
  end
end

#sample_rate(span) ⇒ Object 



119
120
121
122
123
124
125
 
# File 'lib/ddtrace/sampler.rb', line 119

def sample_rate(span)
  key = resolve(span)

  @mutex.synchronize do
    @samplers.fetch(key, default_sampler).sample_rate
  end
end

#update(key, rate) ⇒ Object 



127
128
129
130
131
 
# File 'lib/ddtrace/sampler.rb', line 127

def update(key, rate)
  @mutex.synchronize do
    set_rate(key, rate)
  end
end

#update_all(rate_by_key) ⇒ Object 



133
134
135
136
137
 
# File 'lib/ddtrace/sampler.rb', line 133

def update_all(rate_by_key)
  @mutex.synchronize do
    rate_by_key.each { |key, rate| set_rate(key, rate) }
  end
end