techarch-newrelic_rpm 2.10.2

data/README.md

@@ -0,0 +1,138 @@
+New Relic RPM
+=============
+
+New Relic RPM is a Ruby performance management system, developed by
+[New Relic, Inc](http://www.newrelic.com).  RPM provides you with deep
+information about the performance of your Ruby on Rails or Merb
+application as it runs in production. The New Relic Agent is
+dual-purposed as a either a Rails plugin or a Gem, hosted on
+[github](http://github.com/newrelic/rpm/tree/master) and Rubyforge.
+
+The New Relic Agent runs in one of two modes:
+
+**Developer Mode** : Adds a web interface mapped to /newrelic to your
+  application for showing detailed performance metrics on a page by
+  page basis.
+  
+**Production Mode** : Low overhead instrumentation that captures
+  detailed information on your application running in production and
+  transmits them to rpm.newrelic.com where you can monitor them in
+  real time.
+
+### Supported Environments
+
+* Ruby 1.8.6, 1.8.7 or 1.9.1
+* JRuby
+* Rails 1.2.6 or above
+* Merb 1.0 or above
+
+Developer Mode
+--------------
+
+Developer mode is on by default when you run your application in the
+development environment (but not when it runs in other environments.)
+When running in developer mode, RPM will track the performance of
+every http request serviced by your application, and store in memory
+this information for the last 100 http transactions.
+
+When running in Developer Mode, the RPM will also add a few pages to
+your application that allow you to analyze this performance
+information. (Don't worry--those pages are not added to your
+application's routes when you run in production mode.)
+
+To view this performance information, including detailed SQL statement
+analysis, open `/newrelic` in your web application.  For instance if
+you are running mongrel or thin on port 3000, enter the following into
+your browser:
+
+    http://localhost:3000/newrelic
+
+Production Mode
+---------------
+
+When your application runs in the production environment, the New
+Relic agent runs in production mode. It connects to the New Relic RPM
+service and sends deep performance data to the RPM service for your
+analysis. To view this data, login to
+[http://rpm.newrelic.com](http://rpm.newrelic.com).
+
+NOTE: You must have a valid account and license key to view this data
+online.  Refer to instructions in *Getting Started*, below.
+
+Getting Started
+===============
+
+RPM requires an agent be installed in the application as either a
+Rails plug-in or a gem.  Both are available on RubyForge--instructions
+below.
+
+To use Developer Mode, simply install the gem or plugin into your
+application and follow the instructions below.
+
+To monitor your applications in production, create an account at
+[www.newrelic.com](http://newrelic.com/get-RPM.html).  There you can
+sign up for a free Lite account or one of our paid subscriptions.
+
+Once you receive the welcome e-mail with a license key and
+`newrelic.yml` file, copy the `newrelic.yml` file into your app config
+directory.
+
+### Rails Plug-In Installation
+
+    script/plugin install http://newrelic.rubyforge.org/svn/newrelic_rpm
+   
+### Gem Installation
+
+    sudo gem install newrelic_rpm
+
+For Rails, edit `environment.rb` and add to the initalizer block:
+
+    config.gem "newrelic_rpm" 
+
+The Developer Mode is unavailable when using the gem on Rails versions
+prior to 2.0.
+
+### Merb Support
+
+To monitor a merb app install the newrelic_rpm gem and add
+
+    dependency 'newrelic_rpm'
+
+to your init.rb file.
+
+Current features implemented:
+
+* Standard monitoring, overview pages
+* Error capturing
+* Full Active Record instrumentation, including SQL explains
+* Very limited Data Mapper instrumentation
+* Transaction Traces are implemented but will not be very useful
+  with Data Mapper until more work is done with the Data Mapper
+  instrumentation
+
+Still under development:
+
+* Developer Mode
+* Data Mapper bindings
+
+### Github
+
+The agent is also available on Github under newrelic/rpm.  Fork away!
+
+### Support
+
+Reach out to us--and to fellow RPM users--at
+[support.newrelic.com](http://support.newrelic.com/discussions/support).
+There you'll find documentation, FAQs, and forums where you can submit
+suggestions and discuss RPM with New Relic staff and other users.
+
+Find a bug?  E-mail support@newrelic.com, or post it to
+[support.newrelic.com](http://support.newrelic.com/discussions/support).
+
+Refer to [our website](http://www.newrelic.com/support) for other
+support channels.
+
+Thank you, and may your application scale to infinity plus one.  
+
+Lew Cirne, Founder and CEO<br/>
+New Relic, Inc.

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rubygems'
+require 'lib/new_relic/version.rb'
+require 'echoe'
+
+GEM_NAME = "newrelic_rpm"
+GEM_VERSION = NewRelic::VERSION::STRING
+AUTHOR = "Bill Kayser"
+EMAIL = "bkayser@newrelic.com"
+HOMEPAGE = "http://www.newrelic.com"
+SUMMARY = "New Relic Ruby Performance Monitoring Agent"
+
+Echoe.new(GEM_NAME) do |p|
+  p.author = AUTHOR
+  p.summary = SUMMARY
+  p.url = HOMEPAGE
+  p.email = EMAIL
+  p.project = 'newrelic'
+  p.need_tar_gz = false
+  p.need_gem = true
+  p.ignore_pattern = %w[]
+end
+

data/bin/mongrel_rpm

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'rack'
+require 'rack/handler/mongrel'
+require 'optparse'
+
+port = 3000
+options = { }
+appname = nil
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{File.basename($0)} [options] [app_name]"
+  opts.on("-p", "--port=port", Integer, "default: #{port}") { | port | }
+  opts.on("--[no-]logging", "turn off request logging" ) { | l | options[:logging] = l }
+  opts.on("--license=rpm_license_key", "override license key" ) { | l | options[:license_key] = l }
+  opts.on("--install", "install a newrelic.yml template" ) { | l | options[:install] = true }
+  opts.separator ""
+  opts.separator "app_name is the name of the application where the metrics will be stored"
+  opts.separator ""
+  # The rackup file references this var
+  appname = opts.parse!(ARGV.clone).first
+end
+
+options[:app_name] = appname if appname
+
+ru_file = File.expand_path(File.join(File.dirname(__FILE__), "..", "lib", "new_relic", "rack", "newrelic.ru"))
+rackup_code = File.read ru_file
+builder = Rack::Builder.new { eval rackup_code, binding, ru_file }
+
+options = { :Host => '127.0.0.1', :Port => port }
+Rack::Handler::Mongrel.run(builder.to_app, options) do | server |
+   NewRelic::Control.instance.log! "Started Mongrel listening for '#{NewRelic::Control.instance.app_names.join(" and ")}' data at #{server.host}:#{server.port}" 
+end
+

data/bin/newrelic_cmd

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# executes one of the commands in the new_relic/commands directory
+# pass the name of the command as an argument
+require File.dirname(__FILE__) + '/../lib/new_relic/commands/new_relic_commands'

data/cert/cacert.pem

@@ -0,0 +1,34 @@
+-----BEGIN CERTIFICATE-----
+MIIC5zCCAlACAQEwDQYJKoZIhvcNAQEFBQAwgbsxJDAiBgNVBAcTG1ZhbGlDZXJ0IFZhbGlkYXRp
+b24gTmV0d29yazEXMBUGA1UEChMOVmFsaUNlcnQsIEluYy4xNTAzBgNVBAsTLFZhbGlDZXJ0IENs
+YXNzIDEgUG9saWN5IFZhbGlkYXRpb24gQXV0aG9yaXR5MSEwHwYDVQQDExhodHRwOi8vd3d3LnZh
+bGljZXJ0LmNvbS8xIDAeBgkqhkiG9w0BCQEWEWluZm9AdmFsaWNlcnQuY29tMB4XDTk5MDYyNTIy
+MjM0OFoXDTE5MDYyNTIyMjM0OFowgbsxJDAiBgNVBAcTG1ZhbGlDZXJ0IFZhbGlkYXRpb24gTmV0
+d29yazEXMBUGA1UEChMOVmFsaUNlcnQsIEluYy4xNTAzBgNVBAsTLFZhbGlDZXJ0IENsYXNzIDEg
+UG9saWN5IFZhbGlkYXRpb24gQXV0aG9yaXR5MSEwHwYDVQQDExhodHRwOi8vd3d3LnZhbGljZXJ0
+LmNvbS8xIDAeBgkqhkiG9w0BCQEWEWluZm9AdmFsaWNlcnQuY29tMIGfMA0GCSqGSIb3DQEBAQUA
+A4GNADCBiQKBgQDYWYJ6ibiWuqYvaG9YLqdUHAZu9OqNSLwxlBfw8068srg1knaw0KWlAdcAAxIi
+GQj4/xEjm84H9b9pGib+TunRf50sQB1ZaG6m+FiwnRqP0z/x3BkGgagO4DrdyFNFCQbmD3DD+kCm
+DuJWBQ8YTfwggtFzVXSNdnKgHZ0dwN0/cQIDAQABMA0GCSqGSIb3DQEBBQUAA4GBAFBoPUn0LBwG
+lN+VYH+Wexf+T3GtZMjdd9LvWVXoP+iOBSoh8gfStadS/pyxtuJbdxdA6nLWI8sogTLDAHkY7FkX
+icnGah5xyf23dKUlRWnFSKsZ4UWKJWsZ7uW7EvV/96aNUcPwnXS3qT6gpf+2SQMT2iLM7XGCK5nP
+Orf1LXLI
+-----END CERTIFICATE-----
+
+-----BEGIN CERTIFICATE-----
+MIIC5zCCAlACAQEwDQYJKoZIhvcNAQEFBQAwgbsxJDAiBgNVBAcTG1ZhbGlDZXJ0IFZhbGlkYXRp
+b24gTmV0d29yazEXMBUGA1UEChMOVmFsaUNlcnQsIEluYy4xNTAzBgNVBAsTLFZhbGlDZXJ0IENs
+YXNzIDIgUG9saWN5IFZhbGlkYXRpb24gQXV0aG9yaXR5MSEwHwYDVQQDExhodHRwOi8vd3d3LnZh
+bGljZXJ0LmNvbS8xIDAeBgkqhkiG9w0BCQEWEWluZm9AdmFsaWNlcnQuY29tMB4XDTk5MDYyNjAw
+MTk1NFoXDTE5MDYyNjAwMTk1NFowgbsxJDAiBgNVBAcTG1ZhbGlDZXJ0IFZhbGlkYXRpb24gTmV0
+d29yazEXMBUGA1UEChMOVmFsaUNlcnQsIEluYy4xNTAzBgNVBAsTLFZhbGlDZXJ0IENsYXNzIDIg
+UG9saWN5IFZhbGlkYXRpb24gQXV0aG9yaXR5MSEwHwYDVQQDExhodHRwOi8vd3d3LnZhbGljZXJ0
+LmNvbS8xIDAeBgkqhkiG9w0BCQEWEWluZm9AdmFsaWNlcnQuY29tMIGfMA0GCSqGSIb3DQEBAQUA
+A4GNADCBiQKBgQDOOnHK5avIWZJV16vYdA757tn2VUdZZUcOBVXc65g2PFxTXdMwzzjsvUGJ7SVC
+CSRrCl6zfN1SLUzm1NZ9WlmpZdRJEy0kTRxQb7XBhVQ7/nHk01xC+YDgkRoKWzk2Z/M/VXwbP7Rf
+ZHM047QSv4dk+NoS/zcnwbNDu+97bi5p9wIDAQABMA0GCSqGSIb3DQEBBQUAA4GBADt/UG9vUJSZ
+SWI4OB9L+KXIPqeCgfYrx+jFzug6EILLGACOTb2oWH+heQC1u+mNr0HZDzTuIYEZoDJJKPTEjlbV
+UjP9UNV+mWwD5MlM/Mtsq2azSiGM5bUMMj4QssxsodyamEwCW/POuZ6lcg5Ktz885hZo+L7tdEy8
+W9ViH0Pd
+-----END CERTIFICATE-----
+

data/init.rb

@@ -0,0 +1,38 @@
+# This is the initialization for the RPM Rails plugin
+require 'new_relic/control'
+
+# If you are having problems seeing data, be sure and check the
+# newrelic_agent log files. 
+# 
+# If you can't find any log files and you don't see anything in your
+# application log files, try uncommenting the two lines at the 
+# bottom of this file to verify the plugin is being loaded, 
+# then send the output to support@newrelic.com if you are unable to 
+# resolve the issue.
+
+# Initializer for the NewRelic Agent
+
+# We use this to test the agent to ensure it's not loading classes inappropriately
+#require 'new_relic/agent/patch_const_missing'
+#ClassLoadingWatcher.flag_const_missing = true
+begin
+  # JRuby's glassfish plugin is trying to run the Initializer twice,
+  # which isn't a good thing so we ignore subsequent invocations here.
+  if ! defined?(::NEWRELIC_STARTED)
+    ::NEWRELIC_STARTED = "#{caller.join("\n")}"
+
+    NewRelic::Control.instance.init_plugin(defined?(config) ? {:config => config} : {})
+  else
+    NewRelic::Control.instance.log.debug "Attempt to initialize the plugin twice!"
+    NewRelic::Control.instance.log.debug "Original call: \n#{::NEWRELIC_STARTED}"
+    NewRelic::Control.instance.log.debug "Here we are now: \n#{caller.join("\n")}"
+  end
+rescue => e
+  NewRelic::Control.instance.log! "Error initializing New Relic plugin (#{e})", :error
+  NewRelic::Control.instance.log!  e.backtrace.join("\n"), :error
+  NewRelic::Control.instance.log! "Agent is disabled."
+end
+#ClassLoadingWatcher.flag_const_missing = nil
+
+# ::RAILS_DEFAULT_LOGGER.warn "RPM detected environment: #{NewRelic::Control.instance.local_env.to_s}, RAILS_ENV: #{RAILS_ENV}"
+# ::RAILS_DEFAULT_LOGGER.warn "Enabled? #{NewRelic::Control.instance.agent_enabled?}"

data/install.rb

@@ -0,0 +1,45 @@
+require 'fileutils'
+require 'erb'
+
+def install_newrelic_config_file(license_key="PASTE_YOUR_LICENSE_KEY_HERE")
+  # Install a newrelic.yml file into the local config directory.
+  if File.directory? "config"
+    dest_dir = "config"
+  else
+    dest_dir = File.join(ENV["HOME"],".newrelic") rescue nil
+    FileUtils.mkdir(dest_dir) if dest_dir
+  end
+  
+  src_config_file = File.join(File.dirname(__FILE__),"newrelic.yml")
+  dest_config_file = File.join(dest_dir, "newrelic.yml") if dest_dir
+  
+  if !dest_dir
+    STDERR.puts "Could not find a config or ~/.newrelic directory to locate the default newrelic.yml file"
+  elsif File::exists? dest_config_file
+    STDERR.puts "\nA config file already exists at #{dest_config_file}.\n"
+  else
+    generated_for_user = ""
+    yaml = ERB.new(File.read(src_config_file)).result(binding)
+    File.open( dest_config_file, 'w' ) do |out|
+      out.puts yaml
+    end
+    
+    puts <<-EOF
+
+Installed a default configuration file in #{dest_dir}.
+
+To monitor your application in production mode, sign up for an account
+at www.newrelic.com, and replace the newrelic.yml file with the one
+you receive upon registration.
+
+Please review the README.md file for more information.
+
+E-mail support@newrelic.com with any problems or questions.
+
+    EOF
+  end  
+end
+
+if __FILE__ == $0 || $0 =~ /script\/plugin/
+  install_newrelic_config_file
+end

data/lib/new_relic/agent.rb

@@ -0,0 +1,281 @@
+# = New Relic Agent
+#
+# New Relic RPM is a performance monitoring application for Ruby
+# applications running in production.  For more information on RPM
+# please visit http://www.newrelic.com.
+#
+# The New Relic Agent can be installed in Rails applications to gather
+# runtime performance metrics, traces, and errors for display in a
+# Developer Mode UI (mapped to /newrelic in your application server)
+# or for monitoring and analysis at http://rpm.newrelic.com with just
+# about any Ruby application.
+#
+# For detailed information on configuring or customizing the RPM Agent
+# please visit our {support and documentation site}[http://support.newrelic.com].
+#
+# == Starting the Agent as a Gem
+#
+# For Rails, add:
+#    config.gem 'newrelic_rpm'
+# to your initialization sequence.
+#
+# For merb, do 
+#    dependency 'newrelic_rpm'
+# in the Merb config/init.rb
+#
+# For Sinatra, just require the +newrelic_rpm+ gem and it will
+# automatically detect Sinatra and instrument all the handlers.
+#
+# For other frameworks, or to manage the agent manually, 
+# invoke NewRelic::Agent#manual_start directly.
+#
+# == Configuring the Agent
+# 
+# All agent configuration is done in the <tt>newrelic.yml</tt> file.  This
+# file is by default read from the +config+ directory of the
+# application root and is subsequently searched for in the application
+# root directory, and then in a <tt>~/.newrelic</tt> directory
+#
+# == Using with Rack/Metal
+#
+# To instrument middlewares, refer to the docs in 
+# NewRelic::Agent::Instrumentation::Rack.
+#
+# == Agent API
+#
+# For details on the Agent API, refer to NewRelic::Agent.
+# 
+#
+# :main: lib/new_relic/agent.rb
+module NewRelic
+  # == Agent APIs
+  # This module contains the public API methods for the Agent.
+  #
+  # For adding custom instrumentation to method invocations, refer to 
+  # the docs in the class NewRelic::Agent::MethodTracer.
+  #
+  # For information on how to customize the controller
+  # instrumentation, or to instrument something other than Rails so
+  # that high level dispatcher actions or background tasks show up as
+  # first class operations in RPM, refer to
+  # NewRelic::Agent::Instrumentation::ControllerInstrumentation and
+  # NewRelic::Agent::Instrumentation::ControllerInstrumentation::ClassMethods.
+  #
+  # Methods in this module as well as documented methods in
+  # NewRelic::Agent::MethodTracer and
+  # NewRelic::Agent::Instrumentation::ControllerInstrumentation are
+  # available to applications.  When the agent is not enabled the
+  # method implementations are stubbed into no-ops to reduce overhead.
+  #
+  # Methods and classes in other parts of the agent are not guaranteed
+  # to be available between releases.
+  #
+  # Refer to the online docs at support.newrelic.com to see how to
+  # access the data collected by custom instrumentation, or e-mail
+  # support at New Relic for help.
+  module Agent
+    extend self
+    
+    require 'new_relic/version'
+    require 'new_relic/local_environment'
+    require 'new_relic/stats'
+    require 'new_relic/metric_spec'
+    require 'new_relic/metric_data'
+    require 'new_relic/metric_parser'
+    require 'new_relic/transaction_analysis'
+    require 'new_relic/transaction_sample'
+    require 'new_relic/noticed_error'
+    require 'new_relic/histogram'
+    
+    require 'new_relic/agent/chained_call'
+    require 'new_relic/agent/agent'
+    require 'new_relic/agent/shim_agent'
+    require 'new_relic/agent/method_tracer'
+    require 'new_relic/agent/worker_loop'
+    require 'new_relic/agent/stats_engine'
+    require 'new_relic/agent/collection_helper'
+    require 'new_relic/agent/transaction_sampler'
+    require 'new_relic/agent/error_collector'
+    require 'new_relic/agent/sampler'
+    
+    require 'new_relic/agent/samplers/cpu_sampler'
+    require 'new_relic/agent/samplers/memory_sampler'
+    require 'new_relic/agent/samplers/mongrel_sampler'
+    require 'new_relic/agent/samplers/object_sampler'
+    require 'set'
+    require 'sync'
+    require 'thread'
+    require 'resolv'
+    require 'timeout'
+    
+    # An exception that is thrown by the server if the agent license is invalid.
+    class LicenseException < StandardError; end
+    
+    # An exception that forces an agent to stop reporting until its mongrel is restarted.
+    class ForceDisconnectException < StandardError; end
+      
+    # An exception that forces an agent to restart.
+    class ForceRestartException < StandardError; end
+    
+    # Used to blow out of a periodic task without logging a an error, such as for routine
+    # failures.
+    class IgnoreSilentlyException < StandardError; end
+    
+    # Used for when a transaction trace or error report has too much
+    # data, so we reset the queue to clear the extra-large item
+    class PostTooBigException < IgnoreSilentlyException; end
+    
+    # Reserved for future use.  Meant to represent a problem on the server side.
+    class ServerError < StandardError; end
+
+    class BackgroundLoadingError < StandardError; end
+    
+    @agent = nil
+
+    # The singleton Agent instance.  Used internally.
+    def agent #:nodoc:
+      raise "Plugin not initialized!" if @agent.nil?
+      @agent
+    end
+    
+    def agent= new_instance #:nodoc:
+      @agent = new_instance
+    end
+    
+    alias instance agent #:nodoc:
+
+    # Get or create a statistics gatherer that will aggregate numerical data
+    # under a metric name.
+    #
+    # +metric_name+ should follow a slash separated path convention.  Application
+    # specific metrics should begin with "Custom/".
+    #
+    # Return a NewRelic::Stats that accepts data
+    # via calls to add_data_point(value).
+    def get_stats(metric_name, use_scope=false)
+      @agent.stats_engine.get_stats(metric_name, use_scope)
+    end
+    
+    alias get_stats_no_scope get_stats 
+    
+    # Call this to manually start the Agent in situations where the Agent does
+    # not auto-start.
+    # 
+    # When the app environment loads, so does the Agent. However, the Agent will
+    # only connect to RPM if a web front-end is found. If you want to selectively monitor
+    # ruby processes that don't use web plugins, then call this method in your
+    # code and the Agent will fire up and start reporting to RPM.
+    #
+    # Options are passed in as overrides for values in the newrelic.yml, such
+    # as app_name.  In addition, the option +log+ will take a logger that
+    # will be used instead of the standard file logger.  The setting for
+    # the newrelic.yml section to use (ie, RAILS_ENV) can be overridden
+    # with an :env argument.
+    #
+    def manual_start(options={})
+      raise unless Hash === options
+      # Ignore all args but hash options
+      options.merge! :agent_enabled => true 
+      NewRelic::Control.instance.init_plugin options
+    end
+    
+    # Shutdown the agent.  Call this before exiting.  Sends any queued data
+    # and kills the background thread.
+    def shutdown
+      @agent.shutdown
+    end        
+
+    # This method sets the block sent to this method as a sql obfuscator. 
+    # The block will be called with a single String SQL statement to obfuscate.
+    # The method must return the obfuscated String SQL. 
+    # If chaining of obfuscators is required, use type = :before or :after
+    #
+    # type = :before, :replace, :after
+    #
+    # Example:
+    #
+    #    NewRelic::Agent.set_sql_obfuscator(:replace) do |sql|
+    #       my_obfuscator(sql)
+    #    end
+    # 
+    def set_sql_obfuscator(type = :replace, &block)
+      agent.set_sql_obfuscator type, &block
+    end
+    
+    
+    # This method sets the state of sql recording in the transaction
+    # sampler feature. Within the given block, no sql will be recorded
+    #
+    # usage:
+    #
+    #   NewRelic::Agent.disable_sql_recording do
+    #     ...  
+    #   end
+    #     
+    def disable_sql_recording
+      state = agent.set_record_sql(false)
+      begin
+        yield
+      ensure
+        agent.set_record_sql(state)
+      end
+    end
+    
+    # This method disables the recording of transaction traces in the given
+    # block.  See also #disable_all_tracing  
+    def disable_transaction_tracing
+      state = agent.set_record_tt(false)
+      begin
+        yield
+      ensure
+        agent.set_record_tt(state)
+      end
+    end
+    
+    # Yield to the block without collecting any metrics or traces in any of the
+    # subsequent calls.  If executed recursively, will keep track of the first
+    # entry point and turn on tracing again after leaving that block.
+    # This uses the thread local +newrelic_untrace+
+    def disable_all_tracing
+      agent.push_trace_execution_flag(false)
+      yield
+    ensure
+      agent.pop_trace_execution_flag
+    end
+    
+    # Check to see if we are capturing metrics currently on this thread.
+    def is_execution_traced?
+      Thread.current[:newrelic_untraced].nil? || Thread.current[:newrelic_untraced].last != false      
+    end
+
+    # Set a filter to be applied to errors that RPM will track.
+    # The block should return the exception to track (which could be different from
+    # the original exception) or nil to ignore this exception.
+    #
+    # The block is yielded to with the exception to filter.
+    #
+    def ignore_error_filter(&block)
+      agent.error_collector.ignore_error_filter(&block)
+    end
+    
+    # Record the given error in RPM.  It will be passed through the #ignore_error_filter
+    # if there is one.
+    # 
+    # * <tt>exception</tt> is the exception which will be recorded
+    # * <tt>extra_params</tt> is a hash of name value pairs to appear alongside
+    #   the exception in RPM.
+    #
+    def notice_error(exception, extra_params = {})
+      NewRelic::Agent.agent.error_collector.notice_error(exception, nil, nil, extra_params)
+    end
+
+    # Add parameters to the current transaction trace on the call stack.
+    #
+    def add_custom_parameters(params)
+      agent.add_custom_parameters(params)
+    end
+    
+    alias add_request_parameters add_custom_parameters
+
+  end 
+end