Class: NewRelic::MetricSpec
- Inherits:
-
Object
- Object
- NewRelic::MetricSpec
- Defined in:
- lib/new_relic/metric_spec.rb
Overview
this struct uniquely defines a metric, optionally inside the call scope of another metric
Constant Summary collapse
- MAX_LENGTH =
the maximum length of a metric name or metric scope
255
- LENGTH_RANGE =
(0...MAX_LENGTH)
Instance Attribute Summary collapse
-
#name ⇒ Object
Returns the value of attribute name.
-
#scope ⇒ Object
Returns the value of attribute scope.
Instance Method Summary collapse
- #<=>(o) ⇒ Object
- #==(o) ⇒ Object
- #eql?(o) ⇒ Boolean
- #hash ⇒ Object
-
#initialize(metric_name = '', metric_scope = nil) ⇒ MetricSpec
constructor
Need a “zero-arg” constructor so it can be instantiated from java (using jruby) for sending responses to ruby agents from the java collector.
- #inspect ⇒ Object
-
#sub(pattern, replacement, apply_to_scope = true) ⇒ Object
return a new metric spec if the given regex matches the name or scope.
- #to_json(*a) ⇒ Object
- #to_s ⇒ Object
-
#truncate! ⇒ Object
truncates the name and scope to the MAX_LENGTH.
Constructor Details
#initialize(metric_name = '', metric_scope = nil) ⇒ MetricSpec
Need a “zero-arg” constructor so it can be instantiated from java (using jruby) for sending responses to ruby agents from the java collector.
17 18 19 20 21 22 23 24 |
# File 'lib/new_relic/metric_spec.rb', line 17 def initialize(metric_name = '', metric_scope = nil) self.name = (metric_name || '') && metric_name.to_s[LENGTH_RANGE] if metric_scope self.scope = metric_scope && metric_scope.to_s[LENGTH_RANGE] else self.scope = '' end end |
Instance Attribute Details
#name ⇒ Object
Returns the value of attribute name.
8 9 10 |
# File 'lib/new_relic/metric_spec.rb', line 8 def name @name end |
#scope ⇒ Object
Returns the value of attribute scope.
9 10 11 |
# File 'lib/new_relic/metric_spec.rb', line 9 def scope @scope end |
Instance Method Details
#<=>(o) ⇒ Object
79 80 81 82 83 |
# File 'lib/new_relic/metric_spec.rb', line 79 def <=>(o) namecmp = self.name <=> o.name return namecmp if namecmp != 0 return (self.scope || '') <=> (o.scope || '') end |
#==(o) ⇒ Object
32 33 34 |
# File 'lib/new_relic/metric_spec.rb', line 32 def ==(o) self.eql?(o) end |
#eql?(o) ⇒ Boolean
36 37 38 39 40 41 |
# File 'lib/new_relic/metric_spec.rb', line 36 def eql? o self.class == o.class && name.eql?(o.name) && # coerce scope to a string and compare scope.to_s == o.scope.to_s end |
#hash ⇒ Object
43 44 45 46 47 |
# File 'lib/new_relic/metric_spec.rb', line 43 def hash h = name.hash h ^= scope.hash unless scope.nil? h end |
#inspect ⇒ Object
70 71 72 |
# File 'lib/new_relic/metric_spec.rb', line 70 def inspect "#<NewRelic::MetricSpec '#{name}':'#{scope}'>" end |
#sub(pattern, replacement, apply_to_scope = true) ⇒ Object
return a new metric spec if the given regex matches the name or scope.
50 51 52 53 54 55 56 57 58 59 60 61 62 63 |
# File 'lib/new_relic/metric_spec.rb', line 50 def sub(pattern, replacement, apply_to_scope = true) ::NewRelic::Agent.logger.warn("The sub method on metric specs is deprecated") rescue nil return nil if name !~ pattern && (!apply_to_scope || scope.nil? || scope !~ pattern) new_name = name.sub(pattern, replacement)[LENGTH_RANGE] if apply_to_scope new_scope = (scope && scope.sub(pattern, replacement)[LENGTH_RANGE]) else new_scope = scope end self.class.new new_name, new_scope end |
#to_json(*a) ⇒ Object
74 75 76 77 |
# File 'lib/new_relic/metric_spec.rb', line 74 def to_json(*a) {'name' => name, 'scope' => scope}.to_json(*a) end |
#to_s ⇒ Object
65 66 67 68 |
# File 'lib/new_relic/metric_spec.rb', line 65 def to_s return name if scope.empty? "#{name}:#{scope}" end |
#truncate! ⇒ Object
truncates the name and scope to the MAX_LENGTH
27 28 29 30 |
# File 'lib/new_relic/metric_spec.rb', line 27 def truncate! self.name = name[LENGTH_RANGE] if name && name.size > MAX_LENGTH self.scope = scope[LENGTH_RANGE] if scope && scope.size > MAX_LENGTH end |