New Relic Ruby エージェントの設定は、設定ファイルでの設定、環境変数での設定、またはプログラムによるサーバーサイドでの設定があります。本ドキュメントでは、Ruby エージェントで利用可能な設定オプションについてまとめています。
構成オプションのデフォルト値が(Dynamic)の場合、これはRubyエージェントが実行時にデフォルトを計算することを意味します。構成設定の値は、デフォルトで別の設定の値になります。
構成方法と優先順位
Rubyエージェントを構成するための主要な(デフォルトの)方法は、 configサブディレクトリーの構成ファイル( newrelic.yml )を使用することです。環境変数を使用して構成値を設定するには:
- プレフィックス
NEW_RELIC_を設定の名前に追加します。 - ピリオド
.をアンダースコア_に置き換えます。
また、 サーバーサイドの設定 を介して、UIでいくつかの値を設定することもできます。
Rubyエージェントでは、この優先順位に従って設定を行います。
- 環境変数
- サーバー側の構成
- 構成ファイル(
newrelic.yml) - デフォルトのコンフィギュレーション設定
つまり、環境変数は他のすべての設定や情報を上書きし、サーバー側の設定は設定ファイルやデフォルトのコンフィグ設定を上書きする、といった具合です。
コンフィグファイルオプションの表示と編集
Rubyエージェントのnewrelic.ymlは標準のYAML設定ファイルです。 通常、上部にDefaultsセクションが含まれ、その下に各アプリケーション環境のセクション ( Development 、 Test 、 Staging 、および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: infodevelopment: <<: *default_settings log_level: debugRuby エージェントは、アプリケーション環境を見つけるために、次の環境変数をこの順序で探します。
NEW_RELIC_ENVRUBY_ENVRAILS_ENVAPP_ENVRACK_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.ymlとnewrelic.ymlを調べるか差分をとって、新しい構成オプションを利用してください。
重要
gemを更新しても、 config/newrelic.ymlは自動的に更新されません。
一般
これらの設定は、エージェントの設定に利用できます。一部の設定は、New Relic のサブスクリプションレベルによって異なります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、Rubyエージェントの実行を許可します。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
NewRelicUIでデータを集約するために使用するアプリケーション名を指定します。同時に複数のアプリにデータを報告するには、名前のリストをセミコロン;で区切って指定します。たとえば、 MyAppまたはMyStagingApp;Instance1 。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
あなたのNew Relic 。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
ログメッセージの詳細レベルを設定します。冗長性を高める場合に考えられるログレベルは、 error 、 warn 、 info 、またはdebugです。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
An array of ActiveSupport custom event names to subscribe to and instrument. For example: [one.custom.event, another.event, a.third.event]
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, the agent will use the ActiveRecord model's table name instead of the class name when naming ActiveRecord metrics, spans, and transaction trace segments. This can reduce cardinality when multiple models share a database table. Defaults to false.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
Rails 6で導入されたActiveRecordの接続検索の高速化をバックポートし、ActiveRecordをインストルメントする際のエージェントのパフォーマンスを向上させます。この設定は、ActiveRecordにパッチを当てる他のgemと互換性がないかもしれないことに注意してください。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
ローカル CA バンドルへのパスを手動でオーバーライドします。この CA バンドルは、 New Relicのデータ収集サービスによって提示された SSL 証明書を検証します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, the agent captures memcache keys in transaction traces.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはHTTPリクエストパラメータをキャプチャし、それらをトランザクショントレース、トレースされたエラー、およびTransactionErrorイベントに添付します。
注意
capture_params設定を使用する場合、Ruby エージェントは秘密情報をフィルタリングしようとしません。Recommendation:リクエストから機密情報をフィルターするには、代わりにattributes.include設定を使用します。 詳細については、 Ruby 属性の例を参照してください。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはAgent.drop_buffered_dataのTracer::Stateをクリアします。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Path to newrelic.yml. If undefined, the agent checks the following directories (in order): config/newrelic.yml -> newrelic.yml -> $HOME/.newrelic/newrelic.yml -> $HOME/newrelic.yml
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, suppresses the newrelic distributed tracing header on outbound requests.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, forces the agent to install its exit handler (which sends all cached data to the collector before shutting down), even in cases where the agent would normally skip it, such as when it detects Sinatra running as an embedded service within another framework. Sinatra runs the entire application inside its own at_exit block, so the agent skips its own at_exit handler by default to avoid conflicts. This setting overrides that. Note: send_data_on_exit must also be true for this setting to have any effect.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、高セキュリティモードを有効にします。この設定を有効にする前に、高セキュリティモードの影響を理解してください。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
このエージェントから送信されるデータに適用されるラベル名と値の辞書。コロンで区切られた:ペアのセミコロンで区切られた;文字列として表現することもできます。たとえば、 Server:One;Data Center:Primary 。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
ログファイルの名前を定義します。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Defines a path to the agent log file, excluding the filename. If you want to send your agent logs to standard out, set this to STDOUT.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
NewRelicコレクターにデータを送信するためのマーシャラーを指定します。現在、この設定の有効な値はjsonのみです。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはアプリに関するデータをNewRelicコレクターに送信します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、ActiveRecordインストルメンテーションにalias_methodではなくModule#prependを使用します。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
プロキシサーバーを介して New Relic コレクター と通信するためのホストを定義します。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
プロキシサーバーを経由して New Relic コレクター と通信するためのパスワードを定義します。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
プロキシサーバーを経由して New Relic コレクター と通信するためのポートを定義します。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
プロキシサーバーを介して New Relic コレクター と通信するためのユーザーを定義します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、シャットダウンする前にNewRelicコレクターにデータを送信するExitハンドラーを有効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueに設定すると、アプリケーションの起動時にNewRelicコレクターへの同期接続を強制します。非常に短期間のプロセスの場合、これはNewRelicエージェントがレポートする時間を確保するのに役立ちます。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, tracer state storage is thread-local, otherwise, fiber-local.
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
エージェントがコレクターへの接続を試みる際の最大秒数を定義します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、すべての宛先のすべての HTTP リクエスト ヘッダーのキャプチャが有効になります。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
エージェントが自動的にカスタム インストゥルメンテーションを追加できるRubyメソッドを表す、 CLASS#METHOD (インスタンス メソッドの場合) および/またはCLASS.METHOD (クラス メソッドの場合) の文字列の配列。 これには、メソッドを定義するソースコードを変更する必要はありません。
モジュールまたはクラスの名前空間を含む完全修飾クラス名 ( ::区切り文字を使用) を使用します。
以下は、Image クラスの render_png インスタンス メソッドと、User クラスの notify クラス メソッドを定義するRubyソースコードです。両方とも MyCompany モジュール ネームスペース内にあります。
module MyCompany class Image def render_png # code to render a PNG end end
class User def self.notify # code to notify users end end endそのソースコードを考慮すると、 newrelic.yml構成ファイルは次のように両方のメソッドのインストゥルメンテーションをリクエストする可能性があります。
automatic_custom_instrumentation_method_list: - MyCompany::Image#render_png - MyCompany::User.notifyこの設定例では、YAML 配列構文を使用して両方のメソッドを指定しています。 あるいは、カンマで区切られた文字列を使用することもできます。
automatic_custom_instrumentation_method_list: 'MyCompany::Image#render_png, MyCompany::User.notify'リスト内のカンマの周囲の空白はオプションです。 NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST環境変数を介してメソッドのリストを使用してエージェントを構成する場合は、次のコンマ区切りの文字列形式を使用します。
$export NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST='MyCompany::Image#render_png, MyCompany::User.notify'タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, metrics for Action Cable broadcast calls will not include the broadcasting value for a given broadcast. Defaults to false. The default may change in a future major version release.
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
A list of middleware class or module names the agent should ignore. Example: ["Rack::Cors", "ActionDispatch::Reloader"]
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントが Ruby on Rails を使用するアプリケーションにある場合、エージェントは config/initializers の実行後に開始されます。
注意
このオプションは、環境変数によってのみ設定できます。
トランザクショントレーサー
トランザクショントレース 機能は、選択したトランザクションから、呼び出しシーケンスの概要、費やした時間の内訳、SQL クエリのリストとそのクエリプラン(mysql および postgresql の場合)などの詳細な情報を収集します。利用可能な機能は、お客様の New Relic のサブスクリプションレベルによって異なります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、トランザクショントレースの収集を有効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、段階レースでの Explain プランの収集が有効になります。 slow_sql.explain_enabledが別途設定されていない場合、この設定は低速 SQL トレースの説明プランにも適用されます。
タイプ | 浮く |
|---|---|
デフォルト |
|
環境変数 |
|
エージェントが説明プランを収集するしきい値(秒単位)。 explain_enabledがtrueの場合にのみ関連します。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
1つのトランザクション・トレースに記録するトランザクション・トレース・ノードの最大数。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはRedisコマンド引数をトランザクショントレースに記録します。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
SQL の難読化レベルは、段階トレース ノードで報告されます。 デフォルトでは、これはobfuscatedに設定されており、数値リテラルと文字列リテラルが削除されます。
- エージェントにクエリ情報をキャプチャさせたくない場合は、これを
noneに設定します。 - エージェントがすべてのクエリ情報を元の形式でキャプチャするようにする場合は、これを
rawに設定します。 - 高セキュリティモードを有効にすると、これは自動的に
obfuscatedに設定されます。
タイプ | 浮く |
|---|---|
デフォルト |
|
環境変数 |
|
閾値を秒単位で指定します。エージェントは、スタックトレースの継続時間がこの閾値を超えた場合、トランザクショントレースノードにスタックトレースを含めます。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, once transaction_tracer.limit_segments is reached, the agent will also stop recording exclusive time for any segments created afterward in that transaction. This can reduce memory usage for very long-running transactions with many segments, at the cost of less accurate timing data for segments in the transaction if the segment limit is reached.
タイプ | 浮く |
|---|---|
デフォルト |
|
環境変数 |
|
しきい値を秒単位で指定します。このしきい値よりも長い期間のトランザクションは、トランザクショントレースの対象となります。 float値または文字列apdex_fを指定します。
エラーコレクター
エージェントは、デフォルトでは、すべてのアンキャッチャー例外を収集して報告します。これらの設定オプションにより、エラー収集をカスタマイズすることができます。
無視されたエラーと予想されるエラーの詳細については、APM のエラー分析に関するこのページを参照してください。NewRelic::Agent.notice_error Ruby メソッドを介して予想されるエラーを設定するには、Ruby エージェント API を参照してください。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは TransactionErrorイベントを収集します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはトレースされたエラーとエラーカウントメトリックをキャプチャします。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
エージェントが期待通りに扱うべきエラークラスのリストです。
注意
このオプションは、環境変数で設定することはできません。
タイプ | ハッシュ |
|---|---|
デフォルト |
|
環境変数 |
|
メッセージのリストへのエラー・クラスのマップです。ここで指定されたクラスのエラーが発生したとき、そのエラーメッセージにここで指定された文字列のいずれかが含まれていれば、そのエラーは期待どおりに処理されます。
注意
このオプションは、環境変数で設定することはできません。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
A comma-separated list of HTTP status codes and/or status code ranges (for example, 404, 429, 500-599). Errors associated with a matching status code, if the error has one, will be treated as expected.
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
エージェントが無視すべきエラークラスのリストです。
注意
このオプションは、環境変数で設定することはできません。
タイプ | ハッシュ |
|---|---|
デフォルト |
|
環境変数 |
|
メッセージのリストへのエラー・クラスのマップです。ここで指定されたクラスのエラーが発生したとき、そのエラーメッセージにここで指定された文字列のいずれかが含まれていれば、そのエラーは無視されます。
注意
このオプションは、環境変数で設定することはできません。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
A comma-separated list of HTTP status codes and/or status code ranges (for example, 404, 429, 500-599). Errors associated with a matching status code, if the error has one, will be ignored.
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
Defines the maximum number of frames in an error backtrace. Backtraces over this amount are truncated in the middle by default, preserving the beginning and the end of the stack trace. See error_collector.backtrace_truncate_location to customize the truncation location.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Specifies where in the backtrace to truncate when the number of frames exceeds error_collector.max_backtrace_frames. Options are top (remove frames from the beginning), middle (remove frames from the middle, preserving the beginning and end), or end (remove frames from the end).
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
収集サイクルごとに報告される TransactionErrorイベント の最大数を定義します。
ブラウザの監視
ページ読み込みタイミング機能 (リアルユーザー監視またはRUMとも呼ばれます) は、実際のユーザーが Web サイトで体験しているパフォーマンスをインサイトに提供します。 これは、各ページのヘッダーとフッターに少量の JavaScript コードを挿入することにより、ユーザーのブラウザーが Web ページをダウンロードしてレンダリングするのにかかる時間を測定することで実現されます。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、ページの読み込みタイミングのためにJavaScriptヘッダーの自動挿入を有効にします(実際のユーザー監視またはRUMと呼ばれることもあります)。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、ブラウザ監視ブラウザでContent Security Policy Nonceの自動インジェクションを有効にします。 現時点では、自動インジェクションは Rails 5.2 以降でのみ機能します。
トランザクション・イベント
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、トランザクションイベントのサンプリングを有効にします。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
1つのハーベストから報告されるトランザクションイベントの最大数を定義する。
アプリケーションログ
Ruby エージェントは、コンテキスト内の APM ログをサポートします。Ruby エージェントのログを構成するためのヒントについては、コンテキストで Ruby ログを構成するを参照してください。
使用可能なロギング関連の構成オプションには、次のものがあります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、ログの装飾とログイベントおよびメトリックの収集を有効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはアプリケーションによって発行されたログレコードをキャプチャします。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Sets the minimum level a log event must have to be forwarded to New Relic. Logs at the configured level and any higher severity are forwarded, for example, debug forwards all log events, while error forwards only error, fatal, and unknown events. Valid values, lowest to highest severity: debug, info, warn, error, fatal, unknown (case-sensitive; uppercase forms are also accepted).
This ordering is based on the integer values of Ruby's Logger::Severity constants (see https://github.com/ruby/logger/blob/113b82a06b3076b93a71cd467e1605b23afb3088/lib/logger/severity.rb).
タイプ | ハッシュ |
|---|---|
デフォルト |
|
環境変数 |
|
New Relic に転送されるすべてのログ イベントにカスタム属性として追加するキーと値のペアを含むハッシュ。環境変数を使用して送信する場合、値は「key1=value1,key2=value2」のような形式にする必要があります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
true場合、エージェントはログ レコードにラベルを添付します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
ログ レコードから除外するラベルを含む、大文字と小文字を区別しない配列またはコンマ区切りの文字列。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
一度にメモリにバッファリングするログレコードの最大数を定義します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはログをメタデータで装飾して、エンティティ、ホスト、トレース、およびスパンにリンクします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはアプリケーションのロギングに関連するメトリックをキャプチャします。
AIモニタリング
このセクションには、AIモニタリングを設定するためのRubyエージェント設定が含まれています。
重要
トレースとフィードバックデータを取得するには、ディストリビューティッド(分散)トレーシングを有効にする必要があります。 Ruby エージェント 8.0.0 以降ではデフォルトでオンになっています。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
falseの場合、すべての LLM インストゥルメンテーション (現時点では OpenAI のみ) が無効になり、メトリック、イベント、スパンは送信されません。 high_securityモードが有効な場合、AI モニタリングは自動的に無効になります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If false, LLM instrumentation (OpenAI only for now) will not capture the content attribute on LlmChatCompletionMessage events or the input attribute on LlmEmbedding events. This is an optional security setting to prevent recording sensitive data sent to and received from your LLMs.
属性
アトリビュート は、イベントやトランザクションのプロパティを決定する情報を含むキーとバリューのペアです。これらのキー・バリュー・ペアは、APMのトランザクション・トレース、APMのトレースされたエラー、ダッシュボードのトランザクション・イベント、ダッシュボードのページ・ビューで見ることができます。どの属性がこれらの各送信先に送信されるかを正確にカスタマイズできます。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、すべての宛先の属性のキャプチャを有効にします。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
すべての宛先から除外する属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
すべての宛先に含める属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはブラウザの監視から属性を取得します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
ブラウザの監視から除外する属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
ブラウザの監視に含める属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはエラー収集から属性をキャプチャします。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
エラー収集から除外する属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
エラー収集に含める属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはスパンイベントの属性をキャプチャします。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
スパンイベントから除外する属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
スパンイベントに含める属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはトランザクションイベントから属性をキャプチャします。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
トランザクションイベントから除外する属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
トランザクションイベントに含める属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはトランザクションセグメントの属性をキャプチャします。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
トランザクションセグメントから除外する属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
トランザクションセグメントに含める属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはトランザクショントレースから属性をキャプチャします。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
トランザクショントレースから除外する属性のプレフィックス。最後にワイルドカードとして*を許可します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
トランザクショントレースに含める属性のプレフィックス。最後にワイルドカードとして*を許可します。
監査ログ
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、NewRelicコレクターとの通信をログに記録する監査ログを有効にします。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
List of allowed endpoints to include in the audit log.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
監査ログファイルのパス(ファイル名を含む)を指定します。
オートスタート
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
エージェントが自動的に起動しないようにする定数のリストを指定します。個々の定数はコンマ,で区切ります。たとえば、 "Rails::Console,UninstrumentedBackgroundJob" 。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
エージェントがインストルメントしてはならない実行可能ファイルのコンマ区切りリストを定義します。たとえば、 "rake,my_ruby_script.rb"です。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
エージェントがインストルメントしてはならないRakeタスクのコンマ区切りリストを定義します。たとえば、 "assets:precompile,db:migrate"です。
クラウド
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
The AWS account ID associated with this application.
コード レベルの指標
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはトレース メソッドのソースコード レベルのメトリクスを報告します。 参照: https://docs.newrelic.com/docs/apm/agents/ruby-agent/features/ruby-codestream-integration/
カスタム属性
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
falseの場合、カスタム属性はイベントで送信されません。
カスタムイベント
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはカスタムイベントをキャプチャします。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
Specify a maximum number of custom events to buffer in memory at a time. When configuring the agent for AI monitoring, set to max value 100000. This ensures the agent captures the maximum amount of LLM events.
データストアトレーサー
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If false, the agent will not add database_name parameter to transaction or slow SQL traces.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
falseの場合、エージェントはデータストアインスタンスメトリックを報告せず、トランザクションにhostまたはport_path_or_idパラメータを追加したりSQLトレースを遅くしたりしません。
無効化
これらの設定を使用して、エージェントの起動時に計測の種類を切り替えます。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、アクションケーブルの計装を無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、アクション コントローラーの計測を無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、アクション メールボックスの計測を無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、Action Mailer インストルメンテーションを無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、アクティブなジョブの計測を無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, step names from Rails Active Job Continuations will not be included in metric names. This reduces metric cardinality but also reduces visibility into individual step performance. Only set this to true if you are experiencing metric cardinality issues due to jobs with many steps or dynamically-named steps.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、アクティブ ストレージの計測を無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、Active Support インスツルメンテーションを無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、Active Record インストルメンテーションを無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, disables instrumentation for Active Record 4+.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはホストプロセスのCPU使用率をサンプリングしません。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは遅延ジョブキューの深さを測定しません。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, disables the use of GC::Profiler to measure time spent in garbage collection.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはホストプロセスのメモリ使用量をサンプリングしません。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはサードパーティのミドルウェアをインストルメンテーションにラップしません ( Rack::Builderまたは Rails を介してインストールされているかどうかに関係なく)。
重要
ミドルウェア インストルメンテーションが無効になっている場合、アプリケーションが応答コードを変更する可能性のあるミドルウェアを使用している場合、トランザクションで報告される HTTP ステータス コードに変更された値が反映されない可能性があります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、サンプラーメトリックの収集を無効にします。サンプラーメトリックは、イベントベースではないメトリックです(CPU時間やメモリ使用量など)。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、 Sequelインストルメンテーションを無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、 Sidekiqインストルメンテーションを無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、Roda のエージェント ミドルウェアを無効にします。このミドルウェアは、 ページの読み込みタイミング や エラー収集などの高度な機能のサポートを担当します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、Sinatra のエージェント ミドルウェアが無効になります。このミドルウェアは、ディストリビューティッド(分散)トレーシング、ページ読み込みタイミング、エラー収集などの高度な機能サポートを担当します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、ビューインストルメンテーションを無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはRubyVMからパフォーマンス測定値をサンプリングしません。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, disables the Puma server-statistics instrumentation that samples Ruby/Puma/* metrics from the Puma master process. This instrumentation is disabled by default. When enabled, the agent starts a reporting thread in the Puma master process to deliver these metrics.
分散型トレーシング
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
分散トレーシングでは、リクエストが分散システムを通過する経路を確認することができます。分散トレーシングを有効にすると、New Relic の一部の機能の動作が変わるため、この機能を有効にする前に 移行ガイド をよく確認してください。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
This setting controls the behavior of transaction sampling for transactions without a remote parent (traces that originate within this instance of the New Relic agent). Available values are adaptive (the default), always_on, always_off, and trace_id_ratio_based.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
この設定は、リモート 親がサンプリングされるときのトランザクション サンプリングの動作を制御します。使用可能な値は、 adaptive (デフォルト)、 always_on 、 always_off 、およびtrace_id_ratio_basedです。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
この設定は、リモート 親がサンプリングされない場合のトランザクション サンプリングの動作を制御します。使用可能な値は、 adaptive (デフォルト)、 always_on 、 always_off 、およびtrace_id_ratio_basedです。
Elasticsearch
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは、段階トレース内のElasticsearchクラスタ名をキャプチャします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはトランザクション追跡で Elasticsearch クエリをキャプチャします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはトランザクション追跡で Elasticsearch クエリを難読化します。
Heroku
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはホスト名としてHerokudyno名を使用します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
通常、エージェントは、末尾にドットとプロセス ID を付けて dyno 名を報告します (例: worker.3 )。末尾のデータなしで報告するプレフィックスを指定することで、この末尾のデータを削除できます (たとえば、 worker )。
無限のトレース
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
トレース オブザーバ ホストのホスト名を設定します。設定すると、通常のエージェント サンプリング決定に関係なく、さらにサンプリングを決定するために、記録されたすべてのスパンをトレース オブザーバに送信することで、テールベースのサンプリングが有効になります。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
トレース オブザーバー ホストの TCP/IP ポートを構成します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
true (デフォルト) の場合、トレース オブザーバーに送信されるデータは、各スパンを個別に送信する代わりにバッチ処理されます。
タイプ | シンボル |
|---|---|
デフォルト |
|
環境変数 |
|
トレース オブザーバーに送信されるデータの圧縮レベルを構成します。次のいずれかになります: :none 、 :low 、 :medium 、 :high 。圧縮を無効にするにはレベルを:noneに設定します。
計装
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
An allowlist of ActiveSupport notification event names (mostly caching events and message-serializer events) that the agent subscribes to. Any event name not included here is ignored. Provide complete event names only, such as cache_fetch_hit.active_support. Do not provide asterisks or regex patterns, and do not escape any characters with backslashes.
For the complete list of possible event names, see the Rails documentation's list of caching names and messages names.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時のActiveSupport::BroadcastLoggerの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。Rails バージョン 7.1 以上で使用されます。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時のActiveSupport::Loggerの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。Rails 7.1 より前のバージョンで使用されます。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Async::HTTP の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時のバニーの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Controls auto-instrumentation of the semantic_logger library at start-up. May be one of auto, prepend, chain, disabled.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の並列ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の AWS-sdk-firehose ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の aws_sdk_lambda ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の AWS-sdk-kinesis ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時のruby-kafkaライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の opensearch-ruby ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の rdkafka ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の AWS-sdk-sqs ライブラリの自動インストゥルメンテーションを制御します。 次のいずれかになります: auto 、 prepend 、 chain 、 disabled 。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の AWS-sdk-dynamodb ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時のファイバー クラスの自動インスツルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の並行 Ruby ライブラリの自動インスツルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Curb の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の遅延ジョブの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の elasticsearch ライブラリの自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Controls auto-instrumentation of ethon at start up. May be one of auto, prepend, chain, disabled.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Excon の自動計測を制御します。enabled 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Grape の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の gRPC クライアントの自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
A comma-separated list of regular expression patterns matching gRPC hostnames whose traffic New Relic should ignore. New Relic's gRPC client instrumentation skips tracing calls made to a host matching any of these patterns, and its gRPC server instrumentation skips tracing requests received by a server running on a matching host. For example, "private.com$,exception.*" Empty by default, meaning no traffic is ignored..
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の gRPC サーバーの自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の HTTPClient の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の http.rb gem の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Controls auto-instrumentation of httpx at start up. May be one of auto, prepend, chain, disabled.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Ruby標準ライブラリLoggerの起動時の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時のロギングライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の LogStasher ライブラリの自動インストゥルメンテーションを制御します。 次のいずれかになります: auto 、 prepend 、 chain 、 disabled 。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Controls instrumentation of Rails.event as structured logs. May be one of: enabled, disabled.
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
An array of Rails.event names to capture as structured log events. For example: [user.signup, payment.processed, order.created]. Leave empty to capture all Rails.event notifications. Events are logged with level UNKNOWN (ensuring they're never filtered) unless overridden via a :level key in the event payload.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時に Memcache の dalli gem の自動インスツルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時に Memcache の memcached gem の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時に Memcache の memcache-client gem の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Mongo の自動計測を制御します。enabled 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時のNet::HTTPの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の ruby-openai gem の自動インストゥルメンテーションを制御します。 次のいずれかになります: auto 、 prepend 、 chain 、 disabled 。高セキュリティ モードではデフォルトでdisabledになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Puma::Rackの自動計測を制御します。有効にすると、エージェントはPuma::Rack::Builderのto_appメソッドにフックして、アプリケーションの起動時に計測する gem を見つけます。auto 、 prepend 、 chain 、 disabledのいずれかです。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時のPuma::Rack::URLMapの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Rack の自動計測を制御します。有効にすると、エージェントはRack::Builderのto_appメソッドにフックして、アプリケーションの起動時に計測する gem を見つけます。auto 、 prepend 、 chain 、 disabledのいずれかです。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時のRack::URLMapの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の rake の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Redis の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の resque の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Roda の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Sinatra の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Stripe の自動計測を制御します。enabled 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時に ViewComponent の自動実行を制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時に Thread クラスの自動計測を制御して、エージェントが非同期トランザクション内でスパンを正しくネストできるようにします。これにより、エージェントは作成されたすべてのスレッドを自動的にトレースできなくなります ( instrumentation.thread.tracingを参照)。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時に Thread クラスの自動インスツルメンテーションを制御し、アプリケーションで作成されたすべてのスレッドにトレースを自動的に追加します。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Tilt テンプレート レンダリング ライブラリの自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
起動時の Typhoeus の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。
メッセージトレーサー
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはメッセージに関するメタデータを収集し、それらをセグメントパラメータとして添付します。
Mongo
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはトランザクショントレースでMongoクエリをキャプチャします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはトランザクショントレースでMongoクエリを難読化します。
オープンサーチ
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは、発言トレースで OpenSearch 書き込みをキャプチャします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは現場トレースで OpenSearch 書き込みを難読化します。
OpenTelemetry
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
A global configuration option for disabling all OpenTelemetry signals sent through New Relic. If false, no OpenTelemetry signals will be sent to New Relic. If true, the signal-specific enabled config option (e.g. opentelemetry.traces.enabled) determines whether telemetry of that signal type will be reported to New Relic.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
OpenTelemetryスパンからの瞬間トレース セグメントとタイムスライス メトリクスの作成を有効にします。 これは、OpenTelemetry スパンの New Relic UI エクスペリエンスの向上に役立ちます。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
OpenTelemetryのカンマ区切りのリスト。文字列として表されます(例: "AppTracer1, OpenTelemetry ::計装::Bunny::計装")、トレースがNew Relicに送信されます。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
OpenTelemetryのカンマ区切りのリスト。文字列として表されます(例: "AppTracer1,OpenTelemetry::Instrumentation::Bunny::Instrumentation")、トレースはNew Relicに送信されません。
プロセスホスト
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Specify a custom hostname for display in the New Relic UI.
Puma
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
Number of seconds between samples of Puma server statistics taken in the Puma master process.
Rake
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
Specify an Array of Rake tasks to automatically instrument. This configuration option converts the Array to a RegEx list. No rake tasks will be instrumented unless they're added to this list. If you'd like to allow all tasks by default, use rake.tasks: [.+]. For more information, visit the New Relic Rake Instrumentation docs.
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
Defines the number of seconds to wait for a connection to complete before running a Rake task.
ルール
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
Define transactions you want the agent to ignore by specifying a list of patterns matching the URIs to exclude. For more detail, see the docs on ignoring specific transactions.
セキュリティ
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, the security agent is loaded (a Ruby 'require' is performed).
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, the security agent is started (the agent runs in its event loop).
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Defines the mode for the security agent to operate in. Currently only IAST is supported.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
Defines the endpoint URL for posting security-related data.
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
アプリケーションがリッスンしているポート。この設定は Passenger サーバーでは必須です。エージェントはデフォルトで他のサーバーを検出します。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
セキュリティ エージェントが IAST スキャンで無視する API パスを定義します。無視する URI に一致する正規表現パターンの配列を受け入れます。正規表現パターンは、エンドポイントのない URL に完全に一致するものを見つける必要があります。例えば、 [".*account.*"], [".*/\api\/v1\/.*?\/login"]
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
セキュリティ エージェントが IAST スキャンで無視する HTTP 要求ヘッダーの配列。配列には、無視するヘッダーに一致するパターンのリストを指定する必要があります。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
HTTP リクエストの配列は、セキュリティ担当者がIASTスキャンで無視する必要があります。 配列には、HTTP リクエストに一致する無視するパターンのリストを指定する必要があります。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
セキュリティ エージェントが IAST スキャンで無視する HTTP リクエスト本文キーの配列。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, disables the detection of low-severity insecure settings. For example, hash, crypto, cookie, random generators, and trust boundary.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、ファイル操作関連の IAST 検出 (ファイル アクセスとアプリケーションの整合性違反) を無効にします。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、IAST スキャンでの SQL インジェクション検出が無効になります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, disables NoSQL injection detection in IAST scans.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、IAST スキャンでの LDAP インジェクション検出が無効になります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, disables JavaScript injection detection in IAST scans.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、IAST スキャンでのシステム コマンド インジェクション検出が無効になります。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, disables XPath injection detection in IAST scans.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, disables Server-Side Request Forgery (SSRF) detection in IAST scans.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、 IASTでの Reflected Cross-Site Script (RXSS) 検出を無効にします。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
アプリケーションの起動後に IAST スキャンが開始されるまでの遅延時間 (分単位) を指定します。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
Specifies the duration (in minutes) for which the IAST scan is performed.
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
IAST スキャンをいつ実行するかを設定する cron 式を指定します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
true場合、IAST はバックグラウンドでトレース データを継続的に収集できます。セキュリティ エージェントは収集されたデータを使用して、スケジュールされた時間に IAST スキャンを実行します。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
Sets the maximum number of HTTP requests allowed per minute for the IAST scan. Must be an integer between 12 and 3600 (default).
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
IAST 分析を実行する特定のエンティティのアプリケーション インスタンスの数。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
true場合、HTTP 応答本文の送信が有効になります。これを無効にすると、Reflected Cross-Site スクリプト (RXSS) の脆弱性検出も無効になります。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
A unique test identifier when running IAST in a CI/CD environment to differentiate between different test runs. For example, a build number.
サーバーレスモード
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは有効期間の短いサーバーレス機能での使用に適した合理化モードで動作します。 注意: 現在、 AWS Lambda 関数のみがサポートされており、このオプションはNew RelicのRuby Lambdaレイヤーオファリングなしで使用するためのものではありません。
Sidekiq
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
An array of strings that will collectively serve as an allowlist for filtering which Sidekiq job arguments get reported to New Relic. To capture any Sidekiq arguments, job.sidekiq.args.* must also be added to the separate attributes.include configuration option. Each string in this array will be turned into a regular expression via Regexp.new to permit advanced matching. For job argument hashes, if either a key or value matches, the pair will be included. All matching job argument array elements and job argument scalars will be included.
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
An array of strings that will collectively serve as a denylist for filtering which Sidekiq job arguments get reported to New Relic. To capture any Sidekiq arguments, job.sidekiq.args.* must also be added to the separate attributes.include configuration option. Each string in this array will be turned into a regular expression via Regexp.new to permit advanced matching. For job argument hashes, if either a key or value matches, the pair will be excluded. All matching job argument array elements and job argument scalars will be excluded.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは Sidekiq の再試行中に発生した例外を無視し、ジョブが永続的に失敗した場合にのみエラーを報告します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, the agent starts a new transaction when a Sidekiq job is executed during a web transaction. This prevents Sidekiq job execution time from being included in web transaction metrics.
Slow SQL
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは低速のSQLクエリを収集します。
タイプ | 浮く |
|---|---|
デフォルト |
|
環境変数 |
|
閾値を秒単位で指定します。エージェントは、このしきい値を超えた 低速の SQL クエリ と説明プランを収集します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは低速のSQLクエリでExplainプランを収集します。この設定を省略すると、低速SQLのExplainプランのデフォルト設定としてtransaction_tracer.explain_enabled設定が適用されます。
タイプ | 弦 |
|---|---|
デフォルト |
|
環境変数 |
|
低速 SQL クエリの難読化レベルを定義します。有効なオプションはobfuscated 、 rawまたはnoneです。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, the agent generates a longer sql_id for slow SQL traces. sql_id is used for aggregation of similar queries.
スパンイベント
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、スパンイベントのサンプリングを有効にします。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
トレースオブザーバーにストリーミングする際にバッファするスパンイベントの最大数を設定します。
タイプ | 整数 |
|---|---|
デフォルト |
|
環境変数 |
|
Defines the maximum number of span events reported from a single harvest. Any Integer between 1 and 10000 is valid. When configuring the agent for AI monitoring, set to max value 10000. This ensures the agent captures the maximum amount of distributed traces.
例外メッセージの除去
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, the agent strips messages from all exceptions except those in the allowed classes list. Enabled automatically in high security mode.
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
strip_exception_messagesがtrueの場合に、エージェントが削除しない例外のリストを指定します。例外はコンマで区切ります。たとえば、 "ImportantException,PreserveMessageException" 。
ストライプ
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
Stripe イベントのuser_dataハッシュ内のどのキーを New Relic に報告するかを指定する文字列の配列。この配列内の各文字列は、高度な一致を可能にするためにRegexp.newを介して正規表現に変換されます。値を["."]に設定すると、すべてのuser_dataが報告されます。
タイプ | 配列 |
|---|---|
デフォルト |
|
環境変数 |
|
Stripe イベントのuser_dataハッシュ内のどのキーや値を New Relic に報告しないかを指定する文字列の配列。この配列内の各文字列は、高度な一致を可能にするためにRegexp.newを介して正規表現に変換されます。各ハッシュ ペアについて、キーまたは値のいずれかが一致する場合、そのペアは報告されません。デフォルトでは、 user_dataは報告されません。このオプションは、 stripe.user_data.includeオプションも使用されている場合にのみ使用してください。
スレッドプロファイラー
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、スレッドプロファイラーの使用を有効にします。
活用
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはAWS環境で実行されていることを自動的に検出します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはAzure環境で実行されていることを自動的に検出します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはDockerで実行されていることを自動的に検出します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはGoogleCloudPlatform環境で実行されていることを自動的に検出します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, the agent reports the GCP instance id as the hostname when running on Google Cloud Run.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
If true, the agent prepends the K_REVISION value to the GCP instance id to form the hostname ({K_REVISION}-{instance id}) on Google Cloud Run. Has no effect unless utilization.gcp_cloud_run.use_instance_as_host is also true.
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはKubernetesで実行されていることを自動的に検出します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントはPivotalCloudFoundry環境で実行されていることを自動的に検出します。
タイプ | ブール値 |
|---|---|
デフォルト |
|
環境変数 |
|
trueの場合、エージェントは環境検出を並行して実行し、エージェントの起動時間を短縮します。