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

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

Rubyデータを追加

ヒント

アプリケーションはKubernetesクラスタ上で実行されていますか?Kubernetes APM auto-attachを使用したインストレーションメソッドを試してください。

gemのインストール

重要

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

Rubyエージェントのgemは、rubygems.orgからnewrelic_rpmとして入手できます。Bundlerを使用するアプリケーションには、Gemfileにこのgemを追加します。
```
gem 'newrelic_rpm'
```
無限トレーシングを使用するために、無限トレーシングgemはnewrelic-infinite_tracingとしてrubygems.orgから入手することもできます。Bundlerを使用するアプリケーションの場合は、Gemfile に Infinite Tracing gem を追加します。
```
gem 'newrelic-infinite_tracing'
```

次のステップは、Rails、Roda、Sinatraのいずれを使用しているかによって異なります。

Ruby installation	Comments
Rails、Roda、Sinatraを使用している場合	Rails：Railsは`Bundler.require`を自動的に呼び出し、アプリケーションの起動時に`newrelic_rpm`を要求します。 Roda, Sinatra：Roda、Sinatra、または他のフレームワークを使用している場合、`require 'newrelic_rpm'`を手動で呼び出す必要があります。また、無限トレーシングを使用している場合は、`require 'newrelic/infinite_tracing'`を手動で呼び出します。または、`Bundler.require`を手動で呼び出し、無限トレーシングを有効にします。
Rails、Roda、Sinatraを使用していない場合	Roda、Sinatra、Railsを使用しないRackアプリケーションで、自動ブラウザアプリケーション監視を使用するには、エージェントが提供するRackミドルウェアを手動で追加する必要があります。New Relicのgemをできるだけリストの下位に設置して、gemの初期化時にその上にあるフレームワークをインストゥルメントできるようにします。

Ruby installation

Comments

Rails、Roda、Sinatraを使用している場合

Rails：RailsはBundler.requireを自動的に呼び出し、アプリケーションの起動時にnewrelic_rpmを要求します。
Roda, Sinatra：Roda、Sinatra、または他のフレームワークを使用している場合、require 'newrelic_rpm'を手動で呼び出す必要があります。また、無限トレーシングを使用している場合は、require 'newrelic/infinite_tracing'を手動で呼び出します。
または、Bundler.requireを手動で呼び出し、無限トレーシングを有効にします。

Rails、Roda、Sinatraを使用していない場合

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

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

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

GitHubリポジトリからnewrelic.ymlのコピーをダウンロードします。
ご使用のアプリケーションのconfigサブディレクトリにnewrelic.ymlファイルをコピーします。
license_key値を編集して、を含めます。
app_name値をわかりやすい名前に編集します。

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

bash

$newrelic install --license_key="YOUR_LICENSE_KEY" "YOUR_APP_NAME"

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

このドキュメントはインストールの役に立ちましたか？

APMおよびインフラストラクチャデータのログを表示

また、ログとアプリケーションのデータを統合して、トラブルシューティングをより簡単かつ迅速にできます。コンテキストのログでは、エラーとトレースに関連するログメッセージをアプリケーションのUIで直接表示できます。また、Kubernetesクラスタなど、インフラストラクチャデータのコンテキストでログを表示することもできます。別のUIページに切り替える必要はありません。

エージェントの更新

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

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

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

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

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

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