• /
  • ログイン
  • 無料アカウント

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

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

Rubyデータを追加

gemのインストール

重要

Dockerコンテナでエージェントを使用している場合は、各コンテナ内にエージェントをインストールします。

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

    gem 'newrelic_rpm'
  2. Infinite Tracingを使用するには、newrelic-infinite_tracingとして、rubygems.orgからInfinite Tracing gemも使用できます。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'を手動で呼び出す必要があります。また、Infinite Tracingを使用している場合は、require 'newrelic/infinite_tracing'を手動で呼び出します。

      または、Bundler.requireを手動で呼び出し、Infinite Tracingを有効にします。

    RailsまたはSinatraを使用していない場合

    SinatraまたはRailsを使用しないRackアプリケーションで、自動ブラウザアプリケーションの監視とクロスアプリケーションのトレーシングを使用するには、エージェントが提供するRackミドルウェアを手動で追加する必要があります。New Relicのgemをできるだけリストの下位に設置して、gemの初期化時にその上にあるフレームワークをインストゥルメントできるようにします。

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

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

  1. New Relicアカウントをまだお持ちでない場合は、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エージェントを試す場合は、関連環境で、newrelic.ymlファイルのブロックでmonitor_mode設定値がtrueに設定されていることを確認します。

たとえば、開発環境にNew Relicをデプロイし、アプリのパフォーマンスメトリクスを引き続き表示できるようにするには、開発:ブロックで、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

  1. gem install newrelic_rpmを使用して、gemをインストールします。

  2. environment.rbを編集し、initializerブロックに追加します。

    config.gem "newrelic_rpm"
  3. Infinite Tracing を有効にする場合は、environment.rb ファイルの次の行に次の値を追加します。

    config.gem "newrelic-infinite_tracing"

2.1より前のRails

New Relicは、Railsバージョン2.1以前は正式にはサポートしていません。ただし、Railsバージョン2.0*用のNew Relicを使用する場合は、environment.rbを編集し、initializer:ブロックの後に次のステートメントを追加します。

require "newrelic_rpm"

無限トレーシング

Infinite Tracing を有効にする場合は、environment.rb ファイルの次の行に次の値を追加します。

require "newrelic/infinite_tracing"
問題を作成する
Copyright © 2020 New Relic Inc.