New Relic Rubyエージェントのインストール

当社のRubyエージェントではコードの自動インストゥルメンテーションが行われるので、アプリケーションのモニターを開始できます。当社のランチャーを使用するか、本ドキュメントの説明に従って、基本的なRubyエージェントのインストレーションを実行できます。

gemのインストール

1. Rubyエージェントのgemは、rubygems.orgからnewrelic_rpmとして入手できます。Bundlerを使用するアプリケーションには、Gemfileにこのgemを追加します。

   gem 'newrelic_rpm'

   コピー

2. Infinite Tracing を使用するために、Infinite Tracing gem は newrelic-infinite_tracing として入手することもできます。Bundlerを使用するアプリケーションの場合は、Gemfile に Infinite Tracing gem を追加します。

   gem 'newrelic-infinite_tracing'

   コピー

3. 次のステップは、RailsまたはSinatraのどちらを使用しているかによって異なります。

   Rubyのインストレーション	コメント
   RailsまたはSinatraを使用している場合	Rails：推奨設定でRails 3以降、またはRails 2.3を使用している場合、RailsはBundler.requireを自動的に呼び出し、アプリケーションの起動時にnewrelic_rpmが要求されるようにします。 Sinatra：Sinatraまたは別のフレームワークを使用している場合、require 'newrelic_rpm'を手動で呼び出すか、Bundler.requireを呼び出す必要があります。
   RailsまたはSinatraを使用していない場合	SinatraまたはRailsを使用しないRackアプリケーションで、自動ブラウザアプリケーションの監視とクロスアプリケーションのトレーシングを使用するには、エージェントが提供するRackミドルウェアを手動で追加する必要があります。New Relicのgemをできるだけリストの下位に設置して、gemの初期化時にその上にあるフレームワークをインストゥルメントできるようにします。

設定ファイルをインストールする

エージェントをインストールしたら、newrelic.yml設定ファイルをインストールして、アプリケーション名を指定する必要があります。

1. New Relicにサインインします。
2. アカウント ドロップダウンからAccount settings（アカウントの設定）を選択します。
3. アカウント設定ページで、クリーン設定ファイルのダウンロードセクションを検索し、newrelic.ymlファイルをクリックします。
4. ご使用のアプリケーションのconfigサブディレクトリにnewrelic.ymlファイルをコピーします。
5. デフォルトのアプリケーション名を分かりやすい名前に変更します。

または代わりに、次のコマンドを使用してnewrelic.ymlファイルを手作業で生成できます。

newrelic install --license_key="YOUR_KEY" "My application"

既存のnewrelic.ymlを上書きする必要がある場合、このコマンドを使用して--forceオプションを使用することもできます。

エージェントの更新

Rubyエージェントのバージョンをアップグレードするを参照してください。

本番環境外でエージェントをインストールする

通常は、本番環境でRubyエージェントをインストールします。開発環境またはlocalhost環境でRubyエージェントを試したい場合は、関連するenvironment:ブロック（newrelic.ymlファイル内）で、monitor_modeの設定値がtrueに設定されていることを確認してください。

例えば、開発環境にNew Relicをディプロイし、アプリケーションのパフォーマンスメトリックスを引き続き表示するには：development: ブロックで、monitor_modeの設定値をtrueに設定します。

Rubyエージェントgemをアンインストールする

Bundlerを使用してRubyエージェントをアンインストールするには、Gemfileからgem 'newrelic_rpm'を削除します。Bundlerを使用していない場合、environment.rbファイルからnewrelic_rpmへの参照をすべて削除します。

古いバージョンのRailsにインストールする

Rails 2.xにRubyエージェントをインストールし、Bundlerを使用していない場合、以下の手順に従ってください。

require "newrelic_rpm"

require "newrelic/infinite_tracing"

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください：

• Explorers Hubを参照して、コミュニティから支援を受け、ディスカッションに参加してください。
• 当社のサイトで回答を見つけ、サポートポータルの使用方法について学びます。
• Linux、Windows、およびmacOSのトラブルシューティングツールであるNew Relic Diagnosticsを実行します。
• New Relicのデータセキュリティとライセンスドキュメントを見直してください。