.NETエージェントの設定

.NETフレームワークの場合、次の変数が必要です。

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 Frameworkアプリケーションについては、.NET Frameworkの互換性および要件を参照してください。

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

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

New Relicの.NETエージェントは、環境変数に依存して、.NET共通言語ランタイム（CLR）にNew Relicをプロセスにロードするように指示します。インストール関連の環境変数は、New Relicの変数ではなく、Microsoftの変数です。これらは他の.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

エージェントに対し、実行環境情報を記録するように指示します。環境情報には、OS、エージェントのバージョン、使用可能なアセンブリが含まれます。

エージェントがNew Relicに接続するまで、アプリケーションの起動をブロックします。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との間で送受信されたすべてのデータを、監査ログファイルと標準ログファイルの両方に記録します。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つの実行中のアプリケーションがある場合、New RelicのインターフェースにはAppAとAppBという2つのアプリケーションが表示されます。

アプリには最大3つの名前を付けることができます。1つ目がメインの名前です。例を以下に示します。

<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

New Relicにデータを送信する際に使用されるHTTPメソッドを定義します。データ送信時にPUTメソッドを使用できるようにするには、これをtrueに設定してください。デフォルトでは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

エージェントがMicrosoft Azureメタデータ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の場合、applicationPoolの下にリストされ、instrument属性がfalseに設定されているアプリケーションプールは計装されません。

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

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

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

エラーイベントのキャプチャを有効または無効にします。

エラーイベント発生時のリザーバー制限。

無視すべき完全修飾クラス名のリスト。報告すべきエラークラスとメッセージの組み合わせの最大数は50です。50を超えるリストがある場合は、最初の50のみを使用します。

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

New Relicに報告しない特定の例外事項をリストアップします。例外の完全な名前を使用する必要があります。たとえば、System.IO.FileNotFoundExceptionなどです。

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

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

NEW_RELIC_ERROR_COLLECTOR_IGNORE_ERROR_CODES=401, 403.18

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

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

ステータスコードをカンマで区切ったリスト。リストには、単一のハイフン（-）を使用した整数範囲が含まれる場合があり、範囲の開始整数と終了整数の両方が含まれます。

これは環境変数によっても設定できます。

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に設定することをお勧めします。

カスタムパラメーターのキャプチャを有効または無効にします。

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

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

このサブ項目を使用して、Browserエージェントが特定のページに挿入されるのを防ぎます。この項目は次のように使用されます。

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

エージェントは、URL指定された正規表現のいずれかに一致するページにBrowserエージェントを挿入しません。正規表現はMicrosoftのRegexクラスに関するガイドラインに従う必要があります。

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

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

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

トランザクショントレースを有効または無効にします。

トランザクショントレースの閾値を定義します。トランザクションが閾値よりも長い時間がかかる場合は、トレースの対象となります。トレースを管理するルールの詳細については、トランザクショントレースの基本を参照してください。

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

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

クエリトレースポリシーを選択してください。オプションは、off（何も記録しない）、obfuscated（クエリの難読化されたバージョンを記録する）、またはraw（データベースに発行されたクエリをそのまま記録する）です。

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

エージェントは、トランザクショントレースの一環として、利用可能な実行計画とともに、この閾値を超えるスロークエリデータを収集します。

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

トランザクションごとに収集する実行計画の最大数。

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

trueに設定すると、データベースでステートメントが実行される前に、エージェントがインストゥルメントされた各SQLステートメントの先頭に、サービスエンティティGUIDを含むSQLコメントを追加します。コメントは以下のような形式です。

/*nr_service_guid="YOUR_ENTITY_GUID"*/

このオプションを使用すると、APMデータをクエリパフォーマンス監視と関連付けることができます。エージェントはステートメントテキストを変更してデータベースに送信するので、データベースはコメント全体を受信します。

エージェントはコメントが付けられたテキストも記録します。このコメントは、スロークエリトレース、トランザクショントレースセグメント、およびスパンイベントのdb.statement属性に表示されます。デフォルトのrecordSqlの値がobfuscatedの場合、エージェントは引用符で囲まれたエンティティGUIDを?に置き換えるため、これらのレコードには/*nr_service_guid=?*/が表示されます。このエージェントデータにエンティティGUIDを含めるには、recordSqlをrawに設定します。

このオプションは、.NETエージェントバージョン10.52.0以降で利用できます。環境変数NEW_RELIC_TRANSACTION_TRACER_SQL_METADATA_COMMENTS_ENABLEDを使用して設定することもできます。

このサブ項目を使用して、トランザクショントレースのエージェント属性設定をカスタマイズします。このサブ項目は、プライマリ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トレースコンテキストヘッダーのみを使用するようになります。

<spanEvents>項目をfalseに設定すると、newrelic.configファイルを介して無効になります。この項目は<configuration>項目の子項目です。

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

アプリケーションの環境変数にNEW_RELIC_SPAN_EVENTS_ENABLEDを設定してください。

NEW_RELIC_SPAN_EVENTS_ENABLED=false

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

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

クロスアプリケーショントレースを有効または無効にする

イベントレコーダーを有効または無効にします。

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

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

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

• AI監視用にエージェントを設定する場合は、値を10000に設定することをお勧めします。

  重要

  この設定オプションは、.NETエージェント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を使用することもできます。デフォルト値は空の文字列で、「何も除外しない」という意味です。この属性はワイルドカードや正規表現をサポートしていません。

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

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

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

これは環境変数によっても設定できます。

NEW_RELIC_CLOUD_AWS_ACCOUNT_ID=123456789012

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

コンテンツの記録が無効になっている場合、LLMトークンは、SetLlmTokenCountingCallback APIを呼び出すことで、顧客が提供する必要があります。このコールバックが提供されていない場合、エージェントは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を使用してください。

Enable or disable per-cluster Kafka produce and consume metrics. Set this attribute to true to make the agent record cluster metrics.

または、環境変数NEW_RELIC_KAFKA_METRICS_CLUSTER_METRICS_ENABLEDを使用してください。