• /
  • EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

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

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

Rubyデータを追加

ヒント

すでにKubernetesクラスタを運用しているのであれば、Kubernetesエージェントオペレーターを使用して、インストレーションメソッドを試してください。

gemのインストール

重要

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

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

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

    gem 'newrelic-infinite_tracing'
  3. 次のステップは、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の初期化時にその上にあるフレームワークをインストゥルメントできるようにします。

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

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

  1. GitHubリポジトリからnewrelic.ymlのコピーをダウンロードします。
  2. ご使用のアプリケーションのconfigサブディレクトリにnewrelic.ymlファイルをコピーします。
  3. license_key値を編集して、を含めます。
  4. 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への参照をすべて削除します。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.