RubyGems - honkster-newrelic_rpm - Versions diffs - 2.13.1 - Mend

honkster-newrelic_rpm 2.13.1

Files changed (174) hide show

data/CHANGELOG +462 -0
data/LICENSE +37 -0
data/README.rdoc +172 -0
data/bin/mongrel_rpm +33 -0
data/bin/newrelic +13 -0
data/bin/newrelic_cmd +5 -0
data/cert/cacert.pem +34 -0
data/install.rb +9 -0
data/lib/new_relic/agent.rb +382 -0
data/lib/new_relic/agent/agent.rb +741 -0
data/lib/new_relic/agent/busy_calculator.rb +91 -0
data/lib/new_relic/agent/chained_call.rb +13 -0
data/lib/new_relic/agent/error_collector.rb +131 -0
data/lib/new_relic/agent/instrumentation/active_merchant.rb +18 -0
data/lib/new_relic/agent/instrumentation/active_record_instrumentation.rb +92 -0
data/lib/new_relic/agent/instrumentation/acts_as_solr.rb +45 -0
data/lib/new_relic/agent/instrumentation/authlogic.rb +8 -0
data/lib/new_relic/agent/instrumentation/controller_instrumentation.rb +409 -0
data/lib/new_relic/agent/instrumentation/data_mapper.rb +58 -0
data/lib/new_relic/agent/instrumentation/delayed_job_instrumentation.rb +22 -0
data/lib/new_relic/agent/instrumentation/memcache.rb +40 -0
data/lib/new_relic/agent/instrumentation/merb/controller.rb +26 -0
data/lib/new_relic/agent/instrumentation/merb/errors.rb +9 -0
data/lib/new_relic/agent/instrumentation/metric_frame.rb +319 -0
data/lib/new_relic/agent/instrumentation/net.rb +17 -0
data/lib/new_relic/agent/instrumentation/passenger_instrumentation.rb +22 -0
data/lib/new_relic/agent/instrumentation/rack.rb +98 -0
data/lib/new_relic/agent/instrumentation/rails/action_controller.rb +59 -0
data/lib/new_relic/agent/instrumentation/rails/action_web_service.rb +27 -0
data/lib/new_relic/agent/instrumentation/rails/errors.rb +24 -0
data/lib/new_relic/agent/instrumentation/rails3/action_controller.rb +45 -0
data/lib/new_relic/agent/instrumentation/rails3/errors.rb +21 -0
data/lib/new_relic/agent/instrumentation/sinatra.rb +46 -0
data/lib/new_relic/agent/instrumentation/sunspot.rb +17 -0
data/lib/new_relic/agent/instrumentation/unicorn_instrumentation.rb +10 -0
data/lib/new_relic/agent/method_tracer.rb +350 -0
data/lib/new_relic/agent/sampler.rb +50 -0
data/lib/new_relic/agent/samplers/cpu_sampler.rb +54 -0
data/lib/new_relic/agent/samplers/delayed_job_lock_sampler.rb +37 -0
data/lib/new_relic/agent/samplers/memory_sampler.rb +142 -0
data/lib/new_relic/agent/samplers/object_sampler.rb +24 -0
data/lib/new_relic/agent/shim_agent.rb +25 -0
data/lib/new_relic/agent/stats_engine.rb +24 -0
data/lib/new_relic/agent/stats_engine/metric_stats.rb +118 -0
data/lib/new_relic/agent/stats_engine/samplers.rb +83 -0
data/lib/new_relic/agent/stats_engine/transactions.rb +149 -0
data/lib/new_relic/agent/transaction_sampler.rb +330 -0
data/lib/new_relic/agent/worker_loop.rb +81 -0
data/lib/new_relic/collection_helper.rb +71 -0
data/lib/new_relic/command.rb +85 -0
data/lib/new_relic/commands/deployments.rb +105 -0
data/lib/new_relic/commands/install.rb +81 -0
data/lib/new_relic/control.rb +203 -0
data/lib/new_relic/control/configuration.rb +149 -0
data/lib/new_relic/control/frameworks/external.rb +13 -0
data/lib/new_relic/control/frameworks/merb.rb +24 -0
data/lib/new_relic/control/frameworks/rails.rb +126 -0
data/lib/new_relic/control/frameworks/rails3.rb +60 -0
data/lib/new_relic/control/frameworks/ruby.rb +36 -0
data/lib/new_relic/control/frameworks/sinatra.rb +18 -0
data/lib/new_relic/control/instrumentation.rb +95 -0
data/lib/new_relic/control/logging_methods.rb +74 -0
data/lib/new_relic/control/profiling.rb +24 -0
data/lib/new_relic/control/server_methods.rb +88 -0
data/lib/new_relic/delayed_job_injection.rb +27 -0
data/lib/new_relic/histogram.rb +91 -0
data/lib/new_relic/local_environment.rb +333 -0
data/lib/new_relic/merbtasks.rb +6 -0
data/lib/new_relic/metric_data.rb +42 -0
data/lib/new_relic/metric_parser.rb +136 -0
data/lib/new_relic/metric_parser/action_mailer.rb +9 -0
data/lib/new_relic/metric_parser/active_merchant.rb +26 -0
data/lib/new_relic/metric_parser/active_record.rb +28 -0
data/lib/new_relic/metric_parser/apdex.rb +88 -0
data/lib/new_relic/metric_parser/controller.rb +62 -0
data/lib/new_relic/metric_parser/controller_cpu.rb +38 -0
data/lib/new_relic/metric_parser/errors.rb +6 -0
data/lib/new_relic/metric_parser/external.rb +50 -0
data/lib/new_relic/metric_parser/mem_cache.rb +50 -0
data/lib/new_relic/metric_parser/other_transaction.rb +36 -0
data/lib/new_relic/metric_parser/view.rb +61 -0
data/lib/new_relic/metric_parser/web_frontend.rb +14 -0
data/lib/new_relic/metric_parser/web_service.rb +9 -0
data/lib/new_relic/metric_spec.rb +67 -0
data/lib/new_relic/metrics.rb +9 -0
data/lib/new_relic/noticed_error.rb +24 -0
data/lib/new_relic/rack/developer_mode.rb +257 -0
data/lib/new_relic/rack/metric_app.rb +64 -0
data/lib/new_relic/rack/mongrel_rpm.ru +26 -0
data/lib/new_relic/rack/newrelic.yml +27 -0
data/lib/new_relic/rack_app.rb +6 -0
data/lib/new_relic/recipes.rb +82 -0
data/lib/new_relic/stats.rb +368 -0
data/lib/new_relic/timer_lib.rb +27 -0
data/lib/new_relic/transaction_analysis.rb +119 -0
data/lib/new_relic/transaction_sample.rb +586 -0
data/lib/new_relic/url_rule.rb +14 -0
data/lib/new_relic/version.rb +55 -0
data/lib/new_relic_api.rb +276 -0
data/lib/newrelic_rpm.rb +49 -0
data/lib/tasks/all.rb +4 -0
data/lib/tasks/install.rake +7 -0
data/lib/tasks/tests.rake +15 -0
data/newrelic.yml +246 -0
data/newrelic_rpm.gemspec +254 -0
data/recipes/newrelic.rb +6 -0
data/test/active_record_fixtures.rb +55 -0
data/test/config/newrelic.yml +48 -0
data/test/config/test_control.rb +36 -0
data/test/new_relic/agent/active_record_instrumentation_test.rb +286 -0
data/test/new_relic/agent/agent_controller_test.rb +294 -0
data/test/new_relic/agent/agent_test_controller.rb +77 -0
data/test/new_relic/agent/busy_calculator_test.rb +81 -0
data/test/new_relic/agent/collection_helper_test.rb +125 -0
data/test/new_relic/agent/error_collector_test.rb +163 -0
data/test/new_relic/agent/memcache_instrumentation_test.rb +103 -0
data/test/new_relic/agent/method_tracer_test.rb +340 -0
data/test/new_relic/agent/metric_data_test.rb +53 -0
data/test/new_relic/agent/metric_frame_test.rb +51 -0
data/test/new_relic/agent/mock_scope_listener.rb +23 -0
data/test/new_relic/agent/net_instrumentation_test.rb +77 -0
data/test/new_relic/agent/rpm_agent_test.rb +142 -0
data/test/new_relic/agent/stats_engine/metric_stats_test.rb +79 -0
data/test/new_relic/agent/stats_engine/samplers_test.rb +72 -0
data/test/new_relic/agent/stats_engine/stats_engine_test.rb +184 -0
data/test/new_relic/agent/task_instrumentation_test.rb +188 -0
data/test/new_relic/agent/testable_agent.rb +13 -0
data/test/new_relic/agent/transaction_sample_builder_test.rb +195 -0
data/test/new_relic/agent/transaction_sample_test.rb +192 -0
data/test/new_relic/agent/transaction_sampler_test.rb +385 -0
data/test/new_relic/agent/worker_loop_test.rb +66 -0
data/test/new_relic/control_test.rb +127 -0
data/test/new_relic/deployments_api_test.rb +69 -0
data/test/new_relic/environment_test.rb +75 -0
data/test/new_relic/metric_parser_test.rb +226 -0
data/test/new_relic/metric_spec_test.rb +177 -0
data/test/new_relic/rack/episodes_test.rb +318 -0
data/test/new_relic/shim_agent_test.rb +9 -0
data/test/new_relic/stats_test.rb +312 -0
data/test/new_relic/version_number_test.rb +89 -0
data/test/test_contexts.rb +28 -0
data/test/test_helper.rb +72 -0
data/ui/helpers/developer_mode_helper.rb +359 -0
data/ui/helpers/google_pie_chart.rb +49 -0
data/ui/views/layouts/newrelic_default.rhtml +47 -0
data/ui/views/newrelic/_explain_plans.rhtml +27 -0
data/ui/views/newrelic/_sample.rhtml +20 -0
data/ui/views/newrelic/_segment.rhtml +29 -0
data/ui/views/newrelic/_segment_limit_message.rhtml +1 -0
data/ui/views/newrelic/_segment_row.rhtml +14 -0
data/ui/views/newrelic/_show_sample_detail.rhtml +24 -0
data/ui/views/newrelic/_show_sample_sql.rhtml +20 -0
data/ui/views/newrelic/_show_sample_summary.rhtml +3 -0
data/ui/views/newrelic/_sql_row.rhtml +16 -0
data/ui/views/newrelic/_stack_trace.rhtml +15 -0
data/ui/views/newrelic/_table.rhtml +12 -0
data/ui/views/newrelic/explain_sql.rhtml +43 -0
data/ui/views/newrelic/file/images/arrow-close.png +0 -0
data/ui/views/newrelic/file/images/arrow-open.png +0 -0
data/ui/views/newrelic/file/images/blue_bar.gif +0 -0
data/ui/views/newrelic/file/images/file_icon.png +0 -0
data/ui/views/newrelic/file/images/gray_bar.gif +0 -0
data/ui/views/newrelic/file/images/new-relic-rpm-desktop.gif +0 -0
data/ui/views/newrelic/file/images/new_relic_rpm_desktop.gif +0 -0
data/ui/views/newrelic/file/images/textmate.png +0 -0
data/ui/views/newrelic/file/javascript/jquery-1.4.2.js +6240 -0
data/ui/views/newrelic/file/javascript/transaction_sample.js +120 -0
data/ui/views/newrelic/file/stylesheets/style.css +484 -0
data/ui/views/newrelic/index.rhtml +59 -0
data/ui/views/newrelic/sample_not_found.rhtml +2 -0
data/ui/views/newrelic/show_sample.rhtml +79 -0
data/ui/views/newrelic/show_source.rhtml +3 -0
data/ui/views/newrelic/threads.rhtml +52 -0
metadata +307 -0

data/lib/new_relic/rack/metric_app.rb ADDED

@@ -0,0 +1,64 @@
+require 'fileutils'
+module NewRelic
+  module Rack
+    class MetricApp
+      def initialize(options)
+        if options[:install]
+          src = File.join(File.dirname(__FILE__), "newrelic.yml")
+          require 'new_relic/command'
+          begin
+            NewRelic::Command::Install.new(:quiet => true, :src_file => src).run
+            NewRelic::Agent.logger.info "A newrelic.yml template was copied to #{File.expand_path('.')}."
+            NewRelic::Agent.logger.info "Please add a license key to the file and restart #{$0}"
+            exit 0
+          rescue NewRelic::Command::CommandFailure => e
+            NewRelic::Agent.logger.error e.message
+            exit 1
+          end
+        end
+        options[:app_name] ||= 'EPM Monitor'
+        options[:disable_samplers] = true
+        NewRelic::Agent.manual_start options
+        unless NewRelic::Control.instance.license_key
+          raise "Please add a valid license key to newrelic.yml."
+        end
+      end
+      def call(env)
+        request = ::Rack::Request.new env
+        params = request.params
+        if !(params['uri'] || params['metric'])
+          [400, { 'Content-Type' => 'text/plain' },  "Missing 'uri' or 'metric' parameter: #{params.inspect}" ]
+        elsif !params['value']
+          [400, { 'Content-Type' => 'text/plain' },  "Missing 'value' parameter: #{params.inspect}" ]
+        else
+          NewRelic::Agent.record_transaction( params['value'].to_f, params )
+          ::Rack::Response.new(params.collect { |k, v| "#{k}=#{v} " }.join).finish
+        end
+      end
+    end
+    class Status
+      def call(env)
+        request = ::Rack::Request.new env
+        data_url = "http://#{env['HTTP_HOST']}/metrics/path?value=nnn"
+        body = StringIO.new
+        body.puts "<html><body>"
+        body.puts "<h1>New Relic Actively Monitoring #{NewRelic::Control.instance.app_names.join(' and ')}</h1>"
+        body.puts "<p>To submit a metric value, use <a href='#{data_url}'>#{data_url}</a></p>"
+        body.puts "<h2>Request Details</h2>"
+        body.puts "<dl>"
+        body.puts "<dt>ip<dd>#{request.ip}"
+        body.puts "<dt>host<dd>#{request.host}"
+        body.puts "<dt>path<dd>#{request.url}"
+        body.puts "<dt>query<dd>#{request.query_string}"
+        body.puts "<dt>params<dd>#{request.params.inspect}"
+        body.puts "</dl>"
+        body.puts "<h2>Complete ENV</h2>"
+        body.puts "<ul>"
+        body.puts env.to_a.map{|k,v| "<li>#{k} = #{v}</li>" }.join("\n")
+        body.puts "</ul></body></html>"
+        response = ::Rack::Response.new body.string
+        response.finish
+      end
+    end
+  end
+end

data/lib/new_relic/rack/mongrel_rpm.ru ADDED

@@ -0,0 +1,26 @@
+# This is so that we don't detect a dispatcher like mongrel and think we are
+# monitoring it.
+ENV['NEWRELIC_DISPATCHER'] = 'none'
+$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__), '..','..'))
+require 'new_relic/rack_app'
+# Valid options which may be present in this binding:
+# :license_key   optional license key override
+# :app_name      optional name of app
+# :logging       optional, false to omit request logging to stdout
+# use Rack::CommonLogger unless options[:logging] == false
+# use Rack::ShowExceptions
+# use Rack::Reloader if ENV['RACK_ENV'] == 'development'
+map "/newrelic/record_value" do
+  run NewRelic::Rack::MetricApp.new(options)
+end
+map "/" do
+  run NewRelic::Rack::Status.new
+end

data/lib/new_relic/rack/newrelic.yml ADDED

@@ -0,0 +1,27 @@
+#
+# This file configures the Rack NewRelic Metric Application.  Place a copy of this file
+# in the directory where you start the mongrel_rpm process.
+#
+# <%= generated_for_user %>
+#
+common: &default_settings
+  log_level: info
+  enabled: true
+  # This is the key generated by script/create_admin
+  license_key: '<%= license_key %>'
+  # Replace this with the name of the application feeding
+  # metrics into the Metric application;
+  app_name: Application Monitor
+# Set RACK_ENV to one of the following:
+production:
+  <<: *default_settings
+  app_name: Production Monitor
+staging:
+  <<: *default_settings
+  app_name: Staging Monitor

data/lib/new_relic/rack_app.rb ADDED

@@ -0,0 +1,6 @@
+require 'rack/response'
+require 'newrelic_rpm'
+# Rack middlewares and applications used by New Relic
+require 'new_relic/rack/metric_app'
+require 'new_relic/rack/developer_mode'

data/lib/new_relic/recipes.rb ADDED

@@ -0,0 +1,82 @@
+# 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 RPM.
+# 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 RPM
+    desc "Record a deployment in New Relic RPM (rpm.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
+        # Try getting the changelog from the server.  Then fall back to local changelog
+        # if it doesn't work.  Problem is that I don't know what directory the .git is
+        # in when using git.  I could possibly use the remote cache but i don't know
+        # if that's always there.
+=begin
+        run "cd #{current_release}; #{log_command}" do | io, stream_id, output |
+          changelog = output
+        end
+=end
+        # 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
+        new_revision = rev || source.query_revision(source.head()) do |cmd|
+          logger.debug "executing locally: '#{cmd}'"
+          `#{cmd}`
+        end
+        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 Exception => 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 ADDED

@@ -0,0 +1,368 @@
+module NewRelic
+  module Stats
+    def absent?
+      # guess on absent values
+      call_count == 0
+    end
+    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
+    def average_call_time
+      return 0 if call_count == 0
+      total_call_time / call_count
+    end
+    def average_exclusive_time
+      return 0 if call_count == 0
+      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 |s|
+        self.total_call_time += s.total_call_time
+        self.total_exclusive_time += s.total_exclusive_time
+        self.min_call_time += s.min_call_time
+        self.max_call_time += s.max_call_time
+        #self.call_count += s.call_count - do not add call count because we are stacking these times on top of each other
+        self.sum_of_squares += s.sum_of_squares if s.sum_of_squares
+        self.begin_time = s.begin_time if s.begin_time.to_f < begin_time.to_f || begin_time.to_f == 0.0
+        self.end_time = s.end_time if s.end_time.to_f > end_time.to_f
+      end
+      self
+    end
+    def merge!(other_stats)
+      Array(other_stats).each do |s|
+        self.total_call_time += s.total_call_time
+        self.total_exclusive_time += s.total_exclusive_time
+        self.min_call_time = s.min_call_time if (s.min_call_time < min_call_time && s.call_count > 0) || call_count == 0
+        self.max_call_time = s.max_call_time if s.max_call_time > max_call_time
+        self.call_count += s.call_count
+        self.sum_of_squares += s.sum_of_squares if s.sum_of_squares
+        self.begin_time = s.begin_time if s.begin_time.to_f < begin_time.to_f || begin_time.to_f == 0.0
+        self.end_time = s.end_time if s.end_time.to_f > end_time.to_f
+      end
+      self
+    end
+    def merge(other_stats)
+      stats = self.clone
+      stats.merge! other_stats
+    end
+    # split into an array of timeslices whose
+    # time boundaries start on (begin_time + (n * duration)) and whose
+    # end time ends on (begin_time * (n + 1) * duration), except for the
+    # first and last elements, whose begin time and end time are the begin
+    # and end times of this stats instance, respectively.  Yield to caller
+    # for the code that creates the actual stats instance
+    def split(rollup_begin_time, rollup_period)
+      rollup_begin_time = rollup_begin_time.to_f
+      rollup_begin_time += ((self.begin_time - rollup_begin_time) / rollup_period).floor * rollup_period
+      current_begin_time = self.begin_time
+      current_end_time = rollup_begin_time + rollup_period
+      return [self] if current_end_time >= self.end_time
+      timeslices = []
+      while current_end_time < self.end_time do
+        ts = yield(current_begin_time, current_end_time)
+        if ts
+          ts.fraction_of(self)
+          timeslices << ts
+        end
+        current_begin_time = current_end_time
+        current_end_time = current_begin_time + rollup_period
+      end
+      if self.end_time > current_begin_time
+        percentage = rollup_period / self.duration + (self.begin_time - rollup_begin_time) / rollup_period
+        ts = yield(current_begin_time, self.end_time)
+        if ts
+          ts.fraction_of(self)
+          timeslices << ts
+        end
+      end
+      timeslices
+    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)
+      return 0 if other_stats.total_call_time == 0
+      return (total_call_time / other_stats.total_call_time) * 100.0
+    end
+    # the stat total_call_time is a percent
+    def as_percentage
+      if call_count.zero?
+        0
+      else
+        (total_call_time / call_count) * 100.0
+      end
+    end
+    def duration
+      end_time - begin_time
+    end
+    def calls_per_minute
+      if duration.zero?
+        0
+      else
+        (call_count / duration.to_f) * 60.0
+      end
+    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
+      return 0 if duration == 0
+      total_call_time / duration
+    end
+    def exclusive_time_percentage
+      return 0 if duration == 0
+      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).utc.strftime(format)} UTC, #{'%2.3fs' % duration}; #{'%2i' % call_count} calls #{'%4i' % to_ms(average_call_time)} ms]"
+    end
+    # round all of the values to n decimal points
+    def round!
+      self.total_call_time = round_to_3(total_call_time)
+      self.total_exclusive_time = round_to_3(total_exclusive_time)
+      self.min_call_time = round_to_3(min_call_time)
+      self.max_call_time = round_to_3(max_call_time)
+      self.sum_of_squares = round_to_3(sum_of_squares)
+      self.begin_time = begin_time
+      self.end_time = end_time
+    end
+    # calculate this set of stats to be a percentage fraction
+    # of the provided stats, which has an overlapping time window.
+    # used as a key part of the split algorithm
+    def fraction_of(s)
+      min_end = (end_time < s.end_time ? end_time : s.end_time)
+      max_begin = (begin_time > s.begin_time ? begin_time : s.begin_time)
+      percentage = (min_end - max_begin) / s.duration
+      self.total_exclusive_time = s.total_exclusive_time * percentage
+      self.total_call_time = s.total_call_time * percentage
+      self.min_call_time = s.min_call_time
+      self.max_call_time = s.max_call_time
+      self.call_count = s.call_count * percentage
+      self.sum_of_squares = (s.sum_of_squares || 0) * percentage
+    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
+    private
+    def to_ms(number)
+      (number*1000).round
+    end
+    def round_to_3(val)
+      (val * 1000).round / 1000.0
+    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
+    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
+    def increment_count(value = 1)
+      @call_count += value
+    end
+  end
+  class ScopedMethodTraceStats < MethodTraceStats
+    def initialize(unscoped_stats)
+      super()
+      @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
+    def record_multiple_data_points(total_value, count=1)
+      @unscoped_stats.record_multiple_data_points(total_value, count)
+      super total_value, count
+    end
+    def unscoped_stats
+      @unscoped_stats
+    end
+  end
+end