wd_newrelic_rpm 3.3.4.1

data/lib/new_relic/recipes.rb

@@ -0,0 +1,77 @@
+# When installed as a plugin this is loaded automatically.
+#
+# When installed as a gem, you need to add
+#  require 'new_relic/recipes'
+# to your deploy.rb
+#
+# Defined deploy:notify_rpm which will send information about the deploy to New Relic.
+# The task will run on app servers except where no_release is true.
+# If it fails, it will not affect the task execution or do a rollback.
+#
+make_notify_task = Proc.new do
+
+  namespace :newrelic do
+
+    # on all deployments, notify New Relic
+    desc "Record a deployment in New Relic (newrelic.com)"
+    task :notice_deployment, :roles => :app, :except => {:no_release => true } do
+      rails_env = fetch(:newrelic_rails_env, fetch(:rails_env, "production"))
+      require File.join(File.dirname(__FILE__), 'command.rb')
+      begin
+        # allow overrides to be defined for revision, description, changelog and appname
+        rev = fetch(:newrelic_revision) if exists?(:newrelic_revision)
+        description = fetch(:newrelic_desc) if exists?(:newrelic_desc)
+        changelog = fetch(:newrelic_changelog) if exists?(:newrelic_changelog)
+        appname = fetch(:newrelic_appname) if exists?(:newrelic_appname)
+        if !changelog
+          logger.debug "Getting log of changes for New Relic Deployment details"
+          from_revision = source.next_revision(current_revision)
+          if scm == :git
+            log_command = "git log --no-color --pretty=format:'  * %an: %s' --abbrev-commit --no-merges #{previous_revision}..#{real_revision}"
+          else
+            log_command = "#{source.log(from_revision)}"
+          end
+          changelog = `#{log_command}`
+        end
+        if rev.nil?
+          rev = source.query_revision(source.head()) do |cmd|
+            logger.debug "executing locally: '#{cmd}'"
+            `#{cmd}`
+          end
+          rev = rev[0..6] if scm == :git
+        end
+        new_revision = rev
+        deploy_options = { :environment => rails_env,
+          :revision => new_revision,
+          :changelog => changelog,
+          :description => description,
+          :appname => appname }
+        logger.debug "Uploading deployment to New Relic"
+        deployment = NewRelic::Command::Deployments.new deploy_options
+        deployment.run
+        logger.info "Uploaded deployment information to New Relic"
+      rescue NewRelic::Command::CommandFailure => e
+        logger.info e.message
+      rescue Capistrano::CommandError
+        logger.info "Unable to notify New Relic of the deployment... skipping"
+      rescue => e
+        logger.info "Error creating New Relic deployment (#{e})\n#{e.backtrace.join("\n")}"
+      end
+      # WIP: For rollbacks, let's update the deployment we created with an indication of the failure:
+      # on_rollback do
+      #   run(...)
+      # end
+    end
+  end
+end
+require 'capistrano/version'
+if defined?(Capistrano::Version::MAJOR) && Capistrano::Version::MAJOR < 2
+  STDERR.puts "Unable to load #{__FILE__}\nNew Relic Capistrano hooks require at least version 2.0.0"
+else
+  instance = Capistrano::Configuration.instance
+  if instance
+    instance.load &make_notify_task
+  else
+    make_notify_task.call
+  end
+end

data/lib/new_relic/stats.rb

@@ -0,0 +1,335 @@
+
+module NewRelic
+  module Stats
+    
+    # a stat is absent if its call count equals zero
+    def absent?
+      call_count == 0
+    end
+    
+    # outputs a useful human-readable time given a value in milliseconds
+    def time_str(value_ms)
+      case
+      when value_ms >= 10000
+        "%.1f s" % (value_ms / 1000.0)
+      when value_ms >= 5000
+        "%.2f s" % (value_ms / 1000.0)
+      else
+        "%.0f ms" % value_ms
+      end
+    end
+
+    # makes sure we aren't dividing by zero
+    def checked_calculation(numerator, denominator)
+      if denominator.nil? || denominator == 0
+        0.0
+      else
+        numerator.to_f / denominator
+      end
+    end
+    
+    def average_call_time
+      checked_calculation(total_call_time, call_count)
+    end
+    def average_exclusive_time
+      checked_calculation(total_exclusive_time, call_count)
+    end
+
+    # merge by adding to average response time
+    # - used to compose multiple metrics e.g. dispatcher time + mongrel queue time
+    def sum_merge! (other_stats)
+      Array(other_stats).each do |other|
+        self.sum_attributes(other)
+      end
+      self
+    end
+
+    def sum_attributes(other)
+      update_totals(other)
+      stack_min_max_from(other)
+      self.call_count = [self.call_count, other.call_count].max
+      update_boundaries(other)
+    end
+
+    def stack_min_max_from(other)
+      self.min_call_time += other.min_call_time
+      self.max_call_time += other.max_call_time
+    end
+
+    def update_boundaries(other)
+      self.begin_time = other.begin_time if should_replace_begin_time?(other)
+      self.end_time = other.end_time if should_replace_end_time?(other)
+    end
+
+    def should_replace_end_time?(other)
+      end_time.to_f < other.end_time.to_f
+    end
+
+    def should_replace_begin_time?(other)
+      other.begin_time.to_f < begin_time.to_f || begin_time.to_f == 0.0
+    end
+
+    def update_totals(other)
+      self.total_call_time      += other.total_call_time
+      self.total_exclusive_time += other.total_exclusive_time
+      self.sum_of_squares       += other.sum_of_squares
+    end
+
+    def min_time_less?(other)
+      (other.min_call_time < min_call_time && other.call_count > 0) || call_count == 0
+    end
+
+    def expand_min_max_to(other)
+        self.min_call_time = other.min_call_time if min_time_less?(other)
+        self.max_call_time = other.max_call_time if other.max_call_time > max_call_time
+    end
+
+    def merge_attributes(other)
+      update_totals(other)
+      expand_min_max_to(other)
+      self.call_count += other.call_count
+      update_boundaries(other)
+    end
+
+    def merge!(other_stats)
+      Array(other_stats).each do |other|
+        merge_attributes(other)
+      end
+
+      self
+    end
+
+    def merge(other_stats)
+      stats = self.clone
+      stats.merge!(other_stats)
+    end
+
+
+    def is_reset?
+      call_count == 0 && total_call_time == 0.0 && total_exclusive_time == 0.0
+    end
+
+    def reset
+      self.call_count = 0
+      self.total_call_time = 0.0
+      self.total_exclusive_time = 0.0
+      self.min_call_time = 0.0
+      self.max_call_time = 0.0
+      self.sum_of_squares = 0.0
+      self.begin_time = Time.at(0)
+      self.end_time = Time.at(0)
+    end
+
+    def as_percentage_of(other_stats)
+      checked_calculation(total_call_time, other_stats.total_call_time) * 100.0
+    end
+
+    # the stat total_call_time is a percent
+    def as_percentage
+      average_call_time * 100.0
+    end
+
+    def duration
+      end_time ? (end_time - begin_time) : 0.0
+    end
+
+    def midpoint
+      begin_time + (duration/2)
+    end
+    def calls_per_minute
+      checked_calculation(call_count, duration) * 60
+    end
+
+    def total_call_time_per_minute
+      60.0 * time_percentage
+    end
+
+    def standard_deviation
+      return 0 if call_count < 2 || self.sum_of_squares.nil?
+
+      # Convert sum of squares into standard deviation based on
+      # formula for the standard deviation for the entire population
+      x = self.sum_of_squares - (self.call_count * (self.average_value**2))
+      return 0 if x <= 0
+
+      Math.sqrt(x / self.call_count)
+    end
+
+    # returns the time spent in this component as a percentage of the total
+    # time window.
+    def time_percentage
+      checked_calculation(total_call_time, duration)
+    end
+
+    def exclusive_time_percentage
+      checked_calculation(total_exclusive_time, duration)
+    end
+
+    alias average_value average_call_time
+    alias average_response_time average_call_time
+    alias requests_per_minute calls_per_minute
+
+    def to_s
+      summary
+    end
+
+    # Summary string to facilitate testing
+    def summary
+      format = "%m/%d/%y %I:%M%p"
+      "[#{Time.at(begin_time.to_f).utc.strftime(format)} UTC, #{'%2.3fs' % duration.to_f}; #{'%2i' % call_count.to_i} calls #{'%4i' % average_call_time.to_f}s]"
+    end
+
+    # multiply the total time and rate by the given percentage
+    def multiply_by(percentage)
+      self.total_call_time = total_call_time * percentage
+      self.call_count = call_count * percentage
+      self.sum_of_squares = sum_of_squares * percentage
+
+      self
+    end
+
+    # returns s,t,f
+    def get_apdex
+      [@call_count, @total_call_time.to_i, @total_exclusive_time.to_i]
+    end
+
+    def apdex_score
+      s, t, f = get_apdex
+      (s.to_f + (t.to_f / 2)) / (s+t+f).to_f
+    end
+  end
+
+
+  class StatsBase
+    include Stats
+
+    attr_accessor :call_count
+    attr_accessor :min_call_time
+    attr_accessor :max_call_time
+    attr_accessor :total_call_time
+    attr_accessor :total_exclusive_time
+    attr_accessor :sum_of_squares
+
+    def initialize
+      reset
+    end
+
+    def freeze
+      @end_time = Time.now
+      super
+    end
+
+    def to_json(*a)
+      {'call_count' => call_count,
+        'min_call_time' => min_call_time,
+        'max_call_time' => max_call_time,
+        'total_call_time' => total_call_time,
+        'total_exclusive_time' => total_exclusive_time,
+        'sum_of_squares' => sum_of_squares}.to_json(*a)
+    end
+
+
+    # In this class, we explicitly don't track begin and end time here, to save space during
+    # cross process serialization via xml.  Still the accessor methods must be provided for merge to work.
+    def begin_time=(t)
+    end
+
+    def end_time=(t)
+    end
+
+    def begin_time
+      0.0
+    end
+
+    def end_time
+      0.0
+    end
+  end
+
+
+  class BasicStats < StatsBase
+  end
+
+  class ApdexStats < StatsBase
+
+    def record_apdex_s
+      @call_count += 1
+    end
+
+    def record_apdex_t
+      @total_call_time += 1
+    end
+
+    def record_apdex_f
+      @total_exclusive_time += 1
+    end
+  end
+
+  # Statistics used to track the performance of traced methods
+  class MethodTraceStats < StatsBase
+
+    alias data_point_count call_count
+
+    # record a single data point into the statistical gatherer.  The gatherer
+    # will aggregate all data points collected over a specified period and upload
+    # its data to the NewRelic server
+    def record_data_point(value, exclusive_time = value)
+      @call_count += 1
+      @total_call_time += value
+      @min_call_time = value if value < @min_call_time || @call_count == 1
+      @max_call_time = value if value > @max_call_time
+      @total_exclusive_time += exclusive_time
+
+      @sum_of_squares += (value * value)
+      self
+    end
+
+    alias trace_call record_data_point
+    
+    # Records multiple data points as one method call - this handles
+    # all the aggregation that would be done with multiple
+    # record_data_point calls
+    def record_multiple_data_points(total_value, count=1)
+      return record_data_point(total_value) if count == 1
+      @call_count += count
+      @total_call_time += total_value
+      avg_val = total_value / count
+      @min_call_time = avg_val if avg_val < @min_call_time || @call_count == count
+      @max_call_time = avg_val if avg_val > @max_call_time
+      @total_exclusive_time += total_value
+      @sum_of_squares += (avg_val * avg_val) * count
+      self
+    end
+    
+    # increments the call_count by one
+    def increment_count(value = 1)
+      @call_count += value
+    end
+    
+    # outputs a human-readable version of the MethodTraceStats object
+    def inspect
+      "#<NewRelic::MethodTraceStats #{summary} >"
+    end
+
+  end
+
+  class ScopedMethodTraceStats < MethodTraceStats
+    attr_accessor :unscoped_stats
+    def initialize(unscoped_stats)
+      super()
+      self.unscoped_stats = unscoped_stats
+    end
+    def trace_call(call_time, exclusive_time = call_time)
+      unscoped_stats.trace_call call_time, exclusive_time
+      super call_time, exclusive_time
+    end
+    # Records multiple data points as one method call - this handles
+    # all the aggregation that would be done with multiple
+    # trace_call calls    
+    def record_multiple_data_points(total_value, count=1)
+      unscoped_stats.record_multiple_data_points(total_value, count)
+      super total_value, count
+    end
+  end
+end
+

data/lib/new_relic/timer_lib.rb

@@ -0,0 +1,27 @@
+# Copyright:  (C) 2008 David Vollbracht & Philippe Hanrigou
+
+# This code was borrowed from the system_timer gem under the terms
+# of the Ruby license.  It has been slightly modified.
+
+# Defines the constant TimerLib to the appropriate timeout library
+module NewRelic #:nodoc:
+
+  begin
+    # Try to use the SystemTimer gem instead of Ruby's timeout library
+    # when running on Ruby 1.8.x. See:
+    #   http://ph7spot.com/articles/system_timer
+    # We don't want to bother trying to load SystemTimer on jruby,
+    # ruby 1.9+ and rbx.
+    if !defined?(RUBY_ENGINE) || (RUBY_ENGINE == 'ruby' && RUBY_VERSION < '1.9.0')
+      require 'system_timer'
+      TimerLib = SystemTimer
+    else
+      require 'timeout'
+      TimerLib = Timeout
+    end
+  rescue LoadError => e
+    require 'timeout'
+    TimerLib = Timeout
+  end
+
+end

data/lib/new_relic/transaction_analysis.rb

@@ -0,0 +1,77 @@
+require 'new_relic/transaction_analysis/segment_summary'
+# Add these methods to TransactionSample that enable performance analysis in the user interface.
+module NewRelic
+  module TransactionAnalysis
+    def database_time
+      time_percentage(/^Database\/.*/)
+    end
+
+    def render_time
+      time_percentage(/^View\/.*/)
+    end
+
+    # return the data that breaks down the performance of the transaction
+    # as an array of SegmentSummary objects.  If a limit is specified, then
+    # limit the data set to the top n
+    def breakdown_data(limit = nil)
+      metric_hash = {}
+      each_segment_with_nest_tracking do |segment|
+        unless segment == root_segment
+          metric_name = segment.metric_name
+          metric_hash[metric_name] ||= SegmentSummary.new(metric_name, self)
+          metric_hash[metric_name] << segment
+          metric_hash[metric_name]
+        end
+      end
+
+      data = metric_hash.values
+
+      data.sort! do |x,y|
+        y.exclusive_time <=> x.exclusive_time
+      end
+
+      if limit && data.length > limit
+        data = data[0..limit - 1]
+      end
+
+      # add one last segment for the remaining time if any
+      remainder = duration
+      data.each do |segment|
+        remainder -= segment.exclusive_time
+      end
+
+      if (remainder*1000).round > 0
+        remainder_summary = SegmentSummary.new('Remainder', self)
+        remainder_summary.total_time = remainder_summary.exclusive_time = remainder
+        remainder_summary.call_count = 1
+        data << remainder_summary
+      end
+
+      data
+    end
+
+    # return an array of sql statements executed by this transaction
+    # each element in the array contains [sql, parent_segment_metric_name, duration]
+    def sql_segments(show_non_sql_segments = true)
+      segments = []
+      each_segment do |segment|
+        segments << segment if segment[:sql] || segment[:sql_obfuscated] || (show_non_sql_segments && segment[:key])
+      end
+      segments
+    end
+
+    private
+    def time_percentage(regex)
+      total = 0
+      each_segment do |segment|
+        if regex =~ segment.metric_name
+          total += segment.duration
+        end
+      end
+      fraction = 100.0 * total / duration
+      # percent value rounded to two digits:
+      return (100 * fraction).round / 100.0
+    end
+  end
+end
+