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

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

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

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

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

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

この設定は必須です。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に接続するのに十分な証明書が含まれていない場合は、必要な証明書をカスタム証明書バンドルにマージする必要があります。

次のSSL証明書がエージェントjarにバンドルされています。

META-INF/certs/eu-newrelic-com.pem
  META-INF/certs/eu01-nr-data-net.pem
  META-INF/certs/newrelic-com.pem

デフォルト (use_private_ssl: false) では、エージェントはJDKにバンドルされているSSL証明書を使用して、New Relicまたはca_bundle_pathで指定されたカスタムSSL証明書バンドルへのセキュアな接続を確立します。エージェントにバンドルされているSSL証明書を使用する場合は、use_private_ssl: trueを設定します。

注: ca_bundle_pathが設定されている場合、use_private_sslは無視されます。

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

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

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

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

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

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

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

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

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

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

このオプションでタグが有効になり、ラベル機能が置き換えられたことに注意してください。ここで、過去のラベルを引き続きクエリできます。

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

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

この設定は必須です。New Relicへのデータのレポートに使用するアプリケーション名を含みます。New Relicで表示するアプリケーションの名前を設定します。

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

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

app_name: My Application;My Application 2

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

ディストリビューティッド（分散）トレーシングを有効にします。大文字と小文字を区別する：trueまたはfalseを使用します。詳細については、ディストリビューティッド（分散）トレーシングのセクションをご覧ください。

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

この設定は必須です。New Relicアカウントのライセンスが含まれます。

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

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

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

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

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

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

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

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

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

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

key1, key2, key3

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

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

key1, key2, key3

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

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をポーリングするかどうかを決定します。

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

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

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

60秒ごとにレポートされた、サンプリングされたカスタムイベントの最大数。

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

userPrincipal名を取得するには、このオプションを有効にします。この名前はトランザクショントレース属性として含まれ、クエリを行うことができます。

ディストリビューティッド（分散）トレーシングを無効にするには、これをfalseに設定します。

たとえば、設定ファイルでこれを有効にするには、次のものを使用します：

distributed_tracing:
  enabled: true

システムプロパティを使用してこれを上書きするには、次のものを使用します:

-Dnewrelic.config.distributed_tracing.enabled=true

デフォルトで、エージェントのサポートされたバージョンは、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にレポートされません。システムプロパティにより指定できません。

この設定は動的なので、エージェントを実行すると、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つ必要）

  例外クラス名がエラーと一致するが、メッセージは一致しない場合、そのエラーは無視されません。メッセージ文字列は、一致のcontainsを使用します。メッセージは自身には提供できず、必ず完全修飾クラス名とペアになっている必要があります。システムプロパティにより指定できません。

  この設定は動的なので、エージェントを実行すると、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スコアに影響を与えないようにします。システムプロパティにより指定できません。

この設定は動的なので、エージェントを実行すると、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スコアには影響を与えません。

メッセージ文字列は、一致のcontainsを使用します。メッセージは自身には提供できず、必ず完全修飾クラス名とペアになっている必要があります。システムプロパティにより指定できません。

この設定は動的なので、エージェントを実行すると、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

Expected status codes can also be with the NEW_RELIC_ERROR_COLLECTOR_EXPECTED_STATUS_CODES environment variable.

この設定を使用して、トレースエラーのすべての属性をオンまたはオフにできます。ルートレベルで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を使用することもできます。

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

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

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

trueに設定すると、JFRを使用したリアルタイムプロファイリングが有効になります。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ログのローテーションを毎日行うには、trueに設定します。ログのローテーションに影響を与えるその他の設定変数を上書きします。

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

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

ログファイルのパス。

ログの詳細度のレベル。

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

• off

• severe

• warning

• info

• fine

• finer

• finest

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

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

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

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

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

この設定は、スパンイベントのすべての属性をオンまたはオフにするのに使用できます。ルートレベルで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. Choose one or more custom HTTP request headers to add as transaction attributes.

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

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は、トレースを作成する一意のスロートランザクションの数を表す整数です。

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

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

  値が0の場合、最も遅いトランザクションのみがトレースされることになります。これは最適ではないと考えられていますが、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に送信されるデータの量が増えるため、パフォーマンスに影響が生じる場合があります。