.NETエージェントの設定

.NET Frameworkの場合、次の変数が必要です。

COR_ENABLE_PROFILING=1
COR_PROFILER={71DA0A04-7777-4EC6-9643-7D28B46A8A41}
NEWRELIC_INSTALL_PATH="INSERT_THE_PATH_TO_THE_AGENT_DIRECTORY"

Windows .NET エージェント インストーラ (.msi) は、これらをデフォルトで IIS に追加するか、または Instrument Allを有効にしたときにシステム全体の環境変数として追加します。

Windows .NETエージェントインストーラーを使用する場合は、 NEWRELIC_INSTALL_PATHがC:\Program Files\New Relic\.NET Agent\に設定されていることを確認してください。これは、エージェントDLLがシステムに配置される場所です。

これらの変数の詳細、およびその他のインストール シナリオの正しい値については、 「.NET エージェントの環境変数について」を参照してください。

Nugetパッケージを介してエージェントをインストールする場合、エージェントに は異なる環境変数のセットが必要です。

.NET Coreの場合、次の変数が必要です。

Linux:

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_NEWRELIC_HOME=path/to/agent/directory
CORECLR_PROFILER_PATH="${CORECLR_NEWRELIC_HOME}/libNewRelicProfiler.so"

Windows (MSI Installer):

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
NEWRELIC_INSTALL_PATH=C:\Program Files\New Relic\.NET Agent\
CORECLR_NEWRELIC_HOME=C:\ProgramData\New Relic\.NET Agent\

Windows .NET エージェント インストーラーは、これらをデフォルトで IIS に追加するか、 Instrument Allを有効にするとシステム全体の環境変数として追加します。 例外: IIS 以外でホストされる ..NET Core アプリケーションを計測するには、 CORECLR_ENABLE_PROFILINGを手動で設定する必要があります。 .NET フレームワーク アプリケーションについては、「.NET フレームワークの互換性と要件」を参照してください。

これらの変数の詳細、およびその他のインストール シナリオの正しい値については、 「.NET エージェントの環境変数について」を参照してください。

WindowsでNugetパッケージを介してエージェントをインストールする場合、エージェントには異なる環境変数のセットが必要です。

New Relicの.NETエージェントは、環境変数に依存して、.NET共通言語ランタイム（CLR）にNewRelicをプロセスにロードするように指示します。インストール関連の環境変数はMicrosoft変数であり、NewRelic変数ではありません。これらは他の.NETプロファイラーで使用でき、一度に1つのプロファイラーのみをプロセスにアタッチできます。このため、以前のアプリケーション監視製品を使用したことがある場合は、プロファイラーの競合が発生する可能性があります。

New Relic の .NET エージェント用の 64 ビット MSI インストーラーは、64 ビット アセンブリとともに 32 ビット プロファイラー アセンブリを自動的にインストールし、v10.16.0 以降、IIS の 32 ビット サポートが自動的に有効になります。IIS 以外でホストされるアプリケーションの場合は、必要な環境変数を手動で設定できます。

COR_PROFILER_PATH_32="C:\Program Files (x86)\New Relic\.NET Agent\NewRelic.Profiler.dll"

New Relic エージェントを有効または無効にします。

任意のスタックダンプでトレースするスタックフレームの最大数です。

あなたの New Relic ライセンスキー 。New Relic はライセンスキーを使用して、アプリのデータを UI で正しいアカウントに照合します。環境変数でライセンスキーを設定します。

あるいは、アプリケーションの環境でNEW_RELIC_LICENSE_KEY環境変数を設定します。

NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY

実行環境情報を記録するようにエージェントに指示します。環境情報には、オペレーティングシステム、エージェントのバージョン、どのアセンブリが利用可能かなどが含まれます。

エージェントがNewRelicに接続するまで、アプリケーションの起動をブロックします。 trueに設定すると、New Relicへの接続が完了するまでブロックされるため、最初のトランザクションの完了にかなり時間がかかる場合があります。

エージェントが最後の収穫サイクルを開始し、すべてのデータをNew Relicに送信する間、アプリケーションのシャットダウンをブロックします。

あるいは、アプリケーションの環境でNEW_RELIC_SEND_DATA_ON_EXIT環境変数を設定します。

NEW_RELIC_SEND_DATA_ON_EXIT=true

エージェントがプロセスのシャットダウンをブロックする前にプロセスを実行する必要がある最小時間。この設定は、 sendDataOnExitがtrueの場合にのみ適用されます。

あるいは、アプリケーションの環境でNEW_RELIC_SEND_DATA_ON_EXIT_THRESHOLD_MS環境変数を設定します。

NEW_RELIC_SEND_DATA_ON_EXIT_THRESHOLD_MS=2000

falseの場合、エージェントはプール スレッドを使用してトランザクション処理を完了します。

trueの場合、エージェントはリクエストスレッドでトランザクション処理を完了します。

falseの場合、エージェントは、非同期/スレッドのシナリオでカスタム インストゥルメントされたメソッドに遭遇したときに、既存の トランザクション を再利用しようとします。

trueの場合、エージェントは、非同期/スレッドのシナリオでカスタム インストゥルメントされたメソッドに遭遇したときに、新しい トランザクション を作成しようとします。

または、 NEW_RELIC_FORCE_NEW_TRANSACTION_ON_NEW_THREAD環境変数を使用してこの動作を制御することもできます。

NEW_RELIC_FORCE_NEW_TRANSACTION_ON_NEW_THREAD=true

New Relic と通信する際のエージェントのリクエストタイムアウト。

インスツルメンテーションされた最初のメソッドがヒットしたときに、自動的に.NETエージェントを起動します。

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

<service licenseKey="YOUR_LICENSE_KEY"
  host="gov-collector.newrelic.com" />

環境変数NEW_RELIC_HOSTも使用できます。

NEW_RELIC_HOST=gov-collector.newrelic.com

プロキシホストを定義します。

または、アプリケーションの環境でNEW_RELIC_PROXY_HOST環境変数を設定します。

プロキシポートを定義します。

または、アプリケーションの環境でNEW_RELIC_PROXY_PORT環境変数を設定します。

必要に応じて、プロキシURIのパスを定義します。

または、アプリケーションの環境でNEW_RELIC_PROXY_URI_PATH環境変数を設定します。

必要に応じて、プロキシサーバーでの認証に使用するドメインを定義します。

または、アプリケーションの環境でNEW_RELIC_PROXY_DOMAIN環境変数を設定します。

必要に応じて、認証用のユーザー名を定義します。

または、アプリケーションの環境でNEW_RELIC_PROXY_USER環境変数を設定します。

必要に応じて、認証用のパスワードを定義します。

または、アプリケーションの環境でNEW_RELIC_PROXY_PASS環境変数を設定します。

セキュリティを強化するために、.NET エージェントはpasswordObfuscated属性を使用した難読化されたプロキシ パスワードの使用をサポートしています。 難読化されたプロキシ パスワードは、次のNew Relic CLIコマンドを使用して生成されます。

$
newrelic agent config obfuscate --key OBSCURING_KEY --value "PLAIN_TEXT_PROXY_PASSWORD"

または、アプリケーションの環境でNEW_RELIC_PROXY_PASS_OBFUSCATED環境変数を設定します。

falseに設定すると、すべてのログ記録が無効になります。 または、アプリケーションの環境でNEW_RELIC_LOG_ENABLED環境変数を設定します。

ログファイルに記録される詳細レベルを定義します。設定可能な値は、詳細度の高い順に以下のとおりです。

• off

• error

• warn

• info

• debug

• finest

• all

  または、アプリケーションの環境でNEWRELIC_LOG_LEVEL環境変数を設定します。

  重要

  ログレベルを上げると、New Relic のパフォーマンスへの影響が大きくなります。

New Relic との間で送受信されたすべてのデータを、auditlog ログファイルと標準ログファイルの両方に記録します。 enabledがfalseに設定されている場合、またはconsoleがtrueに設定されている場合、無視されます。

ログファイルではなくコンソールにログメッセージを送信します (10.35.0 より前のバージョンでは、ログはコンソールとログファイルの両方に送信されます)。 enabledがfalseに設定されている場合、無視されます。 または、アプリケーションの環境でNEW_RELIC_LOG_CONSOLE環境変数を設定します。

パフォーマンス上の理由により、プロファイラーのコンソール ログはinfoレベル以上に制限されています。

エージェントによって生成されたログファイルを保持するディレクトリ。 これを省略した場合、New Relic エージェントのインストール領域にあるLogsという名前のディレクトリがデフォルトで使用されます。

または、アプリケーションの環境でNEWRELIC_LOG_DIRECTORY環境変数を設定します。 プロファイラー ログをカスタム ディレクトリに送信することもできますが、これはアプリケーションの環境のNEWRELIC_PROFILER_LOG_DIRECTORY環境変数を使用してのみ実行できます。

NEWRELIC_LOG_DIRECTORY=path\to\a\directory
NEWRELIC_PROFILER_LOG_DIRECTORY=path\to\a\directory # not configurable via config file

ログファイルの名前を定義します。 fileNameを定義しない場合、名前は監視対象プロセスの名前に由来します。

あるいは、アプリケーションの環境でNEW_RELIC_LOG環境変数を設定します。

NEW_RELIC_LOG=MyApp.log

エージェントのログファイルのローリング戦略を定義します。 可能な値は次のとおりです。

• size (デフォルト): ログファイルは、 maxLogFileSizeMBで指定されたサイズに達するとロールオーバーします。

• day: ログファイルは午前 0 時にロールオーバーします。

  あるいは、アプリケーションの環境でNEW_RELIC_LOG_ROLLING_STRATEGY環境変数を設定します。

  NEW_RELIC_LOG_ROLLING_STRATEGY=day

  コピー

  .NET エージェント v10.21.0 以降でサポートされます。

エージェントのインスタンスごとに保持するエージェント ログファイルの数を定義します。同じホストで実行されている複数のアプリはそれぞれこの数のファイルを作成します。 ログファイルの最大数に達すると、最も古いログファイルが削除されます。 値0は、ログファイルの最大数がないことを指定します。

あるいは、アプリケーションの環境でNEW_RELIC_LOG_MAX_FILES環境変数を設定します。

NEW_RELIC_LOG_MAX_FILES=2

.NET エージェント v10.21.0 以降でサポートされます。

ロールオーバーする前のエージェント ログ ファイルの最大サイズをメガバイト単位で定義します。 logRollingStrategy sizeに設定されている場合にのみ有効です。 値0は、ログファイルの最大サイズがないことを指定します。

あるいは、アプリケーションの環境でNEW_RELIC_LOG_MAX_FILE_SIZE_MB環境変数を設定します。

NEW_RELIC_LOG_MAX_FILE_SIZE_MB=100

.NET エージェント v10.21.0 以降でサポートされます。

.NETアプリケーションの名前は、 application要素の子です。 New Relicは、この名前に従ってデータを集約します。たとえば、 AppAとAppBという名前の2つの実行中のアプリケーションがある場合、NewRelicインターフェースにAppAとAppBの2つのアプリケーションが表示されます。

アプリに 最大 3 つの名前を割り当てる こともできます。名がプライマリ名です。例えば：

<application>
  <name>MY APPLICATION PRIMARY</name>
  <name>SECOND APP NAME</name>
  <name>THIRD APP NAME</name>
</application>

あるいは、アプリケーションの環境でNEW_RELIC_APP_NAME環境変数を設定します。

NEW_RELIC_APP_NAME=Descriptive Name

複数の名前の場合:

NEW_RELIC_APP_NAME="App Name, App Name 2, App Name 3"

サンプラーは、メモリとCPU消費に関する情報を収集します。サンプリングを無効にするには、これをtrueに設定します。

あるいは、アプリケーションの環境でNEW_RELIC_DISABLE_SAMPLERS環境変数を設定します。

NEW_RELIC_DISABLE_SAMPLERS=true

NewRelicにデータを送信するときに使用されるHTTPメソッドを定義します。これをtrueに設定すると、データの送信時にPUTメソッドを使用できるようになります。デフォルトではPOSTメソッドが使用されます。

newrelic.configのprocessHost要素にdisplayName属性を設定します。 processHost要素はconfiguration要素の子です。

<configuration . . . >
  <processHost displayName="CUSTOM_NAME" />
</configuration>

NEW_RELIC_PROCESS_HOST_DISPLAY_NAME環境変数を設定します。

NEW_RELIC_PROCESS_HOST_DISPLAY_NAME="CUSTOM_NAME"

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

または、この動作はNEW_RELIC_UTILIZATION_DETECT_AWS環境変数を介して制御できます。

NEW_RELIC_UTILIZATION_DETECT_AWS=false

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

または、この動作はNEW_RELIC_UTILIZATION_DETECT_AZURE環境変数を介して制御できます。

NEW_RELIC_UTILIZATION_DETECT_AZURE=false

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

または、この動作はNEW_RELIC_UTILIZATION_DETECT_GCP環境変数を介して制御できます。

NEW_RELIC_UTILIZATION_DETECT_GCP=false

エージェントが環境変数からPCF情報をポーリングするかどうかを決定します。

または、この動作はNEW_RELIC_UTILIZATION_DETECT_PCF環境変数を介して制御できます。

NEW_RELIC_UTILIZATION_DETECT_PCF=false

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

または、この動作はNEW_RELIC_UTILIZATION_DETECT_DOCKER環境変数を介して制御できます。

NEW_RELIC_UTILIZATION_DETECT_DOCKER=false

エージェントが環境変数からKubernetesの情報をポーリングするかどうかを決定します。

または、この動作はNEW_RELIC_UTILIZATION_DETECT_KUBERNETES環境変数を介して制御できます。

NEW_RELIC_UTILIZATION_DETECT_KUBERNETES=false

属性収集を有効または無効にします。プライマリ属性要素でfalseに設定すると、この設定は個々の宛先のすべての属性設定を上書きします。

または、アプリケーションの環境でNEW_RELIC_ATTRIBUTES_ENABLED環境変数を設定します。

属性が有効になっている場合、エージェントはこのリストで指定されているすべての属性キーを収集します。複数の属性キーを指定するには、それぞれを個別に指定します。キーの最後に*ワイルドカード文字を使用して、複数の属性（たとえば、 myApiKey.* ）に一致させることもできます。詳細については、属性ルールを参照してください。

または、アプリケーションの環境でNEW_RELIC_ATTRIBUTES_INCLUDE環境変数を設定します。この環境変数は、属性名のコンマ区切りリストを受け入れます。

属性が有効になっている場合、エージェントはこのリストで指定された属性キーを収集しません。複数の属性キーを指定するには、それぞれを個別に指定します。キーの最後に*ワイルドカード文字を使用して、複数の属性（たとえば、 myApiKey.* ）に一致させることもできます。詳細については、属性ルールを参照してください。

または、アプリケーションの環境でNEW_RELIC_ATTRIBUTES_EXCLUDE環境変数を設定します。この環境変数は、属性名のコンマ区切りリストを受け入れます。

IISを介して提供されるアプリケーションプールの「グローバル」レベルで.NETエージェントがどのように動作するかを定義します。 .NETエージェントは、デフォルトですべてのアプリケーションプールを計測します。 trueの場合、 instrument属性がfalseに設定されたapplicationPoolの下にリストされているアプリケーションプールはインストルメントされません。

基本的に、 falseに設定すると、アプリケーションプールリストは許可リストとして機能します。 trueに設定すると、アプリケーションプールリストは拒否リストとして機能します。

特定のアプリケーションプールのインストルメンテーション動作を定義します。 name属性は、アプリケーションプールの名前です。 instrument属性でプロファイリングを有効または無効にします。このアプリケーションをname属性で定義します。

エラーコレクターを有効または無効にします。

エラーイベントの取り込みを有効または無効にします。

エラー発生時のリザーバーリミット

無視される完全修飾クラス名のリスト。 報告SHOULDれるエラー クラスとメッセージの組み合わせの最大数は 50 です。 50 個以上リストされている場合は、最初の 50 個SHOULDのみが使用されます。

完全修飾クラス名とエラー メッセージの部分文字列に一致する文字列のリストのオプション マップ。 報告SHOULDれるエラー クラスとメッセージの組み合わせの最大数は 50 です。 50 個以上リストされている場合は、最初の 50 個SHOULDのみが使用されます。

NewRelicに報告しない特定の例外を一覧表示します。 System.IO.FileNotFoundExceptionなどの例外のフルネームを使用する必要があります。

New Relic に報告しない特定の HTTP エラー コードを一覧表示します。 標準の整数 HTTP エラー コード (例: 401を使用することも、小数点付きの完全な Microsoft ステータス コード (例: 401.4 、 403.18を使用することもできます。 ステータス コードは400以上である必要があります。

これは環境変数を介して設定することもでき、複数のコードをコンマ区切りのリストで指定します。

NEW_RELIC_ERROR_COLLECTOR_IGNORE_ERROR_CODES=401, 403.18

期待どおりにマークされる完全修飾クラス名のリスト。 SHOULDが報告されるエラー クラスとメッセージの組み合わせの最大数は 50 です。 50 個を超えるものがリストされている場合は、最初の 50 個のSHOULDのみが使用されます

エラーメッセージの部分文字列に一致する文字列のリストへの完全修飾クラス名のオプションのマップ。 SHOULDが報告されるエラー クラスとメッセージの組み合わせの最大数は 50 です。 50 個を超えるものがリストされている場合は、最初の 50 個のSHOULDのみが使用されます

カンマで区切られたステータス コードのリスト。 リストには、単一のダッシュ ( - ) を使用して整数の範囲を含めることができ、範囲内の開始整数と終了整数の両方が含まれます。

これは、環境変数を介して構成することもできます。

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_ERROR_CODES=401, 501-503

このサブ要素を使用して、エラートレースのエージェント属性設定をカスタマイズします。このサブ要素は、プライマリattributes要素と同じ設定enabled 、 include 、およびexcludeを使用します。

高セキュリティ モードを有効または無効にします。例：

<highSecurity enabled="true"/>

あるいは、アプリケーションの環境でNEW_RELIC_HIGH_SECURITY環境変数を設定します。

NEW_RELIC_HIGH_SECURITY=true

ストリップの例外メッセージを有効または無効にします。例

<stripExceptionMessages enabled="true"/>

イベントレコーダーの有効化、無効化を行います。

エージェントが一度にメモリに保存できる、サンプリングされたトランザクション イベントの最大数。これは、エージェントが 1 分間に送信できるトランザクション イベントの最大数になります。

あるいは、アプリケーションの環境でMAX_TRANSACTION_SAMPLES_STORED環境変数を設定します。

MAX_TRANSACTION_SAMPLES_STORED=500

このサブ要素を使用して、トランザクションイベントのエージェント属性設定をカスタマイズします。このサブ要素は、プライマリattributes要素と同じ設定enabled 、 include 、およびexcludeを使用します。

イベントレコーダーの有効化、無効化を行います。

エージェントが一度にメモリに保存できる、サンプリングされたカスタム イベントの最大数。これは、エージェントが 1 分間に送信できるカスタム イベントの最大数になります。

あるいは、アプリケーションの環境でMAX_EVENT_SAMPLES_STORED環境変数を設定します。

MAX_EVENT_SAMPLES_STORED=500

• AI モニタリング用にエージェントを構成する場合は、値を100000に設定することをお勧めします。

カスタムパラメーターの取り込みを有効または無効にします。

デフォルトでは、エージェントはブラウザエージェントのJavaScriptを自動的に挿入します。自動インジェクションをオフにするには、この属性をfalseに設定します。

このサブ要素を使用して、ブラウザ監視用のエージェント属性設定をカスタマイズします。このサブ要素は、プライマリattributes要素と同じ設定enabled 、 include 、およびexcludeを使用します。

特定のページにブラウザエージェントが注入されないようにするには、このサブエレメントを使用します。この要素の使い方は以下の通りです。

<requestPathsExcluded>
  <path regex="url-regex-1"/>
  <path regex="url-regex-2"/>
  ...
  <path regex="url-regex-n"/>
</requestPathsExcluded>

このエージェントは、URL が指定された正規表現のいずれかに一致するページにブラウザエージェントを注入しません。正規表現は、 Microsoft Guidelines for the Regex class に従ってください。

これは、アプリケーション内のパスの仮想ディレクトリへの参照であり、除外するパスの完全なURLではありません。たとえば、 https://www.mywebsite.com/mywebpages/のページを除外するには、パスの正規表現値として/mywebpages/を挿入するだけです。

requestPathsExcluded要素は、 DisableBrowserMonitoring()呼び出しを使用することが不可能または望ましくない場合に使用する必要があります。パフォーマンスへの影響を最小限に抑えるには、使用する正規表現をできるだけ少なくし、できるだけ単純に保つようにしてください。

スロークエリートレースを有効または無効にします。

トランザクション トレースの有効化または無効化.

トランザクションをトレースするための閾値を定義します。トランザクションにかかる時間がしきい値より長ければ、トレースの対象となります。トレースに関するルールについては、 transaction trace basics を参照してください。

デフォルト値はapdex_fで、これは、閾値をアプリケーションのapdex_t値の 4 倍に設定します。 apdex_tの詳細については、 「Apdex」を参照してください。

また、しきい値をミリ秒単位の特定の時間値に設定することもできます。

クエリトレースポリシーを選択します。オプションはoffで、何も記録されません。 obfuscated 、難読化されたバージョンのクエリを記録します。またはraw 、データベースに発行されたとおりにクエリを記録します。

trueの場合、エージェントは、期間がexplainThresholdを超える低速クエリのEXPLAINステートメントをキャプチャします。この機能を有効にすると、 maxExplainPlans値までのすべてのトランザクションに対してプランがキャプチャされるため、パフォーマンスに影響を与える可能性があることに注意してください。

エージェントは、トランザクション追跡の一部として、利用可能な説明プランとともに、このしきい値を超えるクエリの 低速クエリ データを 収集します。

トランザクション・トレースで収集するセグメントの最大数です。

トランザクションごとに収集するExplainプランの最大数。

デフォルトでは、 maxStackTraceは0に設定されており、 LTrace の一部としての Stacktrace は無効になります。 この値が0より大きい値に設定されている場合、 LTtrace に対して スタックトレース がキャプチャされます。

When set to true, the agent adds a SQL comment that holds the service entity GUID to the start of each instrumented SQL statement before the database runs the statement. The comment has the following format:

/*nr_service_guid="YOUR_ENTITY_GUID"*/

Use this option to correlate APM data with query performance monitoring. The agent changes the statement text that it sends to the database, so the database receives the full comment.

The agent also records the commented text. The comment appears in slow query traces, in transaction trace segments, and in the db.statement attribute of span events. With the default recordSql value of obfuscated, the agent replaces the quoted entity GUID with ?, so these records show /*nr_service_guid=?*/. Set recordSql to raw to keep the entity GUID in this agent data.

This option is available starting in .NET agent version 10.52.0. You can also set it with the NEW_RELIC_TRANSACTION_TRACER_SQL_METADATA_COMMENTS_ENABLED environment variable.

このサブ要素を使用して、トランザクショントレースのエージェント属性設定をカスタマイズします。このサブ要素は、プライマリattributes要素と同じ設定enabled 、 include 、およびexcludeを使用します。

このサブ要素を使用して、一部のデータベースドライバーのデータストアインスタンスメトリック（ホストやポートなど）の収集を有効にします。これらは、低速のクエリトレースとトランザクショントレースで報告されます。属性enabledのデフォルト値はtrueです。

このサブ要素を使用して、一部のデータベースドライバーの低速クエリトレースおよびトランザクショントレースでデータベース名を収集できるようにします。属性enabledのデフォルト値はtrueです。

このサブ要素を使用して、低速のクエリトレースでSQLクエリパラメータの収集を有効にします。属性enabledのデフォルト値はfalseです。

あるいは、アプリケーションの環境でNEW_RELIC_DISTRIBUTED_TRACING_ENABLED環境変数を介してディストリビューティッド（分散）トレーシングを有効にします。

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true

デフォルトでは、サポートされているバージョンのエージェントは、分散トレースにnewrelicヘッダーとW3Cトレースコンテキストヘッダーの両方を利用します。 newrelic分散トレースヘッダーにより、W3Cトレースコンテキストヘッダーをサポートしない古いエージェントとの相互運用が可能になります。 W3Cトレースコンテキストヘッダーをサポートするエージェントバージョンは、分散トレースのnewrelicヘッダーよりも優先されます。

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

newrelic.configファイル経由で無効にするには、 <spanEvents>要素をfalseに設定します。 この要素は<configuration>要素の子です。

<configuration . . . >
  <spanEvents enabled="false" />
</configuration>

アプリケーションの環境でNEW_RELIC_SPAN_EVENTS_ENABLED環境変数を設定します。

NEW_RELIC_SPAN_EVENTS_ENABLED=false

trace_observer要素は、エージェントから独立しているオブザーバーホストを識別します。有効なInfiniteTracingトレースオブザーバーホストエントリの取得については、トレースオブザーバーエンドポイントの検索または作成を参照してください。

トレースオブザーバーは、 NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST環境変数を使用して構成することもできます。

クロスアプリケーショントレースの有効化・無効化

イベントレコーダーの有効化、無効化を行います。

エージェントが一度にメモリに保存できる、サンプリングされたスパン イベントの最大数。これは、エージェントが 1 分間に送信できるスパン イベントの最大数になります。

• これは、 NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED環境変数を使用して構成することもできます。

• 10kを超える設定は推奨されません。サーバーによって1分あたりのデータの上限は10kに制限されることになります。

• AI モニタリング用にエージェントを構成する場合は、値を10000に設定することをお勧めします。

  重要

  この設定オプションは、.NET Agent v9.0以降でのみ利用可能です。

このサブ要素を使用して、スパンイベントのエージェント属性設定をカスタマイズします。このサブ要素は、プライマリattributes要素と同じ設定enabled 、 include 、およびexcludeを使用します。

HTTPリクエストヘッダのキャプチャを有効または無効にします。例を示します。

あるいは、アプリケーションの環境でNEW_RELIC_ALLOW_ALL_HEADERS環境変数を設定します。

<allowAllHeaders enabled="true" />
<attributes enabled="true">
   <include>request.headers.*</include>
</attributes>

すべてのロギングインストルメンテーション機能を有効または無効にします。 trueの場合、個々のサブ機能の構成が有効になります。 falseの場合、ロギングインストルメンテーション機能は有効になりません。

または、 NEW_RELIC_APPLICATION_LOGGING_ENABLED環境変数を使用します。

このサブ要素を使用して、一般的な.NETロギングフレームワークのロギングメトリック（ Logging/linesなど）の収集を有効にします。属性enabledのデフォルト値はtrueです。

または、 NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED環境変数を使用します。

このサブ要素を使用して、アプリケーションのログを New Relic に転送できるようにします。 属性enabledのデフォルト値はtrueですが、 NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED環境変数を使用することもできます。

属性maxSamplesStoredのデフォルト値は10000ですが、この設定にはNEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED環境変数を使用することもできます。 送信されるログ行の量を減らすには、これをより低い値に設定します (ログ サンプリングが発生する可能性があります)。 より多くのログ行を送信するには、これをより高い値に設定します。

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

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

指定されたログレベルのログメッセージを除外するには、 logLevelDenyListプロパティ (またはNEW_RELIC_APPLICATION_LOGGING_FORWARDING_LOG_LEVEL_DENYLIST環境変数) を使用します。 この属性の値は、大文字と小文字を区別しない、コンマで区切られたレベルのリストです。 それ以外の場合、 ログレベル 文字列はフィルタリングされる ログレベル と完全に一致する必要があります。ワイルドカードと正規表現はサポートされていません。 たとえば、値が logLevelDenyList="debug,warn" に設定されている場合、ログレベルが Debug または Warn のログメッセージはキャプチャも転送もされませんが、レベルが Warning のログはNew Relicに送信されます。

forwarding要素の子であるこのサブ要素を使用して、エージェント バージョン 10.4.0 以降でロギング コンテキスト データ (カスタム属性) のキャプチャと転送を構成します。

ログ コンテキスト データのキャプチャと New Relic への転送を有効にするには、 enabled属性をtrueに設定します。環境変数NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_ENABLEDを使用することもできます。 デフォルト値はfalseです。

includeプロパティは、コンテキスト データ キャプチャが有効な場合に含めるプロパティの名前のコンマ区切りリストです。環境変数NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_INCLUDEを使用することもできます。 デフォルト値は空の文字列で、「すべてを含める」ことを意味します。

exclude属性は、コンテキスト データ キャプチャが有効な場合に除外する属性の名前のコンマ区切りリストです。環境変数NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_EXCLUDEを使用することもできます。 デフォルト値は空の文字列で、「何も除外しない」ことを意味します。

包含リストと除外リストは 、他のエージェント属性設定と同じ優先規則に従います。

エージェント バージョン 10.34.0 以降では、 forwarding要素の子であるこのサブ要素を使用して、エージェント転送ログにラベル (タグ)を追加するように構成します。

エージェント転送ログにラベルを追加できるようにするには、 enabled属性をtrueに設定します。 環境変数NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLEDを使用することもできます。 デフォルト値はfalseです。

exclude属性は、ラベルを有効にするときに除外するラベル名の、大文字と小文字を区別しない、カンマ区切りのリストです。 環境変数NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDEを使用することもできます。 デフォルト値は空の文字列で、「何も除外しない」ことを意味します。 この属性はワイルドカードまたは正規表現をサポートしていません。

このサブ要素を使用して、NewRelicリンクメタデータでアプリケーションのログを装飾できるようにします。属性enabledのデフォルト値はfalseです。ローカルログの装飾には、いくつかの追加の構成変更が必要です。詳細については、 .NET：コンテキストでのログの構成を参照してください。

このサブ要素を使用して、アプリケーションの AWS アカウント ID を設定します。

<cloud>
  <aws accountId="123456789012" />
</cloud>

これは、環境変数を介して構成することもできます。

NEW_RELIC_CLOUD_AWS_ACCOUNT_ID=123456789012

このサブ要素を使用して、LLM イベントのすべての入力と出力を New Relic に送信できるようにします。 属性enabledのデフォルト値はtrueです。 高セキュリティモードではコンテンツの記録は無効になります。

コンテンツの記録が無効になっている場合は、顧客がSetLlmTokenCountingCallback APIを呼び出して LLM トークンのカウントを提供する必要があることに注意してください。 このコールバックが提供されない場合、エージェントは LLM トークンのカウントを提供できません。

<aiMonitoring enabled="true">
  <recordContent enabled="false" />
</aiMonitoring>

これは、環境変数を介して構成することもできます。

NEW_RELIC_AI_MONITORING_RECORD_CONTENT_ENABLED=false

Enable or disable collection of the internal Kafka metrics that the agent builds from the statistics Kafka reports to it.

This attribute takes precedence over the NewRelic.KafkaInternalMetricsEnabled app setting. If you do not set debugEnabled, the agent still honors that app setting.

または、 NEW_RELIC_KAFKA_METRICS_DEBUG_ENABLED環境変数を使用します。

This attribute sets the interval, in seconds, at which Kafka reports statistics to the agent.

The minimum value is 5 seconds. The agent raises a smaller value to 5.

If you do not set this attribute, the agent derives the interval from the metrics harvest cycle. If you configure a statistics interval on the Kafka client itself, that value takes precedence over this attribute.

または、 NEW_RELIC_KAFKA_METRICS_INTERVAL環境変数を使用します。