ここでは、RubyのエージェントをRailsのプラグインとしてインストールする方法を説明します。ほとんどの使用例では、代わりに エージェント gem をインストールしてください 。
New Relic Rails プラグインをインストールする
重要
バージョンと依存関係をより適切に制御できるように 、Ruby エージェントを gem としてインストールすること を強くお勧めします。
GithubからRailsプラグインをインストールするには、Railsのバージョンが2以上の場合、以下のコマンドを使用します。
script/plugin install git://github.com/newrelic/newrelic-ruby-agent.gitmv 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-agentmv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agentsvn add vendor/plugins/newrelic-ruby-agentsvn commit vendor/plugins -m "upgrading newrelic to version X.X.X"
Railsプラグインのアンインストール
Railsプラグインをアンインストールするには
svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins