.NETエージェントの設定

New Relic アカウントを作成し(永久に無料です)、.NET エージェントをインストールすると、ご使用の環境に合わせて .NET エージェントを構成できます。

設定概要

APMエージェントの設定オプションでは、エージェントの動作の一部を制御することができます。これらの設定オプションの中には、基本的なインストールプロセスの一部であるもの（ライセンスキーやアプリ名の設定など）もありますが、ほとんどは、ログレベルの設定、プロキシホストアクセスの設定、特定の属性の除外、分散型トレースの有効化など、より高度な設定です。

.NET エージェントは、インストールプロセスの一部として生成されるnewrelic.configファイルから設定を取得します。デフォルトでは、グローバルnewrelic.configファイルのみが作成されますが、複数のアプリシステムをより細かく制御するために、アプリローカルnewrelic.configファイルを作成することもできます。構成オプションを設定するその他の方法には、環境変数を使用する方法や、 UIからサーバーサイド構成を設定する方法などがあります。さまざまな設定オプションと何が何を上書きするかの詳細については、「設定の優先順位」を参照してください。

.NET Frameworkと.NET Coreの両方をサポートする場合、特に断りがない限り、同じ構成オプションを使用し、同じAPM機能を備えています。

構成ファイルに変更を加えて、それが正しい形式であることを検証したい場合は、任意のXSDバリデーターを使用してXSDファイル（たとえば、Windowsの場合はC:\ProgramData\New Relic\.NET Agent\newrelic.xsd ）と照合できます。

重要

For IIS: newrelic.configまたはapp.configファイルを変更した後、管理コマンドプロンプトからIISRESETを実行します。ログレベルの調整にはリセットは必要ありません。

設定方法と優先順位レベル

インストール時に、.NETエージェントの構成ファイル（ newrelic.config ）はすべての監視対象アプリケーションに適用されますが、他の方法でエージェントを構成できます。これは、さまざまな構成オプションが互いにどのように優先されるかを示す図です。

New Relic .NET agent configuration settings precedence

この図は、.NETエージェントを構成するさまざまな方法について、優先順位を説明しています。

ここでは、図に示された設定方法の詳細と、その優先順位について説明します。

.NET configuration	Details and precedence
`web.config` または`app.config`または `appsettings.json`	これらのファイルで設定された設定が最も優先されます。エージェントがローカルまたはグローバル `newrelic.config`で無効になっている場合: `appsettings.json` will enable the agentの`NewRelic.AgentEnabled`設定。 `web.config`または`app.config`ファイルwill be ignoredの`NewRelic.AgentEnabled`設定。
環境変数	2番目に高い優先順位です。これらの詳細については、 .NET環境変数を参照してください。
サーバー側の構成	3番目に高い優先順位です。限られた数のサーバー側の構成の設定が利用できます。その他の設定は、他の構成ソースから得られます。
アプリローカル `newrelic.config`	4番目に高い優先順位。 app-local `newrelic.config`ファイルを作成して、マルチアプリシステムで個々のアプリを構成できます。これらのローカル構成ファイルは、グローバル`newrelic.config`ファイルの設定を上書きします。エージェントは、以下のディレクトリにあるアプリローカルの設定ファイルを、この順番で探します。 `NewRelic.ConfigFile`プロパティを使用して`web.config`または`app.config`ファイルで指定されたディレクトリ Webアプリのルートディレクトリ（ `app.config`または`web.config`を含む）アプリの実行ファイルがあるディレクトリ app-local構成ファイルが完全であり、XSDファイルに対して検証する必要があることに注意してください（たとえば、Windowsの場合は`C:\ProgramData\New Relic\.NET Agent\newrelic.xsd` ）。
デフォルト（グローバル） `newrelic.config`	デフォルトのソースと最低の優先順位。他の構成ファイルがない場合に、ホスト上のすべてのアプリケーションを構成します。グローバル設定ファイルは、NewRelicエージェントのホームディレクトリにあります。 `%PROGRAMDATA%\New Relic\.NET Agent`

必要な環境変数

.NETエージェントは、環境変数に依存して、.NET共通言語ランタイム（CLR）にNewRelicをプロセスにアタッチするように指示します。一部の.NETエージェントのインストール手順（MSIインストーラーなど）では、これらの変数が自動的に設定されます。一部の手順では、手動で設定する必要があります。

注意

セキュリティ上の推奨事項です。どのユーザがシステム環境変数を設定できるかを考慮する必要があります。また、ユーザの環境変数がシステムの環境変数を上書きしないように、アプリケーションを実行するアカウントを保護する必要があります。

.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 以外の）監視サービスを使用していた場合、New Relic エージェントをインストールして使用しようとすると、"プロファイラーの競合が発生する可能性があります。詳細はこちらをご覧ください。

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

具体的なインストール方法については、 .NETエージェントのインストールドキュメントをご覧ください。

オプションの環境変数

New Relic の .NET エージェントの設定オプションの中には、設定ファイルで設定する代わりに、環境変数で設定できるものがあります。以下に、.NETエージェントで認識される環境変数のリストと値の例を示します。

NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME=Descriptive Name
MAX_TRANSACTION_SAMPLES_STORED=500
MAX_EVENT_SAMPLES_STORED=500
NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true
NEW_RELIC_SPAN_EVENTS_ENABLED=false
NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED=2000
NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST=myhost.infinitetracing.com
NEW_RELIC_LABELS="foo:bar;zip:zap"
NEW_RELIC_PROCESS_HOST_DISPLAY_NAME=Custom Name
NEW_RELIC_HOST=gov-collector.newrelic.com
NEW_RELIC_PROXY_HOST=hostname
NEW_RELIC_PROXY_URI_PATH=path/to/something.aspx
NEW_RELIC_PROXY_PORT=5000
NEW_RELIC_PROXY_USER=YOUR_USER_NAME
NEW_RELIC_PROXY_PASS=YOUR_PROXY_PASSWORD
NEW_RELIC_PROXY_DOMAIN=mydomain.com
NEW_RELIC_PROXY_PASS_OBFUSCATED=YOUR_OBFUSCATED_PROXY_PASSWORD
NEW_RELIC_CONFIG_OBSCURING_KEY=YOUR_OBSCURING_KEY
NEW_RELIC_SEND_DATA_ON_EXIT=true
NEW_RELIC_SEND_DATA_ON_EXIT_THRESHOLD_MS=2000
NEW_RELIC_HIGH_SECURITY=true
NEW_RELIC_DISABLE_SAMPLERS=true
NEW_RELIC_LOG=MyApp.log
NEW_RELIC_LOG_ENABLED=true
NEWRELIC_LOG_LEVEL=info
NEW_RELIC_LOG_CONSOLE=true
NEWRELIC_PROFILER_LOG_DIRECTORY=path\to\a\directory # not configurable via config file
NEWRELIC_LOG_DIRECTORY=path\to\a\directory # Insert a directory where you want to put the agent and profiler logs. You can't set this directory for both agent and profiler logs in the configuration file.
NEW_RELIC_LOG_ROLLING_STRATEGY=day
NEW_RELIC_LOG_MAX_FILE_SIZE_MB=100
NEW_RELIC_LOG_MAX_FILES=2
NEW_RELIC_ERROR_COLLECTOR_IGNORE_ERROR_CODES=401, 403.18
NEW_RELIC_ERROR_COLLECTOR_EXPECTED_ERROR_CODES=401, 501-503
NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_INCLUDE="myCustomAttribute1, myOtherCustomAttribute*"
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_EXCLUDE="myCustomAttribute2, myOtherCustomAttributeMoreSpecificName"
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LOG_LEVEL_DENYLIST="debug, warn"
NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=true
NEW_RELIC_ALLOW_ALL_HEADERS=true
NEW_RELIC_ATTRIBUTES_ENABLED=true
NEW_RELIC_ATTRIBUTES_INCLUDE=request.headers.*,foo.bar
NEW_RELIC_ATTRIBUTES_EXCLUDE=request.headers.cookie,request.headers.authorization
NEW_RELIC_UTILIZATION_DETECT_AWS=true
NEW_RELIC_UTILIZATION_DETECT_AZURE=true
NEW_RELIC_UTILIZATION_DETECT_GCP=true
NEW_RELIC_UTILIZATION_DETECT_PCF=true
NEW_RELIC_UTILIZATION_DETECT_DOCKER=true
NEW_RELIC_UTILIZATION_DETECT_KUBERNETES=true
NEW_RELIC_FORCE_NEW_TRANSACTION_ON_NEW_THREAD=true
NEW_RELIC_CODE_LEVEL_METRICS_ENABLED=true
NEW_RELIC_AI_MONITORING_ENABLED=true
NEW_RELIC_AI_MONITORING_RECORD_CONTENT_ENABLED=true

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 CodeStreamを使用してIDEからパフォーマンスを監視する場合は、リポジトリをサービスに関連付け、ビルドSHAまたはリリースタグをエラーに関連付ける必要があります。

受信トレイ構成のエラー

次のタグのいずれかを設定すると、エラーが発生しているソフトウェアのバージョンを特定するのに役立ちます。

NEW_RELIC_METADATA_SERVICE_VERSION デプロイされているコードのバージョン (多くの場合、1.2.3 などのセマンティックバージョン) を含むイベントデータに tags.service.version が作成されますが、常にそうとは限りません。
NEW_RELIC_METADATA_RELEASE_TAG リリースタグを含むイベントデータに tags.releaseTag を作成します (v0.1.209 など)またはリリース-209)。
NEW_RELIC_METADATA_COMMIT コミット SHA を含むイベントデータに対して tags.commit を作成します。sha 全体を使用することも、最初の 7 文字だけを使用することもできます (例: 734713b)。

エラー受信箱の今後のリリースでは、ソフトウェアのどのバージョンでエラーが発生しているかを自動的に追跡します。バージョンデータもCodeStreamに表示されます。

セットアップオプション、newrelic.config

これらのオプションを使用して、 newrelic.configファイル経由でエージェントをセットアップおよび構成します。 .NET エージェントは、次のカテゴリのセットアップオプションをサポートしています。

構成要素
サービス要素
重要な要素の隠蔽
プロキシ要素
ログエレメント
アプリケーション要素（構成）
データ伝送素子
ホスト名

構成要素

構成ドキュメントのルート要素はconfiguration要素です。

<configuration xmlns="urn:newrelic-config"
  agentEnabled="true"
  maxStackTraceLines="50">

configuration要素は次の属性をサポートします。

サービス要素

configuration要素の最初の子はservice要素です。 service要素は、NewRelicサービスへのエージェントの接続を構成します。

<service licenseKey="YOUR_LICENSE_KEY"
  sendEnvironmentInfo="true"
  syncStartup="false"
  sendDataOnExit="false"
  sendDataOnExitThreshold="60000"
  autoStart="true"/>

service要素は次の属性をサポートします。

タイプ	弦
デフォルト	（無し）

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

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

NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY

タイプ	ブール値
デフォルト	`true`

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

タイプ	ブール値
デフォルト	`false`

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

タイプ	ブール値
デフォルト	`false`

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

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

NEW_RELIC_SEND_DATA_ON_EXIT=true

タイプ	整数
デフォルト	`60000`
ユニット	ミリ秒

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

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

NEW_RELIC_SEND_DATA_ON_EXIT_THRESHOLD_MS=2000

タイプ	ブール値
デフォルト	`false`

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

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

タイプ	ブール値
デフォルト	`false`

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

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

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

NEW_RELIC_FORCE_NEW_TRANSACTION_ON_NEW_THREAD=true

タイプ

整数

デフォルト

2000 ( sendDataOnExitが有効)

120000 ( sendDataOnExitが無効)

ユニット

ミリ秒

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

タイプ	弦
デフォルト	（無し）

値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

重要な要素の隠蔽

obscuringKey要素はservice要素のオプションの子です。 .NET Agentはこの値を使用して、サポートされている構成値の難読化を解除します。たとえば、難読化されたプロキシパスワードが指定された場合、このキーを使用して難読化が解除されます。

<service licenseKey="YOUR_LICENSE_KEY">
  <obscuringKey>OBSCURING_KEY</obscuringKey>
</service>

隠蔽キーは、 NEW_RELIC_CONFIG_OBSCURING_KEY環境変数を設定することによって構成することもできます。

注意

セキュリティの推奨事項：難読化された値と同じ構成ファイルに不明瞭なキーを配置すると、セキュリティ上のリスクが生じる可能性があります。難読化されたキーと難読化されたプロキシパスワードを環境変数に配置し、環境内の環境変数へのアクセスを制限することを検討してください。

プロキシ要素

proxy 要素は、 service 要素のオプションの子です。 proxy 要素は、エージェントがプロキシ経由で New Relic バックエンドサービスと通信するときに使用されます。

<service licenseKey="YOUR_LICENSE_KEY">
  <proxy
    host="hostname"
    port="PROXY_PORT"
    uriPath="path/to/something.aspx"
    domain="mydomain.com"
    user="PROXY_USERNAME"
    password="PROXY_PASSWORD"
    passwordObfuscated="OBFUSCATED_PROXY_PASSWORD"/>
</service>

proxy要素は次の属性をサポートします。

タイプ	弦
デフォルト	（無し）

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

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

タイプ	弦
デフォルト	（無し）

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

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

タイプ	弦
デフォルト	（無し）

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

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

タイプ	弦
デフォルト	（無し）

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

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

タイプ	弦
デフォルト	（無し）

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

bash

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

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

重要

難読化されたプロキシのパスワードを使用する場合は、難読化キーも設定する必要があります。

ログエレメント

log要素はconfiguration要素の子です。 log要素はNewRelicのロギングを設定します。エージェントは独自のログファイルを生成して、そのログ情報をアプリケーションのログとは別に保持します。

<log enabled="true"
  level="info"
  auditLog="false"
  console="false"
  directory="PATH\TO\LOG\DIRECTORY"
  fileName="FILENAME.log" />

log要素は次の属性をサポートします。

タイプ	弦
デフォルト	`info`

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

off
error
warn
info
debug
finest
all
または、アプリケーションの環境でNEWRELIC_LOG_LEVEL環境変数を設定します。
重要
ログレベルを上げると、New Relic のパフォーマンスへの影響が大きくなります。

タイプ	ブール値
デフォルト	`false`

ログファイルに加えて、ログメッセージをコンソールに送信します。あるいは、アプリケーションの環境でNEW_RELIC_LOG_CONSOLE環境変数を設定します。

タイプ	ブール値
デフォルト	`true`

無効にすると、ログは記録されません。読み取り専用ファイルシステムを対象としています。あるいは、アプリケーションの環境でNEW_RELIC_LOG_ENABLED環境変数を設定します。

タイプ	弦
デフォルト	`C:\ProgramData\New Relic\.NET Agent\Logs`

エージェントによって生成されたログファイルを保持するディレクトリ。これを省略した場合、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`

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

size (デフォルト): ログファイルは、 maxLogFileSizeMBで指定されたサイズに達するとロールオーバーします。
day: ログファイルは午前 0 時にロールオーバーします。
あるいは、アプリケーションの環境でNEW_RELIC_LOG_ROLLING_STRATEGY環境変数を設定します。
```
NEW_RELIC_LOG_ROLLING_STRATEGY=day
```
.NET エージェント v10.21.0 以降でサポートされます。

タイプ	整数
デフォルト	`4`

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

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

NEW_RELIC_LOG_MAX_FILES=2

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

タイプ	整数
デフォルト	50

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

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

NEW_RELIC_LOG_MAX_FILE_SIZE_MB=100

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

応募要素（必須）

application要素はconfiguration要素の子です。この必須要素は、アプリケーション名を定義し、サンプリングを無効または有効にします。

タイプ	弦
デフォルト	`My Application`

.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"

タイプ	ブール値
デフォルト	`false`

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

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

NEW_RELIC_DISABLE_SAMPLERS=true

データ伝送素子

dataTransmission要素はconfiguration要素の子です。この要素は、データがNew Relicに送信される方法に影響し、特定のデータ送信要件がある場合に使用できます。

<dataTransmission
  putForDataSend="false"
  compressedContentEncoding="deflate"/>

dataTransmission要素は次の属性をサポートします。

タイプ	ブール値
デフォルト	`false`

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

ホスト名

APM UI のデフォルトのホスト名ラベルが役に立たない場合は、New Relic UI でその名前を表示名で修飾できます。アプリケーションプロセスが再起動され、.NET エージェントが再度レポートを行うと、表示名がServersドロップダウンリストに表示されます。このホスト名の設定は、アプリケーションのSummaryページのホストのリストには影響しません。

表示名を設定するには、次のいずれかのオプションを選択します。環境変数は、コンフィグファイルの値よりも優先されます。その後、アプリケーションを再起動すると、New Relic UI に変更内容が表示されます。

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

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

クラウドプラットフォームの利用

utilization構成要素は、エージェントが使用率情報を収集し、それをNewRelicサービスに送信して価格を決定する方法を制御します。エージェントは、Amazon Web Services（AWS）EC2インスタンス、Dockerコンテナー、Microsoft Azure、Google Cloud Platform、Pivotal Cloud Foundry、Kubernetesから情報を収集できます。

<configuration . . . >
  <utilization detectAws="true" detectAzure="true" detectGcp="true" detectPcf="true" detectDocker="true" detectKubernetes="true" />
</configuration>

utilization要素は次の属性をサポートします。

タイプ	ブール値
デフォルト	`true`

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

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

NEW_RELIC_UTILIZATION_DETECT_AWS=false

タイプ	ブール値
デフォルト	`true`

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

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

NEW_RELIC_UTILIZATION_DETECT_AZURE=false

タイプ	ブール値
デフォルト	`true`

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

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

NEW_RELIC_UTILIZATION_DETECT_GCP=false

タイプ	ブール値
デフォルト	`true`

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

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

NEW_RELIC_UTILIZATION_DETECT_PCF=false

タイプ	ブール値
デフォルト	`true`

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

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

NEW_RELIC_UTILIZATION_DETECT_DOCKER=false

タイプ	ブール値
デフォルト	`true`

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

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

NEW_RELIC_UTILIZATION_DETECT_KUBERNETES=false

インストゥルメンテーションのオプション

これらのオプションを使用して、アプリケーションや環境のどの要素をインスツルメンテーションするかを設定します。New Relic for .NET は、以下のカテゴリの計測オプションをサポートしています。

計装要素
ルール要素
アプリケーションエレメント（計測器）
属性要素

計装要素

instrumentation要素はconfiguration要素の子です。既定では、.NETエージェントはIISaspワーカープロセスとMicrosoftAzureWebおよびワーカーの役割を計測します。他のプロセスをインストルメント化するには、カスタムアプリケーションのインストルメンテーションを参照してください。

ルール要素 (インストゥルメンテーション)

重要

この機能は、.NETエージェント 10.21.0 以降で利用できます。

rules要素はinstrumentation要素の子です。 rules要素は、任意の数のignore子要素をサポートします。これにより、指定されたアセンブリで定義されたメソッドを計測しないようにプロファイラーに指示されます。他のアセンブリで定義されたメソッドは引き続きインストゥルメント化されます。

<instrumentation>
  <rules>
    <ignore assemblyName="NameOfAssemblyToIgnore" />
  </rules>
</instrumentation>

ignoreルールを使用すると、オプションでクラス名を定義できます。次の例では、アセンブリMyAssemblyのMyNamespace.MyClassで定義されたメソッドのみが無視されます。そのアセンブリ内および他のアセンブリ内の他のクラスの他のメソッドは、プロファイラーによって無視されません。

<instrumentation>
  <rules>
    <ignore assemblyName="MyAssembly" className="MyNamespace.MyClass" />
  </rules>
</instrumentation>

複数の無視ルールを指定できます。次の例では、Confluent Kafka と StackExchange Redisインストゥルメンテーションの両方を無効にします。

<instrumentation>
  <rules>
    <ignore assemblyName="Confluent.Kafka" />
    <ignore assemblyName="StackExchange.Redis" />
  </rules>
</instrumentation>

カスタムインストゥルメンテーションは、 rules要素を介して無視できないことに注意してください。

アプリケーションエレメント（計測器）

applications要素はinstrumentation要素の子です。 applications要素は、インストルメントする非Webアプリを指定するapplication子要素をサポートします。 application要素にはname属性が含まれています。

重要

これは、 configuration要素の子である application （構成）要素と同じではありません。

<instrumentation>
  <applications>
    <application name="MyService1.exe" />
    <application name="MyService2.exe" />
    <application name="MyService3.exe" />
  </applications>
</instrumentation>

属性要素

属性は、イベントまたはトランザクションのプロパティを決定するキー値のペアです。各属性は、 APMトランザクショントレース、 APMエラートレース、Transaction イベント、TransactionError イベント、または PageView イベントに送信されます。プライマリattributes要素は、.NET エージェントの属性収集を有効または無効にし、収集または除外する特定の属性を定義します。また、宛先に基づいてプロパティ設定を構成することもできます:エラー収集、タグトレース、 browserインストゥルメンテーション、トランザクションイベント。

この例では、エージェントはキーがmyApiKeyで始まるすべての属性 ( myApiKey.bar 、 myApiKey.value ) を除外しますが、カスタムアトリビュートmyApiKey.fooを収集します。

<attributes enabled="true">
  <exclude>myApiKey.*</exclude>
  <include>myApiKey.foo</include>
</attributes>

.NET APM属性は、 .NETエージェント属性ページで表示できます。エージェントAPI呼び出しAddCustomAttributeを使用してカスタム属性を定義することもできます。

タイプ	ブール値
デフォルト	`true`

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

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

タイプ	弦
デフォルト	（無し）

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

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

注意

NEW_RELIC_ATTRIBUTES_INCLUDE環境変数を使用すると、 newrelic.config内のデフォルトのインクルードセットが上書きされます。デフォルトで含まれるものと除外されるものの詳細なリストについては、ここを参照してください。

タイプ	弦
デフォルト	（無し）

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

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

注意

NEW_RELIC_ATTRIBUTES_EXCLUDE環境変数を使用すると、 newrelic.config内の除外のデフォルトセットが上書きされます。デフォルトで含まれるものと除外されるものの詳細なリストについては、ここを参照してください。

機能オプション

これらのオプションを使用して、New Relic の機能を有効、無効、および設定します。New Relic for .NET では、以下の機能を設定することができます。

アプリ・プール
エラー収集
ハイセキュリティモード
例外メッセージの除去
Transactionイベント
カスタムイベント
カスタムパラメータ
タグ/ラベル
ブラウザのインストゥルメンテーション
スロークエリ
トランザクショントレース
データストアトレーサー
ディストリビューティッド（分散）トレーシング
無限のトレース
クロスアプリケーショントレース
スパンイベント
HTTPリクエストヘッダの取得
アプリケーションログ
コードレベルの指標
AIモニタリング

アプリ・プール

重要

これは、システムのグローバルコンフィグファイルにのみ適用されます。

重要

この設定は、IIS ホスティングモデルがインプロセスに設定されている場合にのみ適用されます。

applicationPools要素はconfiguration要素の子です。 applicationPools要素は、プロファイラーに対して、インストルメントするアプリケーションプールを正確に指定し、IISアプリケーションプール名と同じ名前を使用します。この構成要素は、アプリプールのごく一部のみをインストルメント化する必要がある場合に役立ちます。たとえば、特定のサーバーに数百のアプリケーションプールがある場合でも、.NETエージェントがインストルメント化する必要があるのはそれらのプールのほんの一部です。

ここでは、特定のアプリケーションプールに対するインスツルメンテーションを無効にする例を示します。

<applicationPools>
  <applicationPool name="Foo" instrument="false"/>
  <applicationPool name="Bar" instrument="false"/>
</applicationPools>

ここでは、現在サーバー上で実行されているすべてのアプリケーションプールのインスツルメンテーションを無効にし、特定のアプリケーションプールのインスツルメンテーションを有効にする例を示します。

<applicationPools>
  <defaultBehavior instrument="false"/>
  <applicationPool name="Foo" instrument="true"/>
  <applicationPool name="Bar" instrument="true"/>
</applicationPools>

applicationPools要素は次の要素をサポートします。

タイプ	ブール値
デフォルト	`false`

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

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

エラー収集

errorCollector要素はconfiguration要素の子です。 errorCollectorは、キャッチされなかった例外に関する情報をキャプチャしてNewRelicに送信するエラー収集を構成します。

<errorCollector enabled="true" captureEvents="true" maxEventSamplesStored="100">
  <ignoreClasses>
    <errorClass>System.IO.FileNotFoundException</errorClass>
    <errorClass>System.Threading.ThreadAbortException</errorClass>
  </ignoreClasses>
  <ignoreMessages>
    <errorClass name="System.Exception">
       <message>Ignore message</message>
       <message>Ignore too</message>
    </errorClass>
  </ignoreMessages>
  <ignoreStatusCodes>
    <code>401</code>
    <code>404</code>
  </ignoreStatusCodes>
  <expectedClasses>
    <errorClass>System.ArgumentNullException</errorClass>
    <errorClass>System.ArgumentOutOfRangeException</errorClass>
  </expectedClasses>
  <expectedMessages>
    <errorClass name="System.Exception">
       <message>Expected message</message>
       <message>Expected too</message>
    </errorClass>
  </expectedMessages>
  <expectedStatusCodes>403,500-505</expectedStatusCodes>
  <attributes enabled="true">
    <exclude>myApiKey.*</exclude>
    <include>myApiKey.foo</include>
  </attributes>
</errorCollector>

ヒント

APMでのエラー構成の概要については、「APMでのエラーの管理」を参照してください。

重要

expectedClasses、 expectedMessages 、およびexpectedStatusCodesの構成設定には、 .NETエージェントバージョン8.31.0.0以降が必要です。

errorCollector要素は、次の要素と属性をサポートします。

タイプ	弦
デフォルト	（無し）

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

ヒント

エージェントのNoticeError() APIで報告されたカスタムエラーは、関連付けられたトランザクションにHTTPステータスコードがここで構成されている場合でも、NewRelicに報告されます。

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

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

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_ERROR_CODES=401, 501-503

ハイセキュリティモード

highSecurity要素はconfiguration要素の子です。高セキュリティモードを有効にするには、このプロパティをtrueに設定し、New Relic ユーザーインターフェイスで高セキュリティプロパティを有効にします。高度なセキュリティを有効にすると、SSL が有効になります。リクエストパラメータ、カスタムパラメータ、HTTPリクエストヘッダーは収集されません。例外メッセージの削除が有効になっています。また、クエリをそのままの形式で New Relic に送信することはできません。

タイプ	ブール値
デフォルト	`false`

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

<highSecurity enabled="true"/>

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

NEW_RELIC_HIGH_SECURITY=true

例外メッセージの除去

stripExceptionMessages要素はconfiguration要素の子です。例外メッセージの除去を有効にするには、このプロパティをtrueに設定します。デフォルトでは、これは false に設定されています。これは、エージェントがすべての例外からのメッセージを New Relic コレクターに送信することを意味します。高セキュリティモードを有効にすると、これは自動的に true に変更され、エージェントは例外からメッセージを削除します。

Transactionイベント

transactionEvents要素はconfiguration要素の子です。 transactionEventsを使用してトランザクションイベントを構成します。

<transactionEvents enabled="true" maximumSamplesStored="10000">
  <attributes enabled="true">
    <exclude>myApiKey.*</exclude>
    <include>myApiKey.foo</include>
  </attributes>
</transactionEvents>

transactionEvents要素は次の属性をサポートします。

タイプ	整数
デフォルト	`10000`

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

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

MAX_TRANSACTION_SAMPLES_STORED=500

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

ヒント

これらの属性設定は、 transactionイベントに固有です。属性設定は、この構成設定を使用して、すべてのイベントタイプにグローバルに適用できます。

注意

分散トレーシングや無限トレーシングが有効な場合、トランザクションイベントからの情報は、そのトランザクションのルートのスパンイベントに適用されます。トランザクション・イベントの属性設定をスパン・イベントに適用したり、グローバル属性設定として適用することを検討してください。

カスタムイベント

customEvents要素はconfiguration要素の子です。 customEventsを使用してカスタムイベントを構成します。

<customEvents enabled="true" maximumSamplesStored="10000"/>

customEvents要素は次の属性をサポートします。

タイプ	整数
デフォルト	`10000`

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

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

MAX_EVENT_SAMPLES_STORED=500

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

カスタムパラメータ

customParameters要素はconfiguration要素の子です。 customParametersを使用してカスタムパラメータを設定します。

<customParameters enabled="true" />

customParameters要素は次の属性をサポートします。

ラベル（タグ）

labels要素はconfiguration要素の子です。

これにより、タグの名前と値が設定されます。このリストは、コロンで区切られた名前と値のペアのセミコロン区切りのリストです。 NEW_RELIC_LABELS環境変数と一緒に使用することもできます。例：

<labels>foo:bar;zip:zap</labels>

NEW_RELIC_LABELS="foo:bar;zip:zap"

ブラウザのインストゥルメンテーション

browserMonitoring要素はconfiguration要素の子です。 browserMonitoring .NET アプリケーションでを構成します。 browserエンドユーザーのパフォーマンス体験をインサイトに提供します。これは、各ページのヘッダーとフッターに少量の JavaScript コードを挿入することにより、ユーザーのブラウザーが Web ページをダウンロードしてレンダリングするのにかかる時間を測定することで実現されます。

// If you use both the Exclude and Attribute elements
// the Exclude element must be listed first.
<browserMonitoring autoInstrument="true">
  <requestPathsExcluded>
    <path regex="url-regex-1"/>
    <path regex="url-regex-2"/>
    ...
    <path regex="url-regex-n"/>
  </requestPathsExcluded>
  <attributes enabled="true">
    <exclude>myApiKey.*</exclude>
    <include>myApiKey.foo</include>
  </attributes>
</browserMonitoring>

browserMonitoring要素は次の属性をサポートします。

タイプ	ブール値
デフォルト	`true`

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

重要

自動インストルメンテーションは .NET Framework アプリでのみ利用でき、.NET Core アプリでは手動インストルメンテーションを使用する必要があります。ASP.NET Core アプリケーションが .NET Framework によって監視されているか、Core エージェントによって監視されているかにかかわらず、自動インストルメンテーションは使用できません。

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

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

問い合わせの遅さ

slowSql要素はconfiguration要素の子です。 slowSqlは、遅いクエリ実行に関する情報のキャプチャを構成し、これらのクエリの説明プランをキャプチャして難読化します。

<slowSql enabled="true"/>

slowSql要素は次の属性をサポートします。

トランザクショントレース

transactionTracer要素はconfiguration要素の子です。 transactionTracerはトランザクショントレースを構成します。トレースには、発行されたクエリステートメントを含む、トランザクションの正確な呼び出しシーケンスが含まれます。

<transactionTracer enabled="true"
    transactionThreshold="apdex_f"
    recordSql="obfuscated"
    explainEnabled="true"
    explainThreshold="500"
    maxSegments="3000"
    maxExplainPlans="20">
  <attributes enabled="true">
    <exclude>myApiKey.*</exclude>
    <include>myApiKey.foo</include>
  </attributes>
 </transactionTracer>

transactionTracer要素は次の属性をサポートします。

タイプ	弦
デフォルト	`apdex_f`

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

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

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

タイプ	弦
デフォルト	`obfuscated`

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

注意

生のクエリを記録することで、機密情報を取得できる可能性があります。

タイプ	ブール値
デフォルト	`false`

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

タイプ	整数
デフォルト	`500`
ユニット	ミリ秒

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

タイプ	整数
デフォルト	`0`

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

データストアトレーサー

datastoreTracer要素はconfiguration要素の子です。

<datastoreTracer>
  <instanceReporting enabled="true"  />
  <databaseNameReporting enabled="true" />
  <queryParameters enabled="false" />
</datastoreTracer>

datastoreTracer要素は、次のサブ要素をサポートします。

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

注意

クエリのパラメータを記録すると、機密情報が取得される可能性があります。
transactionTracer.recordSql構成オプションはrawに設定する必要があります。そうしないと、このオプションは無視されます。

ディストリビューティッド（分散）トレーシング

distributedTracing要素はconfiguration要素の子です。

<distributedTracing enabled="false"
   excludeNewrelicHeader="false"/>

分散トレースを使用すると、リクエストが分散システムを通過するときにたどるパスを確認できます。.NETエージェントバージョン8.6.45.0以降が必要であり、.NETエージェント9.0.0.0以降ではデフォルトでオンになっています。

重要

分散トレースを有効にすると、クロスアプリケーショントレースが無効になり、APM機能に他の影響があります。有効にする前に、計画ガイドをお読みください。

分散トレースの設定の詳細については、「。 NETアプリケーションの分散トレースを有効にする」を参照してください。

distributedTracing要素は次の属性をサポートします。

タイプ	ブール値
デフォルト	`true`

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

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true

タイプ	ブール値
デフォルト	`false`

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

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

分散型トレーシングはスパンイベントを報告します。スパンイベントのレポートはデフォルトで有効ですが、ディストリビュートトレーススパンをレポートするためには有効にする必要があります。スパンイベントを無効にするには、次のいずれかのオプションを選択します。

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

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

無限のトレース

Infinite Tracing は、エージェントの外部にあるトレースオブザーバーを採用することで、分散トレースサービスを拡張します。さまざまなサービスでアプリケーショントレースを 100% 監視し、実用的なデータを提供するため、問題をより迅速に解決できます。

Infinite Tracingを有効にするには、 .NET エージェントのバージョンが 8.30 以降であることを確認し、分散トレースを有効にします。次に、次の追加設定を追加します。

<configuration . . . >
  <distributedTracing enabled="true" />
  <infiniteTracing>
    <trace_observer host="YOUR_TRACE_OBSERVER_HOST" />
  </infiniteTracing>
</configuration>

重要

無限トレーススパンは、 transactionTracer.maxSegments設定によって制限できます。

infiniteTracing要素は次の要素をサポートします。

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

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

重要

トレースオブザーバーを構成するときは、ホストの一部としてプロトコルを指定しないでください。たとえば、 https://myhost.infinitetracing.com の代わりにmyhost.infinitetracing.comを使用します。

クロスアプリケーショントレース

crossApplicationTracer要素はconfiguration要素の子です。 crossApplicationTracerは、アプリケーション間でトランザクショントレースをリンクします。サービス指向アーキテクチャーでリンクされると、HTTPを介して相互に通信するすべてのインストルメント化されたアプリケーションは、トランザクショントレースを、それらが呼び出すアプリケーションおよびそれらが呼び出されるアプリケーションと「リンク」するようになります。クロスアプリケーショントレースを使用すると、サービスとアプリケーション間のパフォーマンスの関係を簡単に理解できます。

重要

クロスアプリケーショントレースは、エージェント v9.0.0 の時点で非推奨となり、デフォルトで無効になっています。将来のエージェントのバージョンでは削除される予定です。エージェントの v9 以降で CAT を使用するには、 crossApplicationTracer.enabled = trueとdistributedTracing.enabled = falseの両方を設定する必要があります。ディストリビューティッド（分散）トレーシングを有効にすると、クロスアプリケーショントレーシングが無効になります。

<crossApplicationTracer enabled="true"/>

crossApplicationTracer要素は次の属性をサポートします。

スパンイベント

spanEvents要素はconfiguration要素の子です。 spanEventsを使用してスパンイベントを構成します。

<spanEvents enabled="true">
  <attributes enabled="true">
    <exclude>myApiKey.*</exclude>
    <include>myApiKey.foo</include>
  </attributes>
</spanEvents>

spanEvents要素は次の属性をサポートします。

タイプ	Int
デフォルト	`2000`

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

これは、 NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED環境変数を使用して構成することもできます。
10kを超える設定は推奨されません。サーバーによって1分あたりのデータの上限は10kに制限されることになります。
AI モニタリング用にエージェントを構成する場合は、値を10000に設定することをお勧めします。
重要
この設定オプションは、.NET Agent v9.0以降でのみ利用可能です。

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

ヒント

これらの属性設定は、スパンイベントに固有です。この構成設定を使用すると、属性設定をすべてのイベントタイプにグローバルに適用できます。

HTTPリクエストヘッダの取得

allowAllHeaders要素はconfiguration要素の子です。これをtrueに設定して、.NET エージェントがすべての HTTP 要求ヘッダーをキャプチャーし、それらをrequest.headers.{http-header-name}属性として SpanおよびTransactionイベントに適用できるようにします。これをfalseに設定すると、.NET エージェントのみが次の HTTP 要求ヘッダーを収集できるようになります:

request.headers.referer
request.headers.accept
request.headers.content-length
request.headers.host
request.headers.user-agent

タイプ	ブール値
デフォルト	`false`

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

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

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

重要

allowAllHeaders設定は、.NETAgentバージョン8.40.0以降でのみ使用できます。 allowAllHeadersを使用して属性をキャプチャする場合、キャプチャされたリクエストヘッダー属性は、ルートレベルと宛先レベルの属性設定によって引き続き制御されます。 attributes要素の下のincludeリストにrequest.header.*を設定しなくても（以下を参照）、.NETエージェントはすべてのヘッダー属性を除外します。デフォルトのnewrelic.configは、 request.header.*を含むように設定されています。

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

デフォルトのnewrelic.configは、.NETエージェントが不要なデータを収集しないように、次のHTTPリクエストヘッダーを明示的に除外するようにも設定されています。

<attributes enabled="true">
  <exclude>request.headers.cookie</exclude>
  <exclude>request.headers.authorization</exclude>
  <exclude>request.headers.proxy-authorization</exclude>
  <exclude>request.headers.x-*</exclude>
</attributes>

アプリケーションログ

重要

これらの構成オプションは、.NET エージェントバージョン 9.7.1 以降でのみ使用できます。コンテキストデータ (カスタム属性) に関連するオプションは、.NET エージェントバージョン 10.4.0 以降でのみ使用できます。

applicationLogging要素はconfiguration要素の子です。 applicationLoggingを使用して、アプリケーションのロギングアクティビティのインストルメンテーションを構成します。

3つの主要なサブ機能があります。

メトリック：ハーベストサイクルごとに書き込まれるログ行の総数（ Logging/lines ）、および特定のログレベル（たとえば、 Logging/lines/ERROR ）で書き込まれるログ行の数に関するメトリックを収集します。
ログ転送：有効にすると、エージェントはログデータをキャプチャしてNewRelicに送信します。
- コンテキストデータ ( AddCustomAttribute経由): 有効にすると、エージェントはカスタムログ属性をキャプチャして転送します。include要素とexclude要素は、他のエージェント属性設定と同じルールに従って、含めるか除外する属性名のカンマ区切りのリストです。デフォルトでは両方とも空であるため、すべてのログコンテキストデータがキャプチャされて転送されます。
- ログレベルのフィルタリング: カンマ区切りのリストで 1 つ以上のログレベルを設定すると、エージェントはそれらのレベルのメッセージがキャプチャされ、転送されるのを防ぎます。
- ラベル: 有効にすると、エージェントはエージェント転送ログにカスタムラベルを追加します。大文字と小文字を区別しない、カンマで区切られたラベル名のリストであるexclude属性を使用できます。デフォルトでは、 exclude属性が空の場合、エージェントはカスタムラベルを追加します。
ローカルログデコレーション：有効にすると、既存のログは、エラーなどの他のNewRelicデータとログをリンクするメタデータでデコレーションされます。

詳細については、コンテキストでの .NET エージェントログの使用に関するドキュメントを参照してください。

<applicationLogging enabled="true">
  <metrics enabled="true" />
  <forwarding enabled="true" maxSamplesStored="10000" logLevelDenyList="">
    <contextData enabled="false" include="" exclude="" />
    <labels enabled="false" exclude="" />
  </forwarding>
  <localDecorating enabled="false" />
</applicationLogging>

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

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_INCLUDE="myCustomAttribute1, myOtherCustomAttribute*"
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_EXCLUDE="myCustomAttribute2, myOtherCustomAttributeMoreSpecificName"
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LOG_LEVEL_DENYLIST="debug, warn"
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDE="label1, label2"
NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=true

applicationLogging要素は、次の属性とサブ要素をサポートします。

タイプ	ブール値
デフォルト	`true`

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

または、 NEW_RELIC_APPLICATION_LOGGING_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に送信されます。

注意

既存のログ転送ソリューションを使用してアプリケーションのログをすでにNewRelicに送信している場合は、ログデータの重複が請求されないように、エージェントでログ転送を有効にする前に必ず無効にしてください。

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を使用することもできます。デフォルト値は空の文字列で、「何も除外しない」ことを意味します。この属性はワイルドカードまたは正規表現をサポートしていません。

コードレベルの指標

codeLevelMetrics要素はconfiguration要素の子です。 codeLevelMetricsを使用して、スパンイベントの属性としてキャプチャされた追加のインストルメント化されたメソッドメタデータを介してCodeStreamでコードレベルのメトリックサポートを有効にします。

詳細については、 NewRelicCodeStreamの統合に関するドキュメントを参照してください。

<codeLevelMetrics enabled="true" />

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

NEW_RELIC_CODE_LEVEL_METRICS_ENABLED=true

AIモニタリング

デフォルトでは、AI モニタリングは無効になっています。 AI モニタリングを有効にするには、 aiMonitoring要素でenabled属性をtrueに設定します。 aiMonitoring要素はconfiguration要素の子です。

<aiMonitoring enabled="true" />

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

NEW_RELIC_AI_MONITORING_ENABLED=true

aiMonitoring要素は、次のサブ要素をサポートします。

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

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

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

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

NEW_RELIC_AI_MONITORING_RECORD_CONTENT_ENABLED=false

app.configまたはweb.configでの設定

ASP.NETおよび.NETFrameworkコンソールアプリの場合、アプリのapp.configまたはweb.configの最も外側の要素である<configuration>で次の設定を構成することもできます。

<appSettings>
   <add key="NewRelic.AgentEnabled" value="false" />
</appSettings>

重要

エージェントがローカルまたはグローバルの newrelic.configで無効になっている場合、これらのファイルの NewRelic.AgentEnabled 設定ではエージェントは有効になりません。

アプリのローカルルートやグローバルな設定場所以外の、設定ファイルの代替場所を指定します。入力する場所は、絶対パスでなければなりません。

<appSettings>
  <add key="NewRelic.ConfigFile" value="C:\Path-to-alternate-config-dir\newrelic.config" />
</appSettings>

appsettings.jsonでの設定

.NET Coreアプリの場合、次の条件が当てはまる場合は、 appsettings.jsonで次の設定を構成できます。

appsettings.jsonファイルは、アプリケーションの現在の作業ディレクトリにある必要があります。
このアプリケーションには、以下の依存関係が必要です。

{
  "NewRelic.AgentEnabled": "false"
}

重要

ローカルまたはグローバル newrelic.configでエージェントが無効になっている場合、これらのファイルの NewRelic.AgentEnabled 設定によってエージェントが有効になります。

{
  "NewRelic.ConfigFile": "C:Path-to-alternate-config-dir\newrelic.config"
}

重要

ASP.NET Core アプリの場合、 ASPNETCORE_ENVIRONMENT変数を設定すると、.NET エージェントはappsettings.{environment}.jsonから読み取ります。

この機械翻訳は、参考として提供されています。

設定概要 .css-21sua1{background:none;border:none;width:0;padding:0;}

重要

設定方法と優先順位レベル

必要な環境変数

注意

.NET Coreの環境変数

プロファイラーのコンフリクトに関する説明

オプションの環境変数

64 ビット システム上で 32 ビット アプリケーションをサポートします。

受信トレイ構成のエラー

セットアップオプション、newrelic.config

構成要素

agentEnabled

maxStackTraceLines

サービス要素

licenseKey （必須）

sendEnvironmentInfo

syncStartup

sendDataOnExit

sendDataOnExitThreshold

completeTransactionsOnThread

forceNewTransactionOnNewThread

リクエストタイムアウト

オートスタート

ホスト

重要な要素の隠蔽

注意

プロキシ要素

ホスト

port

uriPath

ドメイン

ユーザー

password

パスワード難読化

ログエレメント

level

監査ログ

コンソール

有効

ディレクトリ

ファイル名

logRollingStrategy

logMaxFiles

maxLogFileSizeMB

応募要素（必須）

name

disableSamplers

データ伝送素子

putForDataSend

ホスト名

コンフィグファイルによる設定

環境変数による設定

クラウドプラットフォームの利用

detectAws

detectAzure

検出GCP

detectPcf

ドッカーの検出

Kubernetesの検出

インストゥルメンテーションのオプション

計装要素

ルール要素 (インストゥルメンテーション)

重要

アプリケーションエレメント（計測器）

重要

属性要素

有効

include

exclude

機能オプション

アプリ・プール

重要

重要

defaultBehavior

アプリケーションプール

エラー収集

ヒント

設定概要

64 ビットシステム上で 32 ビットアプリケーションをサポートします。