Rubyエージェントはコードを自動的に計装するため、アプリケーションの監視を開始できます。
ヒント
Kubernetesで実行している場合、Kubernetes APM自動アタッチをご覧ください。
前提条件
開始する前に、これらの要件を確認してください。
要件 | 詳細 |
|---|---|
New Relicアカウント | New Relicアカウントとが必要です。開始する前に準備しておいてください。 |
Rubyバージョン | サポート対象のRubyのバージョンについては、Rubyエージェントの要件とサポート対象のフレームワークをご覧ください。 |
オペレーティングシステム | UNIX系OS:Linux、Solaris、FreeBSD、macOS。詳細はRubyエージェントの要件とサポート対象のフレームワークをご覧ください。 |
gemのインストール
RubyエージェントのgemをGemfileに追加します。
gem 'newrelic_rpm'次に、以下を実行します。
$bundle install重要
Dockerコンテナでエージェントを使用している場合は、各コンテナにエージェントをインストールします。Dockerベースのデプロイメント例については、DockerへのRubyエージェントのインストールをご覧ください。
フレームワーク別の注意事項:
- Rails:Railsは
Bundler.requireを自動的に呼び出すため、追加の手順なしで起動時にnewrelic_rpmが読み込まれます。 - RodaまたはSinatra:アプリケーションから手動で
require 'newrelic_rpm'を呼び出す必要があります。 - その他のRackアプリケーション:自動ブラウザ監視を使用するには、エージェントが提供するRackミドルウェアを手動で追加してください。
エージェントの設定
New RelicのGitHubリポジトリからnewrelic.ymlをダウンロードし、アプリケーションのconfigディレクトリにコピーします。
本番環境に移行する前に、次の2つの設定を必ず変更してください。
license_keyにを設定してください。app_nameにわかりやすいアプリケーション名を設定してください。
または、CLIを使用して設定ファイルを生成してください。
$bundle exec newrelic_rpm install --license_key="YOUR_LICENSE_KEY" "YOUR_APP_NAME"データが送信されていることを確認する
Webサーバーを再起動します。
アプリケーションに少なくとも2つのリクエストを送信します。
2~3分待ってから、one.newrelic.com > APMを開き、アプリケーション名で検索します。
ヒント
アプリケーションが表示されない場合は、データが表示されない(Ruby)をご覧ください。
関連記事
- Rubyエージェントの要件とサポート対象のフレームワーク — サポート対象のRubyのバージョン、OS、フレームワーク。
- Rubyエージェントの設定 — 利用可能なすべての設定。
- Rubyエージェントの更新 — 新しいバージョンにアップグレードする方法。
- Heroku上のRubyエージェント — Heroku固有のインストレーション手順。