Ruby agent installation: Rails plugin

These instructions are for installing the Ruby agent as a Rails plugin. For most use cases, you should instead install the agent gem.

Contents

Install the New Relic Rails plugin

To install the Rails plugin from Github, use the following commands for Rails versions 2 or higher:

script/plugin install git://github.com/newrelic/newrelic-ruby-agent.git
mv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agent

This will export the Rails plugin into your application's vendor/plugins directory. If you cannot install the Rails plugin directly from the git URL, you can clone the repository into the vendor/plugins directory.

Update the configuration file

After installing the agent, copy the newrelic.yml file into the config subdirectory of your application. You can download a fresh newrelic.yml that includes your license key from the Account settings when logged in to New Relic.

Update the newrelic.yml file [#Updating_newrelic.yml]

Whenever you update the agent, double-check that your Ruby agent configuration file (config/newrelic.yml) is up to date: Open the default newrelic.yml file that lives in the Ruby agent's plugin folder (vendor/plugins/newrelic-ruby-agent/newrelic.yml). Look for new configuration options that are not in your config/newrelic.yml file.

Update the Ruby agent

When using Subversion with the Rails plugin, be sure to remove the old agent plugin before reinstalling.

svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins -m "removing old version of newrelic"

Then, to install the latest Ruby agent plugin:

script/rails plugin install git://github.com/newrelic/newrelic-ruby-agent.git vendor/plugins/newrelic-ruby-agent
mv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agent
svn add vendor/plugins/newrelic-ruby-agent
svn commit vendor/plugins -m "upgrading newrelic to version X.X.X"

Uninstall the Rails plugin

To uninstall the Rails plugin:

svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins

For more help

Additional documentation resources include:

• New Relic for Ruby (compatibility and requirements, general information about installation, configuration, troubleshooting, and known issues)
• Ruby agent installation (using the New Relic Ruby gem and configuration file)