Javaエージェント設定：設定ファイル

エクステンションディレクトリを作成するには：

1. newrelic.jarとnewrelic.ymlがあるディレクトリに移動します。extensionsという名前のディレクトリを作成します。
2. newrelic.ymlで、プロパティextensions.dirが設定されていないことを確認します。

既存のJavaエクステンションディレクトリを使用するには：

1. newrelic.ymlファイルで、commonセクションを見つけます。
2. プロパティextensions.dirを使用して、ファイルの場所を指定します。

この設定はrequiredです。お使いのNew Relicアカウントに関連付けられたライセンスキーを指定する必要があります。このキーは、エージェントのデータを、New Relicサービスにあるアカウントと結びつけます。

この設定はrequiredです。New Relicへのデータのレポートに使用するアプリケーション名を定義します。

enable_auto_app_namingがfalseの場合、エージェントはすべてのデータをこのアプリケーションにレポートします。それ以外の場合、エージェントはバックグラウンドタスク（ウェブ以外のアプリケーションのトランザクション）のみをこのアプリケーションにレポートします。

複数のアプリケーションにデータをレポートするには、アプリケーション名をセミコロンで区切ります。たとえば、データをMy ApplicationとMy Application 2にレポートするには、以下を使用します。

app_name: My Application;My Application 2

アプリケーションの命名方法の詳細については、Javaアプリケーションを命名するを参照してください。

フラグを付けてエージェントを有効にします。この設定を使用して、エージェントに実行するかどうかを強制します。

アプリケーションのApdexスコアの、秒単位でのapdex_t閾値。Javaエージェントバージョン1.2.008以上では、apdex_tの値はUIで設定され、newrelic.ymlにある値は無視されます。

同じマシン上の同じアプリについて、JVMを区別するための数。New Relicは一意性を保つためにhost/portを使用しているため、このようなスイッチを各JVMの起動引数に付けて、JVMを区別できます:

-Dnewrelic.config.appserver_port=8081

appserver_portを使用してJVMに名前を付け再起動すると、ドロップダウンとプロファイルインタフェースで個別に表示できるようになります。

New Relicに送信されたすべてのデータのエージェントログファイルへのプレーンテキストロギングを有効にします。この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

New Relicへのセキュアな接続を確立するためにエージェントが使用するカスタムSSL証明書バンドルへのパスを指定します。カスタムSSL証明書バンドルにNew Relicに接続するのに十分な証明書が含まれていない場合は、必要な証明書をカスタム証明書バンドルにマージする必要があります。

各ウェブアプリについて別個に、データのレポート作成を有効にします。自動アプリネーミングのサポートを有効にするには、trueに設定します。各ウェブアプリの名前は自動的に検知され、エージェントはそれぞれについてデータを別個にレポートします。これにより、New Relicのウェブアプリのパフォーマンスが、より詳細な粒度で分類されます。

詳細については、自動的なアプリケーションのネーミングをご覧ください。

アプリケーションの命名方法の詳細については、Javaアプリケーションを命名するを参照してください。

コンポーネントベースのトランザクションネーミングを有効にします。コンポーネントベースのトランザクションネーミングを有効にするには、trueに設定します。トランザクションの名前としてウェブリクエストのURIを使用するには、falseに設定します。詳細については、ウェブトランザクションのネーミングをご覧ください。

@Traceアノテーションを使用して、すべてのインストゥルメンテーションを有効にします。これを無効にすると、@Traceアノテーションが無視されます。

一部のエージェント機能で使用されるイベント取り込みURI。デフォルトで米国生産取り込みエンドポイントに設定されます。イベントを他の取り込みエンドポイントに送信するように手動で設定できます（例：EU生産：https://insights-collector.eu01.nr-data.net/v1/accounts/events）。

FedRAMP準拠のお客様は、FedRAMPに準拠したエンドポイントを使用する必要があります。 https://gov-insights-collector.newrelic.com/v1/accounts/events

オプションのエクステンションディレクトリの場所を定義します。このプロパティを設定しない場合、エージェントはnewrelic.jarやnewrelic.ymlと同じディレクトリでextensionsという名前のサブディレクトリを検索します。

高いセキュリティを有効にするには、このプロパティをtrueに設定し、New Relicユーザーインタフェースの高セキュリティプロパティを有効にする必要があります。高いセキュリティを有効にするとSSLがオンになり、リクエストとメッセージキューのパラメーターが収集されず、クエリを生の形式でNew Relicに送信できません。

値gov-collector.newrelic.comを使用して、エージェントが使用するFedRAMP準拠エンドポイントを設定する機能を提供します。

アカウントの有効な挿入APIキーです。これは現在、エージェントによって使用されていません。

このアプリにタグを添付します。

このオプションでタグが有効になり、ラベル機能が置き換えられたことに注意してください。ここで、過去のラベルを引き続きクエリできます。以下のようにセミコロンを区切り文字として使用して、複数のタグを追加できます。

-Dnewrelic.config.labels="tagName1:tagValue1;tagName2:tagValue2;tagName3:tagValue3"

まれに、従来の非同期APIを使用して非同期サーブレット、またはJetty Continuationのライフサイクルを追跡するインストゥルメンテーションでメモリリークが発生することがあります。メモリリークは、一時停止されたものの再開されなかった、リークされたトランザクションとして現れます。この設定は、そのようなシナリオの発生を防ぐための回避策として機能します。このようなメモリリークが発生した場合にのみ、この回避策を有効にすることをお勧めします。

各スタックトレースからエージェントが収集する行数を制限します。この値を増やすと、エージェントが使用するメモリの量とNew Relicに送信されるデータの量が増えるため、パフォーマンスに影響が生じる場合があります。

一部のエージェント機能で使用されるメトリクス取り込みURI。デフォルトで米国生産取り込みエンドポイントに設定されます。メトリクスを他の取り込みエンドポイントに送信するように手動で設定できます（例：EU生産のURI：https://metric-api.eu.newrelic.com/metric/v1）。

FedRAMP準拠のお客様は、FedRAMPに準拠したエンドポイントを使用する必要があります。 https://gov-metric-api.newrelic.com/metric/v1

New Relicコレクターへの接続経路となるプロキシホスト。プロキシを使用している場合、ホスト設定が必須です。その他のプロキシ設定はオプションです。

プロキシ認証のパスワード。プロキシを使用している場合、ホスト設定が必須です。その他のプロキシ設定はオプションです。ユーザー名とパスワード設定を使用して、プロキシサーバーからのBasic Authのチャレンジの認証を行います。

プロキシホストのポート番号。プロキシを使用している場合、ホスト設定が必須です。その他のプロキシ設定はオプションです。

Basic（クリアテキスト）認証など、プロキシ認証のユーザー名。プロキシを使用している場合、ホスト設定が必須です。その他のプロキシ設定はオプションです。ユーザー名とパスワード設定を使用して、プロキシサーバーからのBasic Authのチャレンジの認証を行います。

使用したプロキシスキーム。proxy_scheme: "https"を設定すると、エージェントはHTTPSスキームを使用してプロキシを通じて接続できるようになります。

Reactor Nettyに対してエラーが報告されたかどうか。デフォルトはfalseです。trueに設定すると、Reactor Nettyエラーがレポートされます。

エージェントが直近のメトリクスデータをJVMのシャットダウンの前にNew Relicに送信できるようにするには、JVMシャットダウンの遅延を有効にします。

エージェントがsend_data_on_exit設定を使用するまでの秒数。

JVM設定のNew Relicへのレポートを有効にします。

trueに設定すると、JVMプロパティがNew Relicに送信されます。

SSLに移動するには、New Relicコレクターとの接続が必要です。

エージェントはデフォルトでHTTPSを介してNew Relicと通信します。New Relicは、APMとNew Relic REST APIへのすべてのトラフィックにHTTPSを要求します。

この作業は、アプリケーションコードを処理するスレッドとは非同期的に行われるので、レスポンスタイムはこの変更の影響を直接には受けません。

エージェントを有効にして、アプリの起動直後にNew Relicコレクターを接続します。

トランザクショントレースの詳細をより簡潔にするため、エージェントはScala Futuresをトランザクションセグメントとしてレポートせず、このFuturesはトランザクションの合計時間には寄与しません。

scala_futures_as_segmentsを有効にすると、オーバーヘッドが増加します。Scala Futuresにトランザクションセグメントとしてレポートさせたい場合、トランザクショントレースで表示し、有効化できます:

scala_futures_as_segments:
  enabled: true

セグメントの排他時間が合計トランザクションタイムの2%未満の場合、そのメソッド呼び出しのメトリクスはJava/otherで集計されます。

trim_statsをfalseに設定すると、この動作が無効になり、メトリクスを個別に表示できるようになります。

trim_stats: false

エージェントバージョン8.7.0以降、 trueに設定され、エージェントがJBoss EAP/Wildflyで実行されている場合、エージェントはパッケージjavax.management下のクラスをシステムクラスローダーで読み込む必要がなくなります。これは、J2EE/Jakarta Management APIが使用されている場合の、JBossモジュールでのアプリケーション起動の問題を解決するために追加されました。詳細については、JBoss/Wildflyのトラブルシューティングに関するドキュメントを参照してください。

サポートされていないJavaバージョンでエージェントを実行できるようにする試験的なフラグ。

表示名を設定して、New Relic UIで「host:port」ラベルを追加します。Javaエージェント3.17以降が必要です。

newrelic設定ファイルへの完全修飾パスを含む文字列。空白の場合、エージェントはnewrelic.ymlがnewrelic.jarと同じディレクトリにあると仮定します。

デバッグロギングを有効にします。

使用するエージェントの環境設定を含む文字列。

エージェントのホームディレクトリを含む文字列。これはデフォルトで、エージェントのjarfileと同じディレクトリになります。

エージェントログファイルの名前を含む文字列。

trueに設定すると、AIモニタリングが有効化されます。

falseに設定すると、エージェントはLLMイベントでキャプチャされた入力および出力コンテンツ（プロンプトやレスポンスのテキスト文字列など）を省略します。これは、LLMとの間で送受信される機密データを記録したくない場合のオプションのセキュリティ設定です。

この設定を使用して、すべての属性をオンまたはオフにできます。

属性が有効になっている場合、このリストにある属性のキーはNew Relicに送信されます。カンマでリストにあるキーを区切ります。例：

key1, key2, key3

エージェント属性のルールも参照してください。

このリストにある属性キーのいずれも、New Relicに送信されることはありません。カンマでリストにあるキーを区切ります。例：

key1, key2, key3

エージェント属性のルールも参照してください。

属性レポートは、次の方法で設定できます。

YAML：

attributes:
http_attribute_mode: both

システムプロパティ：

-Dnewrelic.config.attributes.http_attribute_mode=both

環境変数：

NEW_RELIC_ATTRIBUTES_HTTP_ATTRIBUTE=both

設定オプションは次のとおりです。

• standard ：レポートには標準（つまり、OTEL）属性が使用されます。この設定を推奨します。これにより、機能への影響が最小限に抑えられ、属性レポートの最低レベルの取り込みが維持されます。
• legacy : レポートは再導入されたHTTP属性によって実行され、この設定は現在または今後の機能に影響を与える可能性があります。
• both : これはデフォルト設定であり、レポートは再導入されたHTTP属性とOTEL属性によって実行されます。この設定では、データの取り込みも増加します。

token.expire()で明示的に失効されていない非同期トークンをエージェントが自動的に失効させるまでの秒数。使用の説明については、トークン: 非同期スレッドの接続をご覧ください。

segment.end()またはsegment.ignore()で明示的に終了していないセグメントをエージェントが自動的に終了するまでの秒数。使用の説明については、セグメント: 時間によらない非同期アクティビティをご覧ください。

デフォルトでは、エージェントはコンパイルされたJSPでAPI呼び出しを自動的に挿入し、モニタリングJavaScriptをウェブページに挿入します。この動作をオフにするには、この属性をfalseに設定します。

auto_instrumentがtrueの場合、デフォルトですべてのページがインストゥルメントされます。自動インストゥルメンテーションを省略するすべてのページをここに一覧表示します。このページで以後も手動インストゥルメンテーションを使用できます。

たとえば、

browser_monitoring:
  disabled_auto_pages: /WEB-INF/jsp/testpage_1.jsp, /WEB-INF/jsp/testpage_2.jsp

この設定を使用して、ブラウザモニタリングのすべての属性をオンまたはオフにできます。これは、クエリを行えるデータです。attributes.enabledがルートレベルでfalseの場合、browser_monitoringの下でこのプロパティがどのように設定されているかにかかわらず、ブラウザモニタリングで属性は送信されません。

属性がbrowser_monitoringに関して有効になっている場合は、このリストにあるすべての属性キーがページビューでNew Relicに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストにある属性キーのいずれも、ページビューでNew Relicに送信されることはありません。詳しくはエージェント属性ルールを参照してください。

アプリケーションの動作が想定どおりの場合、サーキットブレーカーを無効にすることもできます。

ブレーカーのトリップを下回るフリーヒープメモリの比率をカスタマイズします。フリーヒープメモリの比率がmemory_threshold以下で、ガーベージコレクションに費やしたCPUの時間がgc_cpu_thresholdより多い場合、ブレーカーがトリップします。ブレーカーのトリップを発生しにくくするには、memory_thresholdを減らすか、gc_cpu_thresholdを増やします。アプリケーションの運用パフォーマンスと動作に基づき、必要に応じてこの値を調整します。

ブレーカーのトリップを上回るCPUのガーベージコレクション時間の比率をカスタマイズします。フリーヒープメモリの比率がmemory_threshold以下で、ガーベージコレクションに費やしたCPUの時間がgc_cpu_thresholdより多い場合、ブレーカーがトリップします。ブレーカーのトリップを発生しにくくするには、memory_thresholdを減らすか、gc_cpu_thresholdを増やします。アプリケーションの運用パフォーマンスと動作に基づき、必要に応じてこの値を調整します。

エージェントがAWSメタデータAPIをポーリングするかどうかを決定します。

エージェントがAzureメタデータAPIをポーリングするかどうかを決定します。

エージェントがGoogle Cloud PlatformメタデータAPIをポーリングするかどうかを決定します。

エージェントがKUBERNETES_SERVICE_HOST環境変数を報告するかどうかを決定します。

エージェントがPivotal Cloud Foundry環境変数を読み取るかどうかを決定します。

エージェントがDocker情報をファイルシステムから読み取るかどうかを決定します。

エージェントバージョン7.10.0では、コードレベルのメトリクスはデフォルトで無効になっています。オンにするには、trueに設定します。エージェントバージョン7.11.0以降では、前述のように、デフォルト設定はtrueです。

クロスアプリケーショントレーシングは、デフォルトで有効になっています。オフにするには、falseに設定します。

これにより、カスタムイベントサービスが有効になります。

属性値の最大サイズ。それを超えると値は切り捨てられます。デフォルトは255バイト（UTF-8文字セットエンコードの場合）で、最大制限は4095です。

この設定はJavaエージェントバージョン8.9.0以降に存在します。

• 60秒ごとにレポートされた、サンプリングされたカスタムイベントの最大数。
• AIモニタリングのエージェントを構成する場合は、最大値100000に設定します。 最大量のLLMイベントのキャプチャを保証します

有効にすると、拡張されたSpringトランザクションの名前付けにより、Springコントローラーから発生するすべてのトランザクションに、定義されたルートとHTTPメソッドの後に名前が付けられます。例：/customer/v1/edit (POST)。これには、WebMVC関連のアノテーション（@RestController、@Controller、@RequestMappingなど）を使用してインターフェイス/クラスを実装または拡張するコントローラーが含まれます。

デフォルトでは、これはfalseに設定されており、コントローラーのクラス名とメソッドに基づいてこれらのタイプのコントローラーのトランザクションに名前が付けられます。たとえば、CustomerController/edit。これは、以前のエージェントバージョンから引き継がれた命名ロジックです。実際のクラスに存在するすべての関連アノテーションを備えた「標準」コントローラーでも、ルートとHTTPメソッドに基づいて名前が付けられます。

この設定はJavaエージェントバージョン8.9.0以降に存在します。

デフォルトでは、組み込みアクチュエータエンドポイントとカスタムアクチュエータエンドポイント（@endpointアノテーションとそのサブクラスを使用）はすべて、New RelicがOperationHandler/handleと命名します。この設定を有効にすると、トランザクション名に実際のベースアクチュエータのエンドポイントURIが反映されます。たとえば、/actuator/loggersまたはactuator/loggers/com.newrelicを呼び出すと、トランザクション名はactuator/loggers (GET)となります。これはMGIを防ぐことを目的としています。

Spring Boot v3以降を使用する場合にサポートされます。

この設定はJavaエージェントバージョン8.9.0以降に存在します。

どのユーザー指定の方法でインストゥルメントするかの決定にエージェントが使用するアノテーションクラスのフルクラス名を含む文字列。カスタムアノテーションの詳細については、Javaカスタムメトリック収集をご覧ください。

userPrincipal名を取得するには、このオプションを有効にします。この名前はトランザクショントレース属性（属性名userとenduser.id）として含まれ、クエリを行うことができます。また、エラー受信トレイで、エラーグループの影響を受けるユーザーの数を確認することもできます。

これをfalseに設定し、ディストリビューティッド（分散）トレーシングを無効にします。たとえば、設定ファイルで、以下を使用します。

distributed_tracing:
  enabled: false

ディストリビューティッド（分散）トレーシングを無効にするその他のオプションは次のとおりです。

システムプロパティ：

-Dnewrelic.config.distributed_tracing.enabled=false

環境変数：

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=false

デフォルトで、エージェントのサポートされたバージョンは、newrelicヘッダーとディストリビューティッド（分散）トレーシング用のW3Cトレースコンテキストヘッダーの両方を使用します。newrelicディストリビューティッド（分散）トレーシングヘッダーを使用すると、W3Cトレースコンテキストヘッダーをサポートしない古いエージェントとの相互運用が可能になります。W3Cトレースコンテキストヘッダーをサポートするエージェントバージョンは、ディストリビューティッド（分散）トレーシング用のnewrelicヘッダーよりこのヘッダーを優先します。

newrelicヘッダーを使用しない場合、これをtrueに設定すると、エージェントがnewrelicヘッダーを除外し、ディストリビューティッド（分散）トレーシング用のW3Cトレースコンテキストヘッダーのみを使用するようになります。

たとえば、設定ファイルでnewrelicヘッダーを除外するには、次のものを使用します。

distributed_tracing:
  exclude_newrelic_header: true

システムプロパティを使用してnewrelicヘッダーを除外するには、次のものを使用します。

-Dnewrelic.config.distributed_tracing.exclude_newrelic_header=true

エラー収集を有効にします。

指定された例外クラス名は無視され、エラー率やApdexスコアには影響はなく、またAPMにレポートされません。 Cannot be specified by system property.

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

たとえば、

error_collector:
  ignore_classes:
    - "com.example.MyException"
    - "com.example.DifferentException"

環境変数を使用して、無視する例外クラス名を一覧表示できます。

NEW_RELIC_ERROR_COLLECTOR_IGNORE_CLASSES="[\"com.example.MyException\", \"com.example.DifferentException\"]"

エージェントが無視すべき例外クラス名を指定します。無視されたメッセージはエラー率やApdexスコアには影響を与えず、またAPMにレポートされません。以下で構成されるyamlペアを含みます。

• APMにレポートされない完全修飾例外クラス名

  AND

• 一致する例外messageのリスト（少なくとも1つ必要）

  例外クラス名がエラーと一致するが、メッセージは一致しない場合、そのエラーは無視will not。メッセージ文字列は、一致のcontainsを使用します。メッセージは自身には提供できず、必ず完全修飾クラス名とペアになっている必要があります。 Cannot be specified by system property.

  この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

  たとえば、

  error_collector:
    ignore_messages:
      com.example.MyException:
        - "Some error message to ignore"
        - "Some other error message to ignore"
      com.example.DifferentException:
        - "Some different error message to ignore"

  コピー

  環境変数を使用して、例外クラス名と無視するメッセージを一覧表示できます。

  NEW_RELIC_ERROR_COLLECTOR_IGNORE_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"

  コピー

エラーとして扱わないHTTPステータスコードの個別の範囲とダッシュ付きの範囲で構成される、カンマ区切りのリスト。

このプロパティがnewrelic.yml設定ファイルでコメントアウトされている場合、404ステータスコードは自動的に無視されます。サーバー側の設定を使用する場合、無視するにはステータスコード404を指定する必要があります。

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

たとえば、

error_collector:
  ignore_status_codes: 404,507-511

指定された例外クラスが、エラーをAPMにレポートする間にエラー率やApdexスコアに影響を与えないようにします。 Cannot be specified by system property.

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

たとえば、

error_collector:
  expected_classes:
    - "com.example.MyException"
    - "com.example.DifferentException"

環境変数を使用して、予想例外クラス名を一覧表示できます。

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_CLASSES="[\"com.example.MyException\", \"com.example.DifferentException\"]"

想定済みとマークされ、エラー率やApdexスコアに影響を与えないようにするための完全修飾例外クラス名と、一致する例外messageのリストで構成される、yamlペアを含みます。後者では、少なくとも1つのメッセージが必要です。例外クラス名がエラーと一致するが、メッセージが一致しない場合、そのエラーは想定済みとマークされず、エラー率やApdexスコアには影響を与えwill not。

メッセージ文字列は、一致のcontainsを使用します。メッセージは自身には提供できず、必ず完全修飾クラス名とペアになっている必要があります。 Cannot be specified by system property.

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

たとえば、

error_collector:
  expected_messages:
    com.example.MyException:
      - "Some expected error message"
      - "Some other expected error message"
    com.example.DifferentException:
      - "Some different expected error message"

環境変数を使用して、予想例外クラス名とメッセージを一覧表示できます。

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"

想定済みとマークされ、エラー率やApdexスコアに影響を与えない、HTTPステータスコードの個別の範囲とダッシュ付き範囲で構成される、カンマ区切りのリスト。

この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

たとえば、

error_collector:
  expected_status_codes: 415,500-506

予期されるステータスコードは、NEW_RELIC_ERROR_COLLECTOR_EXPECTED_STATUS_CODES環境変数を指定することもできます。

この設定を使用して、トレースエラーのすべての属性をオンまたはオフにできます。ルートレベルでattributes.enabledがfalseである場合は、このプロパティがerror_collectorで設定されているかにかかわらず、属性がトレースエラーに送られることはありません。

属性がトレースエラーについて有効になっている場合、このリストにあるすべての属性キーが、トレースされたエラーでNew Relicに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストにある属性キーのいずれも、トレースエラーでNew Relicに送信されることはありません。詳しくはエージェント属性ルールを参照してください。

トランザクションで複数のエラーが検出された場合、デフォルトでは最後のエラーのみがレポートされます。このプロパティをfalseに設定すると、最初に検出されたエラーのみがレポートされます。詳細については、noticeError APIを参照してください。例：

error_collector:
  ignoreErrorPriority: false

指定されたすべての例外クラス名は、エラーとして扱われることはありません。Javaエージェント3.40.0で非推奨となり、ignore_classesで置換されています。

たとえば、

error_collector:
  ignore_errors: some.other.MyException

この設定を使用して、エラーとトランザクショントレースについて継続中のリクエストURIの収集を制御できます。この情報の収集を無効にするには、これをtrueに設定します。

表示名を設定して、New Relic UIで「host:port」ラベルを追加します。

ホスト名を決定できない場合、ホストのIPアドレスを使用します。このプロパティは、IPv4またはIPv6アドレスを使用するかどうかを決定します。デフォルトはIPv4です。

有効なInfinite Tracing トレース オブザーバーのホストエントリを取得する方法については、トレースオブザーバーを検索または作成するをご覧ください。

YAMLを介して設定することもできます：

infinite_tracing:
  trace_observer:
    host: YOUR_TRACE_OBSERVER_HOST

システムプロパティnewrelic.config.infinite_tracing.trace_observer.hostまたは環境変数NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOSTを使用することもできます。

デフォルトでは、@TraceLambdaアノテーションは無効になっています。ラムダ式をトレースするためにアノテーション機能を使用するには、次のように機能を明示的に有効にする必要があります。

YAMLを介して設定することもできます：

instrumentation:
  trace_lambda:
    enabled: true

システムプロパティnewrelic.config.instrumentation.trace_lambda.enabled=trueまたは環境変数NEW_RELIC_INSTRUMENTATION_TRACE_LAMBDA_ENABLEDを使用することもできます。

Jarコレクションおよびレポートの有効化/無効化に使用されます。

一時的なJarのコレクションの有効化/無効化に使用されます。一時的なJarは、java.io.tmpdirシステムプロパティによって指定されたディレクトリにあるJarです。

毎秒処理するjarの最大数。正の数値でなければなりません。

trueに設定すると、JFRを使用したリアルタイムプロファイリングが有効になります。この設定は動的に適用されるため、JVMを再起動する必要はありません。

trueに設定すると、各収集バッチ内のすべてのJFRメトリクスおよびイベントを表示する監査ログが有効になります。監査ログは非常に詳細であり、トラブルシューティングの目的にのみ使用する必要があります。

この設定を使用して、すべてのJMX機能をオンまたはオフにできます。

この設定を有効にすると、JavaエージェントがリンクメタデータをリモートJMXに公開できるようになります。

trueに設定して、Logs in contextのコア機能を有効にします。有効にすると、ログが装飾されているか、New Relicに送信されているかにかかわらず、追加のロギングフレームワークインストゥルメンテーションが有効になります。

ログメトリクスのコレクションを含め、この機能を完全に無効にするには、falseに設定します。

New Relicへのアプリケーションログの送信を有効にします。

これをtrueに設定すると、装飾されたログがNew Relicに送信されます。

装飾されたログをNew Relicに送信したくない場合は、これをfalseに設定します。

送信する1分あたりのログラインの最大数を指定する正の整数。

ログの送信を事実上無効にするには、これを0に設定します。

これをより低い値に設定して、送信されるログラインの量を減らします（ログサンプリングの原因になる場合があります）。これをより高い値に設定すると、より多くのログラインが送信されます。

各ログは、関連トランザクションと同じ優先度を受け取ります。トランザクション以外で発生するログは、ランダムな優先度を受け取ります。max_samples_storedによって制限されているため、一部のログが含まれない場合があります。たとえば、ロギングmax_samples_storedが10,000に設定され、トランザクション1に10,000のログエントリがある場合、トランザクション1のログエントリのみが記録されます。トランザクション1のログが10,000未満の場合、トランザクション1のすべてのログを受け取ります。まだスペースがある場合は、トランザクション2のすべてのログを受け取るなどとなります。

サンプリングされたトランザクションのすべてのログが記録された後も、 max_samples_storedの限度に達していない場合は、サンプリングに含まれていないトランザクションのログメッセージが送信されます。残っている場合は、トランザクション以外のログメッセージが記録されます。

これをtrueに設定すると、コンテキストデータをログ属性としてNew Relicに送信します。

ログのコンテキストデータをNew Relicに送信しない場合は、これをfalseに設定します。

context_dataがログ転送に対して有効になっている場合、このリストにあるすべての属性キーがログレコードでNew Relicに送信されます。このリストが空の場合は、すべての属性が送信されます。

context_dataがログ転送に対して有効になっている場合、このリストにあるすべての属性キーはログレコードでNew Relicに送信されません。

包含リストと除外リストは、属性ルールで定義されているルールExclude overrides include、More specific rules take priority、Keys are case-sensitiveおよびUse an asterisk for wildcardsに従います。

APM Summaryページのチャートに表示されるログとログレベルに関するメトリクス情報の取得を有効にします。

エージェントがログに関するメトリック情報を取得できるようにするには、この設定をtrueのままにします。

これをfalseに設定すると、この機能を無効にできます。

ローカルに保存されたログラインを装飾するかどうかを制御します。これは、ログ転送が有効かどうかとは無関係であり、別のログ転送ソリューションを使用したい顧客をサポートするために使用します。

これをtrueに設定すると、エージェントは、対応のフレームワークによってローカルに保存されたログラインにメタデータをリンクするコンテキスト内のログを追加します。

これをfalseに設定すると、ローカル装飾機能がオフになります。これは、New Relicに送信されるログラインの装飾には影響しません。

ログのローテーションを毎日行うには、trueに設定します。

ログローテーションを使用する際に保存するログファイルの最大数。

制限のないログファイル名または標準出力に記録される文字列STDOUT。

ログファイルのパス。

ログの詳細度のレベル。エージェントのyaml設定ファイルでこの設定を変更すると、動的に更新されます。ただし、環境変数とシステムプロパティは動的に更新されません。

エージェントは自身のログファイルを使用して、自身のロギングをアプリケーションのロギングとは別個に保存します。詳細であるために有効なオプションは次のとおりです：

• off

• severe

• warning

• info

• fine

• finer

• finest

  注意

  debugまたはtraceロギングは、New Relic Supportから使用を依頼されない限り、使用しないでください。これらのロギングレベルでは、過剰なオーバーヘッドが発生する可能性があります。ほとんどの場合はinfoを使用してください。

  この設定は動的なので、エージェントを実行すると、JVMを再起動せずにnewrelic.ymlが変更されます。

ログファイルのローテーション時の、キロバイト単位でのログファイルのサイズ。制限をなくすには、0に設定します。

メッセージプロパティをトレーサー属性に追加します。オフにするには、falseに設定します。

エージェントのOpenTelemetry SDK自動設定機能を有効にできます。 システムプロパティを介して設定できます。

-Dnewrelic.config.opentelemetry.sdk.autoconfigure.enabled=true

デフォルトはtrueです。

すべてのセキュリティ機能を完全に無効にするには、このフラグをfalseに設定します。このプロパティは、アプリケーション起動時に1回だけ読み込まれます。デフォルトはfalseです。

New Relicにセキュリティデータを送信するかどうかを決定します。これが無効で、agent.enabledがtrueの場合、セキュリティモジュールは実行されますが、データは送信されません。デフォルトはfalseです。

New Relicセキュリティにはモード、IASTがあります。デフォルトはIASTです。IASTスキャンは侵襲性であるため、実稼働環境または実稼働データが処理される環境でこのモードを有効にしないでください。

New RelicセキュリティのSaaS接続のURL。これは、Securityエージェントがデータを送信するエンドポイントであり、APM Javaエージェント用に設定した環境と一致する必要があります。

米国の実稼働環境：wss://csec.nr-data.net

RCIセキュリティイベント検出を有効にします。デフォルトはtrueです。

RXSSセキュリティイベント検出を有効にします。デフォルトはtrueです。

逆シリアル化セキュリティイベント検出を有効にします。デフォルトはtrueです。

低速トランザクション検出の有効化/無効化に使用されます。

SlowTransactionイベントが報告されるまでの、トランザクションの所要時間をミリ秒単位で決定します。

これをtrueに設定すると、 トランザクションの完了時に、定義された閾値を超えていないかどうかがすべてのトランザクションでチェックされます。 多数のトランザクションが閾値を超えると、SlowTransactionイベントごとにスタックトレースが送信されるため、計算コストが高くなる可能性があることに注意してください。

スパンイベントのレポートの有効化/無効化に使用します。

• エージェント収集サイクル中にキャプチャできるスパンイベントの数を決定します。Javaエージェント7.4.0以降で利用可能です。

• AIモニタリングのエージェントを構成する場合は、最大値10000に設定します。 最大量のトレースのキャプチャを保証します

  重要

  スパンイベントの数を増やすと、エージェントのオーバーヘッドが増える可能性があります。

この設定は、スパンイベントのすべての属性をオンまたはオフにするのに使用できます。ルートレベルでattributes.enabledがfalseである場合は、このプロパティ (span_events.attributes.enabled) の設定にかかわらず、属性がスパンイベントに送られることはありません。

属性がスパンイベントに関して有効になっている場合は、このリストにあるすべての属性キーがspan_eventsでNew Relicに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストにある属性キーのいずれも、スパンイベントでNew Relicに送信されることはありません。詳しくはエージェント属性ルールを参照してください。

デフォルトでは、これはfalseに設定されます。つまり、エージェントはすべての例外からのメッセージをNew Relicコレクターに送信します。

• これをtrueに設定すると、誤って機密情報を取得しないようにするため、エージェントは例外からメッセージを除去します。
• 高セキュリティモードを有効にすると、これは自動的にtrueに設定されます。
• enabledをtrueに設定するが、エージェントで特定の例外からメッセージを取得したい場合、例外を許可リストに追加します。

enabledをtrueに設定するが、エージェントで特定の例外のメッセージを取得したい場合、各例外をカンマで区切ってwhitelistに追加します。

enabledをtrueに設定するが、エージェントで特定の例外のメッセージを取得したい場合、各例外をカンマで区切ってallowed_classesに追加します。

スレッドプロファイラーを有効にします。

トランザクションイベントサービスを有効にします。

60秒ごとにレポートされた、サンプリングされたトランザクションイベントの最大数。

ペアリングされたキーheader_nameとオプションのheader_aliasのマップのリスト。トランザクション属性として追加するカスタムHTTPリクエストヘッダーを1つ以上選択します。

複数のヘッダー設定を一覧表示できます。

transaction_events:
  custom_request_headers:
    -
      header_name: "X-Custom-Header-1"
    -
      header_name: "X-Custom-Header-2"
      header_alias: "CustomHeader2alias"

最初のマップセットで、X-Custom-Header-1は、リクエストオブジェクトから対応する値のヘッダー名としてエージェントにより取得されレポートされます。header_nameは、New Relicに送信される属性の名前ともなります。

第二のマップセットで、リクエストヘッダーはX-Custom-Header-2ですが、CustomHeader2aliasはNew Relicに送信される名前です。

この設定を使用して、トランザクションイベントのすべての属性をオンまたはオフにできます。ルートレベルでattributes.enabledがfalseである場合は、このプロパティがtransaction_eventsで設定されているかにかかわらず、属性がトランザクションイベントに送られることはありません。

属性がトランザクションイベントについて有効になっている場合、このリストにあるすべての属性キーが、トランザクションイベントでNew Relicに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストにある属性キーのいずれも、トランザクションイベントでNew Relicに送信されることはありません。詳しくはエージェント属性ルールを参照してください。

この設定を使用して、トランザクションセグメントのすべての属性をオンまたはオフにできます。ルートレベルでattributes.enabledがfalseである場合は、このプロパティ (transaction_segments.attributes.enabled) が設定されているかにかかわらず、属性がトランザクションセグメントに送信されることはありません。

属性がトランザクションセグメントについて有効になっている場合、このリストにあるすべての属性キーが、トランザクションセグメントでNew Relicに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストにある属性キーのいずれも、トランザクションセグメントでNew Relicに送信されることはありません。詳しくはエージェント属性ルールを参照してください。

トランザクショントレーサーは、デフォルトで有効になっています。オフにするには、falseに設定します。

エージェントがスロークエリのEXPLAINプランを捕捉するかどうかを決定します。 MySQLとPostgreSQLでのみサポートされています。

スロークエリとEXPLAINプラン（サポートされている場合）の捕捉の上限となる、クエリ実行時間の秒単位の閾値。record_sqlがrawまたはobfuscatedに設定されている場合にのみ、スロークエリに表示されます。explain_enabledがtrueに設定されている場合にのみ、EXPLAINプランに表示されます。

SQLクエリ設定の文字制限。膨大な情報を含む遅いSQLクエリが多数ある場合、パフォーマンスやNew Relicでのデータ表示の速度に悪影響が及ぶ場合があります。情報とパフォーマンスの適切なバランスが見つかるまで、値を徐々に上げます。

New Relicへのアップロードではなく、クエリのエージェントログファイルへのロギングを有効にするには、trueに設定します。record_sqlモードを使用して、クエリのロギングを行います。

トランザクショントレーサーがオンの場合、クエリステートメントをオプションで記録できます。レコーダーには次の3つのモードがあります：

• off：クエリを送信しません。
• raw：クエリステートメントを元の形式で送信します。
• obfuscated：数字と文字列リテラルを除去します。

このオプションはPlay 2.x+専用です。Play/Scalaインストゥルメンテーションは、Thread.getStackTrace()を使用してトレーサーのネーミングを改善できますが、その代わりにオーバーヘッドが増加します。

SQL呼び出しからスタックトレースを収集するための閾値（秒単位）を定義します。SQLステートメントがこの閾値を超えると、エージェントが現在のスタックトレースを取得します。これは、長いSQL呼び出しの発信元を特定するのに役立ちます。

この設定を使用して、さまざまなトランザクショントレースを制御します。top_nは、トレースを作成する一意のスロートランザクションの数を表す整数です。

• トランザクショントレースが、アプリで実際に最も遅いトランザクションを正確に反映するようにするには、この値をlowerします。

• より広範なトランザクションの配列をサンプリングする場合は、値をhigherします。

  値0の場合、最も遅いトランザクションonlyがトレースされることになります。これは最適ではないと考えられていますが、1つや2つのトランザクションが常に最も遅い場合があり、同じトランザクションのトレースを繰り返し見ても、おそらくあまり意味がないと思われます。

  同じトランザクションが頻繁に最も遅い場合、top_n設定により、Javaエージェントで（その期間で）最も遅いn個のトランザクションのサンプリングを行えます。これにより、アプリケーションの知見の多様性と個数が増えます。

トランザクションのトレースをいつ行えるかを決定するのに使用する時間閾値。トランザクションのレスポンスタイムがこの閾値を超えると、トランザクショントレースが記録され、New Relicに送信されます。

デフォルトはapdex_f（デフォルト）です。これにより、閾値は「不満」Apdexレベル（apdex_t値の4倍）に設定されます。フロート値を秒数で入力して、特定の時間閾値を設定することもできます。

デフォルトでは、高セキュリティモードでは、エージェントはスロークエリを収集できません。高セキュリティが有効になっていても、DataStaxドライバからCassandraクエリを収集するには、このオプションを有効にします。高セキュリティを使用しない場合、エージェントはスロークエリを自動的に収集します。

DataStaxドライバ2.1.2の場合、このルールを許可リストに追加します。

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

DataStaxドライバ3.0.0の場合、このルールを許可リストに追加します。

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

デフォルトでは、高セキュリティモードでは、エージェントはスロークエリを収集できません。高セキュリティが有効になっていても、DataStaxドライバからCassandraクエリを収集するには、このオプションを有効にします。高セキュリティを使用しない場合、エージェントはスロークエリを自動的に収集します。

DataStaxドライバ2.1.2の場合、このルールを許可リストに追加します。

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

DataStaxドライバ3.0.0の場合、このルールを許可リストに追加します。

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

この設定を使用して、トランザクショントレースのすべての属性をオンまたはオフにできます。ルートレベルでattributes.enabledがfalseである場合は、このプロパティ (transaction_tracer.attributes.enabled) が設定されているかにかかわらず、属性がトランザクショントレースに送信されることはありません。

属性がトランザクショントレースについて有効になっている場合、このリストにあるすべての属性キーが、トランザクショントレースでNew Relicに送信されます。詳しくはエージェント属性ルールを参照してください。

このリストにある属性キーのいずれも、トランザクショントレースでNew Relicに送信されることはありません。詳しくはエージェント属性ルールを参照してください。

トランザクションごとに作成可能なトークンの数を制限します。この値を増やすと、エージェントが使用するメモリの量とNew Relicに送信されるデータの量が増えるため、パフォーマンスに影響が生じる場合があります。

トランザクションごとに作成可能なセグメントの数を制限します。この値を増やすと、エージェントが使用するメモリの量とNew Relicに送信されるデータの量が増えるため、パフォーマンスに影響が生じる場合があります。