ここでは、RubyのエージェントをRailsのプラグインとしてインストールする方法を説明します。ほとんどの使用例では、代わりに エージェント gem をインストールしてください 。
New Relic Rails プラグインをインストールする
重要
バージョンと依存関係をより適切に制御できるように 、Ruby エージェントを gem としてインストールすること を強くお勧めします。
GithubからRailsプラグインをインストールするには、Railsのバージョンが2以上の場合、以下のコマンドを使用します。
$script/plugin install git://github.com/newrelic/newrelic-ruby-agent.git$mv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agentこれにより、Rails プラグインがアプリケーションのvendor/pluginsディレクトリにエクスポートされます。Rails プラグインを git URL から直接インストールできない場合は、リポジトリを vendor/plugins ディレクトリにクローンできます。
このドキュメントはインストールの役に立ちましたか？
設定ファイルの更新
エージェントをインストールした後、 newrelic.ymlファイルをアプリケーションのconfigサブディレクトリにコピーします。 New Relic にログインすると、 Account settingsからを含む新しいnewrelic.ymlをダウンロードできます。
重要
インストール作業の一環として、デフォルトの アプリケーション名 を意味のある名前に変更します。
newrelic.ymlファイルの更新
エージェントを更新するたびに、Ruby エージェント構成ファイル ( config/newrelic.yml ) が更新されていることを確認してください。
- Ruby エージェントのプラグイン フォルダ (
vendor/plugins/newrelic-ruby-agent/newrelic.yml) にあるデフォルトのnewrelic.ymlファイルを開きます。 config/newrelic.ymlファイルにない新しい構成オプションを探してください。
ヒント
YAML 補間を使用して、 newrelic.ymlファイルの Rails 認証情報 に保存されているシークレットを参照できます。
# When you have a key that exists in config/credentials.yml.enc like 'newrelic_license_key'... license_key: <%= Rails.application.credentials.newrelic_license_key %>APMおよびインフラストラクチャデータのログを表示
ログとアプリケーションのデータをまとめて、トラブルシューティングをより簡単かつ迅速にすることもできます。コンテキスト内のログを使用すると、エラーとトレースに関連するログメッセージをアプリのUIで直接確認できます。また、Kubernetesクラスターなどのインフラストラクチャデータのコンテキストでログを表示することもできます。別のUIページに切り替える必要はありません。
Rubyエージェントの更新
RailsプラグインでSubversionを使用する場合、再インストールする前に必ず古いエージェントプラグインを削除してください。
ヒント
可能であれば宝石を使用してください。
$svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins -m "removing old version of newrelic"続いて、最新のRuby agentプラグインをインストールします。
$script/rails plugin install git://github.com/newrelic/newrelic-ruby-agent.git vendor/plugins/newrelic-ruby-agent$mv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agent$svn add vendor/plugins/newrelic-ruby-agent$svn commit vendor/plugins -m "upgrading newrelic to version X.X.X"Railsプラグインのアンインストール
Railsプラグインをアンインストールするには
$svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins