• /
  • 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セクションが含まれ、その下に各アプリケーション環境のセクション ( DevelopmentTestStaging 、およびProduction ) が含まれます。

Ruby エージェントは、特定の環境変数を調べてアプリケーションの環境を導出し、 newrelic.yml構成ファイルのどのセクションを読み取るかを決定します。これは、本番環境でlog_level構成設定にinfoを使用し、開発環境でより詳細な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は自動的に更新されません。

一般

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

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

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

エラーコレクター

エージェントは、デフォルトでは、すべてのアンキャッチャー例外を収集して報告します。これらの設定オプションにより、エラー収集をカスタマイズすることができます。

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

ブラウザの監視

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

トランザクション・イベント

アプリケーションログ

Ruby エージェントは、コンテキスト内の APM ログをサポートします。Ruby エージェントのログを構成するためのヒントについては、コンテキストで Ruby ログを構成するを参照してください。

使用可能なロギング関連の構成オプションには、次のものがあります。

AIモニタリング

このセクションには、AIモニタリングを設定するためのRubyエージェント設定が含まれています。

重要

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

属性

アトリビュート は、イベントやトランザクションのプロパティを決定する情報を含むキーとバリューのペアです。これらのキー・バリュー・ペアは、APMのトランザクション・トレース、APMのトレースされたエラー、ダッシュボードのトランザクション・イベント、ダッシュボードのページ・ビューで見ることができます。どの属性がこれらの各送信先に送信されるかを正確にカスタマイズできます。

監査ログ

オートスタート

クラウド

コード レベルの指標

クロスアプリケーショントレーサー

カスタム属性

カスタムイベント

データストアトレーサー

無効化

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

分散型トレーシング

Elasticsearch

Heroku

無限のトレース

計装

メッセージトレーサー

Mongo

オープンサーチ

プロセスホスト

Rake

ルール

セキュリティ

サーバーレスモード

Sidekiq

Slow SQL

スパンイベント

例外メッセージの除去

ストライプ

スレッドプロファイラー

活用

Copyright © 2025 New Relic株式会社。

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