当社のRubyエージェントではコードの自動インストゥルメンテーションが行われるので、アプリケーションのモニターを開始できます。当社のランチャーを使用するか、本ドキュメントの説明に従って、基本的なRubyエージェントのインストレーションを実行できます。
ヒント
RubyなどのエージェントおよびNew Relicのその他のオブザーバビリティ プラットフォームを使用するには、New Relicファミリーに参加してください。サインアップして、わずか数秒で無料アカウントを作成できます。次に、毎月最大で100GBのデータを無料で取り込みます。期間無制限です。
gemのインストール
重要
Dockerコンテナでエージェントを使用している場合は、各コンテナ内にエージェントをインストールします。
Rubyエージェントのgemは、rubygems.orgから
newrelic_rpm
として入手できます。Bundlerを使用するアプリケーションには、Gemfileにこのgemを追加します。gem 'newrelic_rpm'Infinite Tracing を使用するために、Infinite Tracing gem は
newrelic-infinite_tracing
として入手することもできます。Bundlerを使用するアプリケーションの場合は、Gemfile に Infinite Tracing gem を追加します。gem 'newrelic-infinite_tracing'次のステップは、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の初期化時にその上にあるフレームワークをインストゥルメントできるようにします。
- Rails:推奨設定でRails 3以降、またはRails 2.3を使用している場合、Railsは
設定ファイルをインストールする
エージェントをインストールしたら、newrelic.yml
設定ファイルをインストールして、アプリケーション名を指定する必要があります。
- New Relicにサインインします。
- アカウント ドロップダウンからAccount settings(アカウントの設定)を選択します。
- アカウント設定ページで、クリーン設定ファイルのダウンロードセクションを検索し、
newrelic.yml
ファイルをクリックします。 - ご使用のアプリケーションの
config
サブディレクトリにnewrelic.yml
ファイルをコピーします。 - デフォルトのアプリケーション名を分かりやすい名前に変更します。
または代わりに、次のコマンドを使用して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を使用していない場合、以下の手順に従ってください。
Rubyのインストレーション | コメント |
---|---|
BundlerなしのRails 2.1~2.3 |
|
2.1より前のRails | New Relicは、Railsバージョン2.1以前は正式にサポートしていません。それでもRailsバージョン2.0.*でNew Relicを使用したい場合は、
Infinite Tracing Infinite Tracing を有効にする場合は、
|
その他のヘルプ
さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:
- Explorers Hubを参照して、コミュニティから支援を受け、ディスカッションに参加してください。
- 当社のサイトで回答を見つけ、サポートポータルの使用方法について学びます。
- Linux、Windows、およびmacOSのトラブルシューティングツールであるNew Relic Diagnosticsを実行します。
- New Relicのデータセキュリティとライセンスドキュメントを見直してください。