.NETエージェントの設定

New Relicアカウントを作成し（永久無料）、.NETエージェントをインストールすると、環境に合わせて.NETエージェントを設定できるようになります。

設定の概要

APMエージェントの設定オプションを使用すると、エージェントの動作に関するいくつかの側面を制御できます。これらの設定オプションの一部は基本的なインストールプロセス（ライセンスキーやアプリ名の設定など）の一部ですが、ほとんどはログレベルの設定、プロキシホストアクセスの設定、特定のプロパティの除外、ディストリビューティッド（分散）トレーシングの有効化など、より高度な設定です。

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

特に明記されていない限り、.NETフレームワークと.NET Coreの両方のサポートは同じ設定オプションを使用し、同じAPM機能を持ちます。

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

重要

For IISnewrelic.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`ファイル内の`NewRelic.AgentEnabled`設定はwill be ignored。
環境変数	2番目に高い優先順位。これらについての詳細は、.NET環境変数を参照してください。
サーバーサイドコンフィグレーション	3番目に高い優先順位。利用できるサーバーサイドコンフィグレーションの設定数には限りがあります。他の設定は他の設定ソースから取得されます。
アプリローカル `newrelic.config`	4番目に高い優先順位。マルチアプリシステムでは、アプリローカルファイル`newrelic.config`を作成することで、個々のアプリを設定できます。これらのローカル設定ファイルは、グローバルファイル`newrelic.config`の設定を上書きします。エージェントは、以下のディレクトリにあるアプリローカル設定ファイルをこの順序で検索します。 `web.config`または`app.config`ファイルで、`NewRelic.ConfigFile`プロパティで指定されたディレクトリウェブアプリのルートディレクトリ（`app.config`または`web.config`）アプリの実行可能ファイルを含むディレクトリアプリローカル構成ファイルは完全である必要があり、XSDファイル（例えば、Windowsの場合は`C:\ProgramData\New Relic\.NET Agent\newrelic.xsd`）に対して検証を行う必要があることに注意してください。
デフォルト（グローバル） `newrelic.config`	デフォルトのソースであり、優先順位は最も低くなります。他の設定ファイルが存在しない場合、ホスト上のすべてのアプリケーションを設定します。グローバル設定ファイルは、New Relicエージェントのホームディレクトリにあります。 `%PROGRAMDATA%\New Relic\.NET Agent`

必須の環境変数

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

注意

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

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

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

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項目です。サービス項目では、エージェントとNew Relicサービスとの接続を設定します。

<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`

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

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

エージェントがNew Relicに接続するまで、アプリケーションの起動をブロックします。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エージェントは、この値を使用して、サポートされている設定値の難読化を解除します。例えば、難読化されたプロキシパスワードを指定した場合、このキーを使用して難読化が解除されます。

<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項目はNew Relicのログ設定を行います。エージェントは、アプリケーションのログとは別にログ情報を保管するために、独自のログファイルを生成します。

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

log項目は、以下の属性をサポートしています。

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

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

タイプ	文字列
デフォルト	`info`

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

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

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

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

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

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

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

タイプ	文字列
デフォルト	`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つの実行中のアプリケーションがある場合、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"

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

サンプラーは、メモリとCPUの使用状況に関する情報を収集します。サンプリングを無効にするには、これをtrueに設定してください。

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

NEW_RELIC_DISABLE_SAMPLERS=true

データ伝送項目

dataTransmission項目は、configuration項目の子項目です。この項目は、New Relicへのデータ送信方法に影響を与え、特定のデータ送信要件がある場合に使用できます。

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

dataTransmission項目は、以下の属性をサポートしています。

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

New Relicにデータを送信する際に使用されるHTTPメソッドを定義します。データ送信時にPUTメソッドを使用できるようにするには、これをtrueに設定してください。デフォルトでは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設定項目は、エージェントが利用状況情報を収集し、それをNew Relicサービスに送信して価格を決定する方法を制御します。エージェントは、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`

エージェントがMicrosoft Azureメタデータ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 エージェントはIIS ASPワーカープロセスとMicrosoft Azure Webおよびワーカーロールを計装します。他のプロセスを計装するには、カスタムアプリケーションの計装を参照してください。

ルール項目（計装）

重要

この機能は、.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属性が含まれています。さらに、エージェントバージョン10.48.0以降では、任意のinclude属性（デフォルト値：true）が追加されました。エージェントがそのプロセスの計装を防ぐには、このプロパティを「false」に設定します。

重要

これは、configuration項目の子項目であるapplication（設定）項目とは異なります。

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

または、エージェントバージョン10.48.0以降では、アプリケーションの環境変数でNEW_RELIC_INCLUDED_APPLICATION_NAMESやNEW_RELIC_EXCLUDED_APPLICATION_NAMESを設定してください。

NEW_RELIC_INCLUDED_APPLICATION_NAMES="MyService1.exe,MyService2.exe"
NEW_RELIC_EXCLUDED_APPLICATION_NAMES="MyService3.exe"

除外設定は含める設定よりも優先されることに注意してください。

属性項目

属性は、イベントまたはトランザクションのプロパティを決定するキーと値のペアです。各属性は、APMトランザクショントレース、APMエラートレース、Spanイベント、Transactionイベント、TransactionErrorイベント、PageViewイベントに送信されます。プライマリのattributes項目項目、.NETエージェントの属性収集を有効または無効にし、収集または除外する特定の属性を定義します。属性設定は、宛先ごとに個別に構成することもできます。

エラー収集
Transactionイベント
トランザクショントレース
スパンイベント
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の場合、applicationPoolの下にリストされ、instrument属性がfalseに設定されているアプリケーションプールは計装されません。

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

エラー収集

errorCollector項目は、configuration項目の子項目です。errorCollectorはエラー収集を設定します。これは、捕捉されなかった例外に関する情報をキャプチャし、New Relicに送信します。

<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項目は、以下の項目と属性をサポートしています。

タイプ	文字列
デフォルト	(なし)

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

ヒント

エージェントのNoticeError() APIを使用して報告されたカスタムエラーは、関連するトランザクションにここで設定されたHTTPステータスコードが設定されている場合でも、New Relicに報告されます。

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

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

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アプリケーションでを設定します。ブラウザを使用すると、エンドユーザーのパフォーマンスエクスペリエンスを洞察できます。これは、少量のJavacriptコードを書くページのヘッダーとフッターに挿入することで、ユーザーのブラウザがウェブページのダウンロードとレンダリングにかかる時間を測定して行われます。

// 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`

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

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

Browser計装は、環境変数によって有効または無効にすることもできます。

NEW_RELIC_BROWSER_MONITORING_AUTO_INSTRUMENT= true | 1 | false | 0

スロークエリ

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`

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

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

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

タイプ	文字列
デフォルト	`obfuscated`

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

注意

生のクエリを記録すると、機密情報が記録される可能性があります。

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

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

タイプ	整数
デフォルト	`500`
単位	ミリ秒

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

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

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

データストアトレーサー

datastoreTracer項目は、configuration項目の子項目です。

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

datastoreTracer項目は、以下のサブ項目をサポートしています。

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

注意

クエリパラメーターの記録により機密情報が収集される可能性があります。
設定オプションtransactionTracer.recordSqlはrawに設定する必要があります。設定しない場合、このオプションは無視されます。

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

distributedTracing項目は、configuration項目の子項目です。

<distributedTracing enabled="true"
   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トレースコンテキストヘッダーのみを使用するようになります。

サンプラー設定

重要

サンプラー設定は、.NET エージェントバージョン10.45.0以降で利用可能です。

.NETエージェントは現在、ディストリビューティッド（分散）トレーシングで使用するために構成できる4つの異なるサンプリングアルゴリズムをサポートしています。

Sampler Type	Description
適応型サンプラー	.NET エージェントによって使用されるオリジナルのサンプリングアルゴリズム。デフォルトで有効になっています。サンプリングの決定はランダムに行われ、サンプリング期間ごとに設定された数のサンプルを保持することを目標とします。
トレースID比率ベースのサンプラー	（ランダムに生成された）トレースIDに基づいて、設定された割合のトレースをサンプリングする、オープンテレメトリートレースID比率ベースのサンプラーの実装。
常時有効サンプラー	名前が示すように、このサンプラーはすべてのトレースをサンプリングします。このサンプラーを有効にすると、アプリケーションのパフォーマンスに影響があり、データの取り込みが増加する可能性があることに注意してください。
常時無効サンプラー	「常時有効」とは正反対で、このサンプラーはトレースを一切サンプリングしません。非常に特殊なケースで役立ちます。

サポートされているサンプラーは、複数のレベルで設定できます。

Sampler Level	Description
Root	これは、トレースの開始時に適用されるサンプラーです。デフォルトでは、適応型サンプラーがルートサンプラーとして構成されています。
遠隔地の親がサンプリングされている	これは、トレースにサンプリング済みのリモート親（つまり、トレースが上流サービスで発生した場合）がある場合に適用されるサンプラーです。例えば、常時有効サンプラーを使用するように設定することで、現在のアプリケーション内のすべてのトレースがサンプリングされるようにすることができます。
遠隔地の親がサンプリングされていない	これは、トレースにサンプリングされなかったリモート親（つまり、トレースが上流サービスで発生した場合）がある場合に適用されるサンプラーです。

<sampler>設定項目は<distributedTracing>項目の子項目であり、以下のように構成されています。

<distributedTracing ... >
  <sampler>
    <root>
      <!-- sampler type -->
    </root>
    <remoteParentSampled>
      <!-- sampler type -->
    </remoteParentSampled>
    <remoteParentNotSampled>
      <!-- sampler type -->
    </remoteParentNotSampled>
  </sampler>
</distributedTracing>

各サンプラーレベルについて、以下のいずれかのサンプラー設定を指定できます。

<default /> <!-- default is a synonym for <adaptive /> -->
<adaptive />
<traceIdRatioBased ratio="0.12" />
<alwaysOn />
<alwaysOff />

<traceIdRatioBased>項目には必須のratio属性があり、これは0.0から1.0の間の値で、サンプリングするトレースの割合を指定します。

重要

特定のサンプラーレベルで設定が指定されていない場合、またはそのレベルの設定項目がまったく指定されていない場合は、Adaptive Sampler [適応型サンプラー]が使用されます。

次の環境変数を使用して、サンプラータイプに可能な値の1つを指定して、さまざまなサンプラーレベルでディストリビューティッド（分散）トレーシングサンプラーを構成できます。

NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_ROOT = default | adaptive | traceIdRatioBased | alwaysOn | alwaysOff
NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_REMOTE_PARENT_SAMPLED =  default | adaptive | traceIdRatioBased | alwaysOn | alwaysOff
NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_REMOTE_PARENT_NOT_SAMPLED = default | adaptive | traceIdRatioBased | alwaysOn | alwaysOff

これらの環境変数のいずれかの値としてtraceIdRatioBasedが指定されている場合、同じサンプラーレベルに対して比率を指定する対応する環境変数も必要です。

NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_ROOT_TRACE_ID_RATIO_BASED_RATIO = 0.12
NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_REMOTE_PARENT_SAMPLED_TRACE_ID_RATIO_BASED_RATIO = 0.12
NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_REMOTE_PARENT_NOT_SAMPLED_TRACE_ID_RATIO_BASED_RATIO = 0.12

スパンイベントレポート

ディストリビューティッド（分散）トレーシングはスパンイベントを報告します。スパンイベントレポートはデフォルトで有効になっていますが、スパンをレポートするにはディストリビューティッド（分散）トレーシングを有効にする必要があります。スパンイベントを無効にするには、以下のいずれかのオプションを選択してください。

<spanEvents>項目をfalseに設定すると、newrelic.configファイルを介して無効になります。この項目は<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>

重要

Infinite Tracingの範囲は、transactionTracer.maxSegments設定によって制限できます。

infiniteTracing項目は、以下の項目をサポートしています。

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

トレースオブザーバーは、環境変数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エージェントv9.0以降でのみ利用可能です。

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

ヒント

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

HTTPリクエストヘッダーのキャプチャ

allowAllHeaders項目は、configuration項目の子項目です。これをtrueに設定すると、.NETエージェントがすべてのHTTPリクエストヘッダーをキャプチャし、それらをSpanおよびTransactionイベントにrequest.headers.{http-header-name}属性として適用できるようになります。これを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設定は、.NETエージェントバージョン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）で書き込まれるログ行の数に関するメトリクスを収集します。
ログ転送：有効にすると、エージェントはログデータをキャプチャし、New Relicに送信します。
- コンテキストデータ（AddCustomAttribute経由）：有効にすると、エージェントはカスタムログ属性をキャプチャして転送します。includeとexclude項目は、他のエージェント属性設定と同じルールに従って、含める属性名と除外する属性名をカンマで区切ったリストです。デフォルトでは両方とも空になっているため、すべてのログコンテキストデータがキャプチャされ、転送されます。
- ログレベルフィルタリング：カンマ区切りのリストで1つ以上のログレベルを設定すると、エージェントはそれらのレベルのメッセージがキャプチャされ、転送されるのを防ぎます。
- ラベル：有効にすると、エージェントはエージェントに転送されるログにカスタムラベルを追加します。大文字小文字を区別しない、カンマ区切りのラベル名のリストであるexclude属性を使用できます。デフォルトでは、exclude属性が空の場合、エージェントはカスタムラベルを追加します。
ローカルログの装飾：有効にすると、既存のログが、エラーなどの他のNew Relicデータとログをリンクするメタデータで装飾されます。

詳細については、コンテキスト内での.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に送信されます。

注意

既存のログ転送ソリューションを使用してすでにアプリケーションのログを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を使用することもできます。デフォルト値は空の文字列で、「何も除外しない」という意味です。この属性はワイルドカードや正規表現をサポートしていません。

コードレベルのメトリクス

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

詳細については、New Relic CodeStreamインテグレーションのドキュメントを参照してください。

<codeLevelMetrics enabled="true" />

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

NEW_RELIC_CODE_LEVEL_METRICS_ENABLED=true

クラウドプロバイダーのメタデータ

cloud項目は、configuration項目の子項目です。cloudを使用して、アプリケーションのcloudプロバイダーのメタデータを構成します。

cloud項目は、以下のサブ項目をサポートしています。

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

重要

この設定は通常必要ありません。エージェントは実行時にAWSアカウントIDを自動的に検出します。自動検出が機能しない場合、エージェントはここで設定された値にフォールバックします。

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

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

NEW_RELIC_CLOUD_AWS_ACCOUNT_ID=123456789012

AIモニタリング

デフォルトでは、AI監視は無効になっています。AI 監視を有効にするには、aiMonitoring項目でenabled属性をtrueに設定します。aiMonitoring項目は、configuration項目の子項目です。

重要

AIモニタリングを有効にすると、モニタリング対象として選択したモデルとの間で送受信される入力と出力のストリーミングコピー（そこに含まれる個人情報も含む）が記録されます。AIモニタリングを使用する場合、AIモニタリング機能を提供する目的でモデルユーザーのインタラクションが第三者（New Relic）によって記録される可能性があることについて、モデルユーザーから同意を得る責任があります。

<aiMonitoring enabled="true" />

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

NEW_RELIC_AI_MONITORING_ENABLED=true

aiMonitoring項目は、以下のサブ項目をサポートしています。

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

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

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

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

NEW_RELIC_AI_MONITORING_RECORD_CONTENT_ENABLED=false

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

ASP.NETおよび.NETフレームワークのコンソールアプリの場合、アプリの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

サービス項目

ライセンスキー（必須）

sendEnvironmentInfo

syncStartup

sendDataOnExit

sendDataOnExitThreshold

completeTransactionsOnThread

forceNewTransactionOnNewThread

requestTimeout

autoStart

ホスト

難読化キー項目

注意

プロキシ項目

ホスト

port

URIPATH

ドメイン：

ユーザー

パスワード

passwordObfuscated

ログ項目

enabled

level

auditLog

console

directory

fileName

logRollingStrategy

logMaxFiles

maxLogFileSizeMB

アプリケーション項目（必須）

name

disableSamplers

データ伝送項目

putForDataSend

ホスト名

設定ファイルを使用して設定する

環境変数を使用して設定する

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

detectAws

detectAzure

detectGcp

detectPcf

detectDocker

detectKubernetes

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

計装項目

ルール項目（計装）

重要

アプリケーション項目（計装）

重要

属性項目

enabled

include

exclude

機能オプション

アプリプール

重要

重要

defaultBehavior

applicationPool

エラー収集

ヒント

重要

設定の概要