sundawg_newrelic_rpm 3.5.8.1

data/GUIDELINES_FOR_CONTRIBUTING.md

@@ -0,0 +1,76 @@
+# Guidelines for Contributing Code
+
+At New Relic we welcome community code contributions to the Ruby Agent, and have
+taken effort to make this process easy for both contributors and our development
+team.
+
+When contributing keep in mind that the agent runs in a wide variety of ruby
+language implementations (e.g. 1.8.6, 1.8.7, 1.9.x, jruby, etc.) as well as a
+wide variety of application environments (e.g. rails, sinatra, roll-your-own,
+etc., etc.)
+
+Because of this we need to be more defensive in our coding practices than most
+projects.  Syntax must be compatible with all supported ruby implementations
+(e.g. no 1.9 specific hash syntax) and we can't assume the presence of any
+specific libraries such as `ActiveSupport`.
+
+## Testing
+
+The agent includes a suite of unit and functional tests which should be used to
+verify your changes don't break existing functionality.
+
+Unit tests are stored in the `test/new_relic` directory.
+
+Functional tests are stored in the `test/multiverse` directory.
+
+### Running Tests
+
+Running the test suite is simple.  Just invoke:
+
+    bundle
+    bundle exec rake
+
+This will run the unit tests in standalone mode, bootstrapping a basic Rails
+3.2 environment for the agent to instrument then executing the test suite.
+
+These tests are setup to run automatically in
+[travis-ci](https://travis-ci.org/newrelic/rpm) under several Ruby implementations.
+When you've pushed your changes to github you can confirm that the travis-ci
+build passes for your fork of the codebase.
+
+Additionally, our own CI jobs runs these tests under multiple versions of Rails to
+verify compatibility.
+
+### Writing Tests
+
+For most contributions it is strongly recommended to add additional tests which
+exercise your changes.
+
+This helps us efficiently incorporate your changes into our mainline codebase
+and provides a safeguard that your change won't be broken by future development.
+
+There are some rare cases where code changes do not result in changed
+functionality (e.g. a performance optimization) and new tests are not required.
+In general, including tests with your pull request dramatically increases the
+chances it will be accepted.
+
+### Functional Testing
+
+For cases where the unit test environment is not sufficient for testing a
+change (e.g. instrumentation for a non-rails framework, not available in the
+unit test environment), we have a functional testing suite called multiverse.
+These tests can be run by invoking:
+
+    bundle
+    bundle exec rake test:multiverse
+
+More details are available in
+[test/multiverse/README.md](https://github.com/newrelic/rpm/blob/master/test/multiverse/README.md).
+
+### And Finally...
+
+You are welcome to send pull requests to us - however, by doing so you agree
+that you are granting New Relic a non-exclusive, non-revokable, no-cost license
+to use the code, algorithms, patents, and ideas in that code in our products if
+we so choose. You also agree the code is provided as-is and you provide no
+warranties as to its fitness or correctness for any purpose.

data/Gemfile

@@ -0,0 +1,20 @@
+source 'https://rubygems.org'
+
+group :development do
+  # require 0.9.2.2.
+  # There's problems with the test task in rake 10
+  # https://github.com/jimweirich/rake/issues/144
+  gem 'rake', '0.9.2.2'
+  if RUBY_VERSION > '1.9.0'
+    gem 'mocha', '~>0.13.0'
+  else
+    gem 'mocha', '~>0.12.0'
+  end
+  gem 'shoulda', '~>3.0.1'
+  gem 'sdoc-helpers'
+  gem 'rdoc', '>= 2.4.2'
+  gem 'rails', '~>3.2.0'
+  gem 'sqlite3', :platform => 'mri'
+  gem 'activerecord-jdbcsqlite3-adapter', :platform => 'jruby'
+  gem 'jruby-openssl', :platform => 'jruby'
+end

data/LICENSE

@@ -0,0 +1,87 @@
+This product includes jquery written by John Resig
+and distributed under an MIT license.
+See https://github.com/jquery/jquery/blob/master/MIT-LICENSE.txt
+
+    Copyright (c) 2011 John Resig, http://jquery.com/
+
+    Permission is hereby granted, free of charge, to any person obtaining
+    a copy of this software and associated documentation files (the
+    "Software"), to deal in the Software without restriction, including
+    without limitation the rights to use, copy, modify, merge, publish,
+    distribute, sublicense, and/or sell copies of the Software, and to
+    permit persons to whom the Software is furnished to do so, subject to
+    the following conditions:
+
+    The above copyright notice and this permission notice shall be
+    included in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+    LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+    OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+    WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+It also includes source derived from 'okjson' by Keith Rarick, distributed
+under the MIT license.
+See https://github.com/kr/okjson/blob/bdd1113/okjson.rb#L3-21
+
+    Copyright 2011, 2012 Keith Rarick
+    
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+    
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+    
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+All other components of this product are
+Copyright (c) 2008-2012 New Relic, Inc.  All rights reserved.
+
+Certain inventions disclosed in this file may be claimed within
+patents owned or patent applications filed by New Relic, Inc. or third
+parties.
+
+Subject to the terms of this notice, New Relic grants you a
+nonexclusive, nontransferable license, without the right to
+sublicense, to (a) install and execute one copy of these files on any
+number of workstations owned or controlled by you and (b) distribute
+verbatim copies of these files to third parties.  As a condition to the
+foregoing grant, you must provide this notice along with each copy you
+distribute and you must not remove, alter, or obscure this notice. All
+other use, reproduction, modification, distribution, or other
+exploitation of these files is strictly prohibited, except as may be set
+forth in a separate written license agreement between you and New
+Relic.  The terms of any such license agreement will control over this
+notice.  The license stated above will be automatically terminated and
+revoked if you exceed its scope or violate any of the terms of this
+notice.
+
+This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of New Relic, except as
+required for reasonable and customary use in describing the origin of
+this file and reproducing the content of this notice.  You may not
+mark or brand this file with any trade name, trademarks, service
+marks, or product names other than the original brand (if any)
+provided by New Relic.
+
+Unless otherwise expressly agreed by New Relic in a separate written
+license agreement, these files are provided AS IS, WITHOUT WARRANTY OF
+ANY KIND, including without any implied warranties of MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, TITLE, or NON-INFRINGEMENT.  As a
+condition to your use of these files, you are solely responsible for
+such use. New Relic will have no liability to you for direct,
+indirect, consequential, incidental, special, or punitive damages or
+for lost profits or data.

data/README.md

@@ -0,0 +1,195 @@
+# New Relic Ruby Agent
+
+New Relic is a performance management system, developed by
+New Relic, Inc (http://www.newrelic.com).  It provides you with deep
+information about the performance of your Rails or Ruby
+application as it runs in production. The New Relic Ruby Agent is
+dual-purposed as a either a Rails plugin or a Gem, hosted on
+[github](http://github.com/newrelic/rpm/tree/master).
+
+The New Relic Ruby Agent runs in one of two modes:
+
+#### Production Mode
+
+Low overhead instrumentation that captures detailed information on
+your application running in production and transmits them to
+newrelic.com where you can monitor them in real time.
+
+#### Developer Mode
+
+A Rack middleware that maps `/newrelic` to an application for showing
+detailed performance metrics on a page by page basis.  Installed
+automatically in Rails applications.
+
+## Supported Environments
+
+* Ruby 1.8.6, 1.8.7, REE, 1.9.x
+* JRuby 1.6 and 1.7
+* Rails 2.0 or later for Production Mode
+* Rails 2.3 or later for Developer Mode
+* Sinatra
+* Rack
+
+Any Rack based framework should work but may not be tested.  Install
+the Ruby Agent as a gem and add the Developer Mode middleware if
+desired.  Report any problems to support@newrelic.com.
+
+You can also monitor non-web applications. Refer to the "Other
+Environments" section under "Getting Started".
+
+## Contributing Code
+
+We welcome code contributions (in the form of pull requests) from our user
+community.  Before submitting a pull request please review
+[GUIDELINES_FOR_CONTRIBUTING](https://github.com/newrelic/rpm/blob/master/GUIDELINES_FOR_CONTRIBUTING.md).
+
+Following these helps us efficiently review and incorporate your contribution
+and avoid breaking your code with future changes to the agent.
+
+
+## Getting Started
+
+Install the Ruby Agent as a gem.
+
+    gem install newrelic_rpm
+
+Or add it to your project's Gemfile.
+
+    gem 'newrelic_rpm'
+
+To monitor your applications in production, create an account at
+http://newrelic.com/ .  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.
+
+The initial configuration is done in the `newrelic.yml` 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 `~/.newrelic` directory.  Once you're up and running you can
+enable Server Side Config and manage your newrelic configuation from the web
+UI.
+
+#### Rails Installation
+
+You can install the agent as a Gem:
+
+For Bundler:
+
+Add the following line to your Gemfile:
+
+    gem 'newrelic_rpm'
+
+For Rails 2.x without Bundler:
+
+edit `environment.rb` and add to the initalizer block:
+
+    config.gem "newrelic_rpm"
+
+#### Sinatra Installation
+
+To use the Ruby Agent with a Sinatra app, add
+
+    require 'newrelic_rpm'
+
+in your Sinatra app, below the Sinatra require directive.
+
+Then make sure you set `RACK_ENV` to the environment corresponding to the
+configuration definitions in the newrelic.yml file; e.g., development,
+staging, production, etc.
+
+To use Developer Mode in Sinatra, add `NewRelic::Rack::DeveloperMode` to
+the middleware stack.  See the `config.ru` sample below.
+
+#### Other Environments
+
+You can use the Ruby Agent to monitor any Ruby application.  Add
+
+    require 'newrelic_rpm'
+
+to your startup sequence and then manually start the agent using
+
+    NewRelic::Agent.manual_start
+
+To instrument Rack based applications, refer to the docs in
+`NewRelic::Agent::Instrumentation::Rack`.
+
+Refer to the [New Relic's Docs](http://newrelic.com/docs) for details on how to
+monitor other web frameworks, background jobs, and daemons.
+
+The Ruby Agent provides an API that allows custom instrumentation of additional
+frameworks.  You can find a list of community created intrumentation plugins
+(e.g. [newrelic-redis](https://github.com/evanphx/newrelic-redis)) in the
+[RPM Contrib README](https://github.com/newrelic/rpm_contrib/blob/master/README.md#new-relic-ruby-agent-plugins-seperate-projects).
+
+## Developer Mode
+
+When running the Developer Mode, the Ruby Agent will track the
+performance of every HTTP request serviced by your application, and
+store in memory this information for the last 100 HTTP transactions.
+
+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
+
+Developer Mode is only initialized if the `developer_mode` setting in
+the newrelic.yml file is set to true.  By default, it is turned off in
+all environments but `development`.
+
+#### Developer Mode in Rails
+
+Developer Mode is available automatically in Rails Applications based
+on Rails 2.3 and later.  No additional configuration is required. When
+your application starts and `developer_mode` is enabled, the Ruby
+Agent injects a middleware into your Rails middleware stack.
+
+For earlier versions of Rails that support Rack, you can use
+a `config.ru` as below.
+
+#### Developer Mode in Rack Applications
+
+Developer Mode is available for any Rack based application such as
+Sinatra by installing the NewRelic::Rack::DeveloperMode
+middleware. This middleware passes all requests that do not start with
+/newrelic.
+
+Here's an example entry for Developer Mode in a `config.ru` file:
+
+    require 'new_relic/rack/developer_mode'
+    use NewRelic::Rack::DeveloperMode
+
+## Production Mode
+
+When your application runs in the production environment, the New
+Relic agent runs in production mode. It connects to the New Relic
+service and sends deep performance data to the UI for your
+analysis. To view this data, log in to 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*.
+
+
+## Support
+
+Reach out to us--and to fellow users--at
+[support.newrelic.com](http://support.newrelic.com/).
+There you'll find documentation, FAQs, and forums where you can submit
+suggestions and discuss New Relic with staff and other users.
+
+Also available is community support on IRC: we generally use #newrelic
+on irc.freenode.net
+
+Find a bug?  E-mail support@newrelic.com, or post it to
+
+[support.newrelic.com](http://support.newrelic.com/).
+
+Thank you, and may your application scale to infinity plus one.
+
+Lew Cirne, Founder and CEO
+
+New Relic, Inc.

data/Rakefile

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'rake/testtask'
+require "#{File.dirname(__FILE__)}/lib/new_relic/version.rb"
+require "#{File.dirname(__FILE__)}/lib/tasks/all.rb"
+
+task :default => :test
+
+task :test => ['test:newrelic']
+
+namespace :test do
+  desc "Run all tests"
+  task :all => %w{newrelic multiverse}
+
+  agent_home = File.expand_path(File.dirname(__FILE__))
+
+  desc "Run functional test suite for newrelic"
+  task :multiverse, [:suite, :mode] => [] do |t, args|
+    args.with_defaults(:suite => "", :mode => "")
+    if args.mode == "run_one"
+      puts `#{agent_home}/test/multiverse/script/run_one #{args.suite}`
+    else
+      ruby "#{agent_home}/test/multiverse/script/runner #{args.suite}"
+    end
+  end
+
+  desc "Test the multiverse testing framework by executing tests in test/multiverse/test. Get meta with it."
+  task 'multiverse:self', [:suite, :mode] => [] do |t, args|
+    args.with_defaults(:suite => "", :mode => "")
+    puts ("Testing the multiverse testing framework...")
+    test_files = FileList['test/multiverse/test/*_test.rb']
+    ruby test_files.join(" ")
+  end
+
+  Rake::TestTask.new(:intentional_fail) do |t|
+    t.libs << "#{agent_home}/test"
+    t.libs << "#{agent_home}/lib"
+    t.pattern = "#{agent_home}/test/intentional_fail.rb"
+    t.verbose = true
+  end
+
+  # Note unit testing task is defined in lib/tasks/tests.rake to facilitate
+  # running them in a rails application environment.
+
+end
+
+desc 'Record build number and stage'
+task :record_build, [ :build_number, :stage ] do |t, args|
+  build_string = args.build_number
+  build_string << ".#{args.stage}" if args.stage
+
+  gitsha = File.exists?(".git") ? `git rev-parse HEAD` : "Unknown"
+  gitsha.chomp!
+
+  File.open("lib/new_relic/build.rb", "w") do |f|
+    f.write("# GITSHA: #{gitsha}\n")
+    f.write("module NewRelic; module VERSION; BUILD='#{build_string}'; end; end\n")
+  end
+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=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", "mongrel_rpm.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::Agent.logger.info "Started Mongrel listening for '#{NewRelic::Control.instance.app_names.join(" and ")}' data at #{server.host}:#{server.port}" 
+end
+