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.
13 14 15 16 17 18 19 20 |
# File 'lib/new_relic/metric_spec.rb', line 13 def initialize(metric_name = '', metric_scope = nil) self.name = (metric_name || '') && metric_name[LENGTH_RANGE] if metric_scope self.scope = metric_scope && metric_scope[LENGTH_RANGE] else self.scope = '' end end |
Instance Attribute Details
#name ⇒ Object
Returns the value of attribute name.
4 5 6 |
# File 'lib/new_relic/metric_spec.rb', line 4 def name @name end |
#scope ⇒ Object
Returns the value of attribute scope.
5 6 7 |
# File 'lib/new_relic/metric_spec.rb', line 5 def scope @scope end |
Instance Method Details
#<=>(o) ⇒ Object
75 76 77 78 79 |
# File 'lib/new_relic/metric_spec.rb', line 75 def <=>(o) namecmp = self.name <=> o.name return namecmp if namecmp != 0 return (self.scope || '') <=> (o.scope || '') end |
#==(o) ⇒ Object
28 29 30 |
# File 'lib/new_relic/metric_spec.rb', line 28 def ==(o) self.eql?(o) end |
#eql?(o) ⇒ Boolean
32 33 34 35 36 37 |
# File 'lib/new_relic/metric_spec.rb', line 32 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
39 40 41 42 43 |
# File 'lib/new_relic/metric_spec.rb', line 39 def hash h = name.hash h ^= scope.hash unless scope.nil? h end |
#inspect ⇒ Object
66 67 68 |
# File 'lib/new_relic/metric_spec.rb', line 66 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.
46 47 48 49 50 51 52 53 54 55 56 57 58 59 |
# File 'lib/new_relic/metric_spec.rb', line 46 def sub(pattern, replacement, apply_to_scope = true) NewRelic::Control.instance.log.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
70 71 72 73 |
# File 'lib/new_relic/metric_spec.rb', line 70 def to_json(*a) {'name' => name, 'scope' => scope}.to_json(*a) end |
#to_s ⇒ Object
61 62 63 64 |
# File 'lib/new_relic/metric_spec.rb', line 61 def to_s return name if scope.empty? "#{name}:#{scope}" end |
#truncate! ⇒ Object
truncates the name and scope to the MAX_LENGTH
23 24 25 26 |
# File 'lib/new_relic/metric_spec.rb', line 23 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 |