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

Rubyエージェント設定

New Relic Rubyエージェントは、設定ファイルや環境変数の設定を使用して、またはサーバーサイド構成を使用してプログラム的に構成できます。このドキュメントは、Rubyエージェントで使用できる設定オプションをまとめたものです。

設定オプションのデフォルト値が(Dynamic)の場合、Rubyエージェントが実行時にデフォルト値を計算します。設定項目の値は、状況に応じて別の設定項目の値がデフォルト値として設定されます。

設定方法と優先順位

Rubyエージェントを設定する主な(デフォルトの)方法は、 configサブディレクトリ内の設定ファイル(newrelic.yml)を使用することです。環境変数を使用して設定値を設定する方法:

  1. 設定名に接頭辞NEW_RELIC_を追加します。
  2. ピリオド.をアンダースコア_に置き換えます。

サーバーサイド設定からUIでいくつかの値を設定することもできます。

Rubyエージェントは、設定に対して次の優先順位に従います。

  1. 環境変数
  2. サーバーサイドコンフィグレーション
  3. 設定ファイル(newrelic.yml
  4. デフォルト設定

つまり、環境変数は他のすべての設定と情報をオーバーライドし、サーバーサイド設定は設定ファイルとデフォルト設定をオーバーライドします。

設定ファイルのオプションの表示・編

Rubyエージェントのnewrelic.ymlは標準のYAML設定ファイルです。通常、上部にDefaultsセクションがあり、その下に各アプリケーション環境(DevelopmentTestStagingProduction)のセクションがあります。

Rubyエージェントは、特定の環境変数を調べてアプリケーションの環境を認識することにより、newrelic.yml設定ファイルの読み取るセクションを決定します。これは、本番環境ではinfolog_level設定に使用し、開発環境ではより詳細なlog_level設定(例えばdebug)を使用したい場合に役立ちます。

以下はnewrelic.yml設定ファイルの例です。

common: &default_settings
license_key: 'YOUR_LICENSE_KEY'
app_name: 'My Application Name'
production:
<<: *default_settings
log_level: info
development:
<<: *default_settings
log_level: debug

Rubyエージェントは、次の環境変数をこの順序で検索して、アプリケーション環境を見つけます。

  1. NEW_RELIC_ENV
  2. RUBY_ENV
  3. RAILS_ENV
  4. APP_ENV
  5. RACK_ENV

Rubyエージェントがこれらの環境変数の値を検出できない場合は、アプリケーション環境をデフォルトでdevelopmentに設定し、newrelic.yml構成ファイルのdevelopmentセクションから読み取ります。

RailsアプリケーションでRubyエージェントを実行すると、エージェントはまずNEW_RELIC_ENV環境変数を探して、アプリケーション環境と、newrelic.yml内の使用するセクションを確認します。NEW_RELIC_ENVがない場合、エージェントはRails環境(RAILS_ENV)を使用します。

設定ファイルを編集する際は、以下の点に注意してください。

  • インデントはスペース2つだけにしてください。
  • 適切な箇所、例えばerror_collectorなどのセクションでのみインデントを行ってください。

インデントが正しくない場合、エージェントの起動時にUnable to parse configuration fileエラーが発生する可能性があります。

利用可能なRubyエージェント設定オプションの最新のリストを表示するには、rake newrelic:config:docsコマンドを使用します。このドキュメントでは、最も一般的なオプションについて説明します。

設定ファイルの更新

このドキュメントの内容は、Rubyエージェントの最新リリース向けです。以前のバージョンの詳細については、newrelic.yml内のコメントを参照してください。

新しいリリース後にnewrelic.ymlファイルを更新するには、エージェントgemのベースディレクトリにあるテンプレートを使用します。新しいgemバージョンに更新するときは、インストールディレクトリ内のconfig/newrelic.ymlnewrelic.ymlを確認・比較して、新しい設定オプションを利用してください。

重要

gemを更新しても、config/newrelic.ymlは自動的に更新されません。

General

これらの設定はエージェントの設定に使用できます。一部の設定は、New Relicのサブスクリプションレベルによって異なります。

トランザクショントレーサー

トランザクショントレース機能は、呼び出しシーケンスの概要、所要時間の内訳、SQLクエリとそのクエリプランのリスト(MySQLおよびpostgresqlで利用可能)など、一部のトランザクションから詳細な情報を収集します。利用可能な機能は、New Relicのサブスクリプションレベルによって異なります。

エラーコレクター

デフォルトでは、エージェントは捕捉されなかったすべての例外を収集・報告します。これらの設定オプションを使用することで、エラー収集をカスタマイズできます。

無視対象のエラーと想定されるエラーの詳細については、APMのエラー分析に関するページを参照してくださいNewRelic::Agent.notice_error Rubyメソッドを使用して想定されるエラーを設定するには、RubyエージェントAPI参照してください

ブラウザのモニタリング

ページ読み込みタイミング機能(リアルユーザー監視またはRUMとも呼ばれます)を使用すると、実際のユーザーがWebサイトで体験しているパフォーマンスについて洞察を得られます。これは、各ページのヘッダーとフッターに少量のJavaScriptコードを挿入することで、ブラウザがウェブページをダウンロードしてレンダリングするのにかかる時間を測定することによって実現されます。

Transactionイベント

アプリケーションロギング

RubyエージェントはAPM logs in contextに対応しています。Rubyエージェント向けのログの設定に関するヒントについては、「Ruby logs in contextの設定」を参照してください。

ログ関連の設定オプションは以下のとおりです。

AI Monitoring

このセクションには、AI監視を設定するためのRubyエージェント設定を記載します。

重要

トレースとフィードバックデータを取得するには、ディストリビューティッド(分散)トレーシングを有効にする必要があります。Ruby 8.0.0以降ではデフォルトで有効になっています。

属性

属性は、イベントまたはトランザクションのプロパティを決定する情報を含むキーと値のペアです。これらのキーの値のペアは、APMのトランザクショントレース、APMのトレース対象のエラー、ダッシュボードの重大イベント、ダッシュボードのページビュー内で確認できます。これらの各宛先に送信する属性を正確にカスタマイズできます。

監査ログ

自動起動

Cloud

コードレベルのメトリクス

カスタムアトリビュート

カスタムイベント

データストアトレーサー

無効化

これらの設定を使用して、エージェント起動時に計装タイプを切り替えます。

ディストリビューティッド(分散)トレーシング

Elasticsearch

Heroku

無限トレーシング

インストゥルメンテーション

メッセージトレーサー

Mongo

Opensearch

OpenTelemetry

プロセスホスト

Rake

ルール

セキュリティ

Serverlessモード

Sidekiq

動作の遅いSQL

スパンイベント

例外メッセージの削除

Stripe

スレッドプロファイラー

利用

Copyright © 2026 New Relic株式会社。

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