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
重要
New Relic strongly recommends installing the Ruby agent as a gem in order to have better control over versions and dependencies.
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.gitmv 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.
重要
As part of the installation process, change the default application name to a meaningful name.
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.
ヒント
Use the gem if possible.
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-agentmv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agentsvn add vendor/plugins/newrelic-ruby-agentsvn 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)
その他のヘルプ
さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:
- Explorers Hubでは、コミュニティからのサポートを受けたり、ディスカッションに参加したりすることができます。
- 当社サイトで答えを見つけて、サポートポータルの使用方法を確認してください。
- Linux、Windows、およびmacOS向けトラブルシューティングツールであるNew Relic Diagnosticsを実行してください。
- New Relicのデータセキュリティとライセンスドキュメント をご確認ください。