# encoding: utf-8 # This file is distributed under New Relic's license terms. # See https://github.com/newrelic/rpm/blob/master/LICENSE for complete details. require 'new_relic/agent/internal_agent_error' # this struct uniquely defines a metric, optionally inside # the call scope of another metric class NewRelic::MetricSpec attr_accessor :name attr_accessor :scope # the maximum length of a metric name or metric scope MAX_LENGTH = 255 LENGTH_RANGE = (0...MAX_LENGTH) # Need a "zero-arg" constructor so it can be instantiated from java (using # jruby) for sending responses to ruby agents from the java collector. # 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 class InvalidScopeSettingError < NewRelic::Agent::InternalAgentError def initialize(name, scope) super("Attempted to set scope for #{name} to #{scope.inspect}, ignoring.") end end def scope=(s) if s.nil? || s == false NewRelic::Agent.instance.error_collector.notice_agent_error(InvalidScopeSettingError.new(@name, s)) else @scope = s end end # truncates the name and scope to the MAX_LENGTH 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 def ==(o) self.eql?(o) end 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 def hash h = name.hash h ^= scope.hash unless scope.nil? h end # return a new metric spec if the given regex # matches the name or scope. 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 def to_s return name if scope.empty? "#{name}:#{scope}" end def inspect "#" end def to_json(*a) {'name' => name, 'scope' => scope}.to_json(*a) end def <=>(o) namecmp = self.name <=> o.name return namecmp if namecmp != 0 return (self.scope || '') <=> (o.scope || '') end end