.NETエージェントの互換性と要件

New Relicの .NET エージェントは、.NET フレームワークと .NET Core の両方をサポートします。このドキュメントでは、.NET ランタイム、フレームワーク、ライブラリの互換性とサポートについて説明します。

エージェントには、フレームワーク、データベース、メッセージキューシステムなど、.NETエコシステムで最も人気ある一部のビルトイン・インストゥルメンテーションとメッセージキューシステムが含まれています。エージェントをダウンロードおよびインストール後は、監視下のプロセス内で実行されます。エージェントは個別のプロセスまたはサービスを作成しません。

自動的にインストゥルメントされないフレームワークとライブラリについては、.NETカスタムインストゥルメンテーションを使用してエージェントを拡張できます。

.NETエージェントをお試しになりますか？New Relicアカウントの作成は無料です。クレジットカードは不要です。

要件

Windowsまたは Linuxに、New Relic .NETエージェントをインストールする前に、システムが以下の要件を満たしていることを確認してください。

.NET エージェントは、.NET Core バージョン 3.1、および .NET 5.0、6.0、7.0、8.0、9.0 と互換性があります。

重要

エージェントは、現在 Microsoft によってサポートされている対象.NET ランタイムを対象とするインストゥルメントされたアプリケーションの場合にのみ完全にサポートされます。エージェントは、以下にリストされている EOL されたランタイムでも動作する可能性がありますが、EOL されたランタイムではエージェントの新しいバージョンはテストされません。

.NET Coreバージョン	最低限必要な.NETエージェントバージョン
.NET Core 3.1 (サポート終了)	8.21.34.0以降
.NET 5.0 (サポート終了)	8.35.0以降
.NET 6.0 (サポート終了)	9.2.0以降
.NET 7.0 (サポート終了)	10.0.0以降
.NET 8.0	10.0.0以降
.NET 9.0	10.0.0以降

重要

Linux ARM64 プラットフォームでは、.NET エージェントは .NET 5.0 以降のバージョンのみをサポートします。

このエージェントは、以下のオペレーティングシステムでの動作を確認済みです。

オペレーティング·システム	サポート対象バージョン
Windows（32ビットおよび64ビットのIntel互換アーキテクチャー）	Windows Server 2008 R2 SP1 Windows Server 2012 Windows Server 2012 R2 Windows Server 2016 Windows Server 2019 Windows Server 2022 ウィンドウズ10 Windows 11 Server 2016上で動作するWindowsコンテナ（NanoServerベースの画像には対応していません）
Linux（64ビットIntel互換のみ）	.NET Core 2.0+/.NET 5+ランタイムがサポートするすべてのx64 Linuxの販売は、.NET Coreエージェントによってサポートされています。完全なリストについては、使用しているランタイムのバージョンに関するMicrosoftのドキュメントを参照してください。
Linux（ARM64/aarch64アーキテクチャー）	.NET 5+ランタイムがサポートするすべてのARM64 Linuxディストリビューションは、次の既知の例外を除き、.NETエージェントによってサポートされています。 Alpine Linux

オペレーティング·システム

サポート対象バージョン

Windows（32ビットおよび64ビットのIntel互換アーキテクチャー）

Windows Server 2008 R2 SP1
Windows Server 2012
Windows Server 2012 R2
Windows Server 2016
Windows Server 2019
Windows Server 2022
ウィンドウズ10
Windows 11
Server 2016上で動作するWindowsコンテナ（NanoServerベースの画像には対応していません）

Linux（64ビットIntel互換のみ）

.NET Core 2.0+/.NET 5+ランタイムがサポートするすべてのx64 Linuxの販売は、.NET Coreエージェントによってサポートされています。完全なリストについては、使用しているランタイムのバージョンに関するMicrosoftのドキュメントを参照してください。

Linux（ARM64/aarch64アーキテクチャー）

.NET 5+ランタイムがサポートするすべてのARM64 Linuxディストリビューションは、次の既知の例外を除き、.NETエージェントによってサポートされています。

Alpine Linux

.NETエージェントのインストールと実行には、以下の許可が必要です。

コンポーネント	必要な許可
エージェントのインストール	エージェントをインストールするプロセスまたはユーザーには、環境変数を設定し、エージェントがインストールされたディレクトリへの書き込みアクセスを設定するために、十分な許可が必要です。
エージェントの実行	監視中のプロセスには、エージェントをインストールしたディレクトリへの読み取り/書き込みアクセス権が必要です。エージェントは監視対象プロセスの一部として実行され、正常に機能するために、これらの許可に依存します。リバースプロキシ経由でIISを使用するアプリケーションには、グループ`IIS_IUSRS`がよく使用されます。

コンポーネント

必要な許可

エージェントのインストール

エージェントをインストールするプロセスまたはユーザーには、環境変数を設定し、エージェントがインストールされたディレクトリへの書き込みアクセスを設定するために、十分な許可が必要です。

エージェントの実行

監視中のプロセスには、エージェントをインストールしたディレクトリへの読み取り/書き込みアクセス権が必要です。エージェントは監視対象プロセスの一部として実行され、正常に機能するために、これらの許可に依存します。

リバースプロキシ経由でIISを使用するアプリケーションには、グループIIS_IUSRSがよく使用されます。

.NET エージェントは、.NET Core 3.1、および .NET 5.0、6.0、7.0、8.0、9.0 をターゲットとするアプリケーションと互換性があります。ターゲットフレームワークは.csprojファイルにあります。エージェントの互換性は、.NET Core のバージョンによって異なります。

互換：

<TargetFramework>netcoreapp3.1</TargetFramework>

<TargetFramework>net5.0</TargetFramework>

<TargetFramework>net6.0</TargetFramework>

<TargetFramework>net7.0</TargetFramework>

<TargetFramework>net8.0</TargetFramework>

<TargetFramework>net9.0</TargetFramework>

重要

Linux ARM64プラットフォームでは、.NETエージェントonlyはnet5.0以降のターゲットフレームワークをサポートします。

.NET フレームワークをターゲットとする ASP..NET Core アプリケーションを監視する場合は、.NET エージェントをインストールした後、.NET フレームワークのサポートが有効になっていることを確認してください。

自動インストゥルメンテーション

アプリケーションが ASP..NET Core でホストされている場合、エージェントは自動的にインストゥルメントされた瞬間を作成します。 .NET エージェントは、インストール後にアプリケーションを自動的にインストゥルメントしました。アプリが自動的にインストゥルメント化されない場合、またはインストゥルメンテーションを追加したい場合は、カスタムインストゥルメンテーションを使用してください。

.NETエージェントは、以下のデータストアへの .NETアプリケーション呼び出しのパフォーマンスを自動的にインストゥルメントします。

データストア	インスタンスの詳細	メモ
Cosmos DB		.NETエージェント`v9.2.0`以降では、Microsoft.Azure.Cosmosライブラリを自動的にインストゥルメントします。サポートされている最小バージョン：3.17.0 Latest verified compatible version: 3.51.0 バージョン 3.35.0 以降は、.NET エージェント v10.32.0 以降でサポートされます。
Couchbase		CouchbaseNetClientを使用します。サポートされる最小バージョン: 3.2.0 最新の検証済み互換バージョン: 3.6.6 必要なエージェントの最小バージョン: 10.40.0
Microsoft SQL Server		System.Data.SqlClient NuGet packageパッケージまたはMicrosoft.Data.SqlClient NuGetパッケージからSqlClientを使用します。 System.Data.SqlClient サポートされている最小バージョン：4.4.0 最新の検証済み互換バージョン：4.8.6 Microsoft.Data.SqlClient サポート対象の最小バージョン：1.0.19239.1 最新の検証済み互換バージョン: 6.0.2
Oracle		Oracle.ManagedDataAccess.Coreを使用するサポートされる最小バージョン: 23.4.0 最新の検証済み互換バージョン: 23.8.0 `Oracle.ManagedDataAccess.Core`の古いバージョンはインストゥルメントされた可能性がありますが、テストされておらず、サポートされていません。
PostgreSQL		Npgsqlの使用サポートされている最小バージョン：4.0.0 最新の検証済み互換バージョン：4.0.13 Npgsqlの旧バージョンもインストゥルメントできますが、重複および/または不足メトリクスが発生する場合があります。
MongoDB（最新ドライバー）		サポートされている最小バージョン：2.3.0 最新の検証済み互換バージョン: 3.3.0 バージョン 3.0.0.NET エージェント v10.40.0 以降では、バージョン 10.40.0 以降がサポートされます。エージェントバージョン10.12.0以降では、ドライババージョン2.7以降に追加された以下のメソッドがインストゥルメントされます。 IMongoCollection.CountDocuments[非同期] IMongoCollection.EstimatedDocumentCount[非同期] IMongoCollection.AggregateToCollection[非同期] IMongoDatabase.ListCollectionNames[非同期] IMongoDatabase.Aggregate[非同期] IMongoDatabase.AggregateToCollection[非同期] IMongoDatabase.Watch[非同期]
MySQL		MySql.DataまたはMySQLコネクターの使用 MySql.Data サポートされている最小バージョン：6.10.7 最新の検証済み互換バージョン: 9.3.0 MySqlConnector サポートされている最小バージョン：1.0.1 最新の検証済み互換バージョン: 2.4.0
StackExchange.Redis		サポートされている最小バージョン：1.0.488 最新の検証済み互換バージョン: 2.8.31
Elasticsearch		Elastic.Clients.Elasticsearch 、NEST、またはElasticsearch.Netを使用します。 Elastic.Clients.Elasticsearch サポートされている最小バージョン：8.0.0 サポートされる最大バージョン: 8.15.10 バージョン8.10.0以降は、.NETエージェントv10.20.1以降でサポートされます。バージョン8.12.1以降は、.NETエージェントv10.23.0以降でサポートされます。 NEST サポートされている最小バージョン：7.0.0 最新の検証済み互換バージョン：7.17.5 Elasticsearch.Net サポートされている最小バージョン：7.0.0 最新の検証済み互換バージョン：7.17.5
Memcached		EnyimMemcachedCoreを使用します。サポートされている最小バージョン：2.0.0 Latest verified compatible version: 3.4.0
DynamoDB		AWSSDK.DynamoDBv2を使用します。サポートされる最小バージョン: 3.5.0 Latest verified compatible version: 4.0.1 必要なエージェントの最小バージョン: 10.33.0
System.Data.ODBC		System.Data.Odbcを使用します。サポートされている最小バージョン：8.0.0 最新の検証済み互換バージョン: 9.0.4 必要なエージェントの最小バージョン: 10.35.0 .NET フレームワーク (組み込みの System.Data ネームスペースを使用) の ODBC データストア呼び出しでサポートされている次の機能は、.NET 8 以降ではサポートされていません。接続`Open/OpenAsync`呼び出し SqlDataReader `Read/NextResult`呼び出し遅いSQLトレース

.NETエージェントは、データストアプロセスを直接モニターしません。また、デフォルトでは、クエリのトレースでキャプチャされた.NET SQLパラメーターには、パラメーター化したクエリやストアドプロシージャのパラメーターはリストされません。

サポート対象のデータストアに対するインスタンス詳細の収集は、デフォルトで有効になっています。現在リストされてないデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comでサポートを受けてください。

データストアがここにリストされていない場合は、 .NET エージェントAPIの RecordDatastoreSegment メソッドを使用してカスタムインストゥルメンテーションを追加できます。

.NETエージェントは、以下の外部呼び出しライブラリを自動的にインストゥルメントします。

ライブラリ	Supported methods
HttpClient	エージェントは、次のHttpClientメソッドをインストゥルメントします。 `SendAsync` `GetAsync` `PostAsync` `PutAsync` `DeleteAsync` `GetStringAsync` `GetStreamAsync` `GetByteArrayAsync`

ライブラリ

Supported methods

HttpClient

エージェントは、次のHttpClientメソッドをインストゥルメントします。

SendAsync
GetAsync
PostAsync
PutAsync
DeleteAsync
GetStringAsync
GetStreamAsync
GetByteArrayAsync

.NETエージェントは、次のLLMフレームワークを自動的にインストゥルメントするように設定できます。

フレームワーク	フレームワークの最小バージョン	エージェントの最小バージョン	最新の検証済み互換バージョン
AWS Bedrock	3.7.200.0	10.23.0 ( `InvokeModelAsync` ) 10.37.0 ( `InvokeModelAsync` 、 `ConverseAsync` )	4.0.0.4
オープンAI	2.0.0	10.37.0 ( `CompleteChat` 、 `CompleteChatAsync` )	2.1.0
Azure.AI.OpenAI	2.0.0	10.37.0 ( `CompleteChat` 、 `CompleteChatAsync` )	2.1.0

.NETエージェントは、エージェントの転送とローカルログ装飾を使用して、自動ログインコンテキストのロギングフレームワークを自動的にインストゥルメントするように設定できます。

フレームワーク	フレームワークの最小バージョン	エージェントの最小バージョン	最新の検証済み互換バージョン
Log4Net	2.0.10	9.7.0	3.0.4
セリロッグ	2.5.0	9.7.0	4.3.0
NLog	4.5.0	9.7.0	5.5.0
Microsoft.Extensions.Logging	3.0.0	10.0.0	9.0.4

エージェントは、以下に示すメッセージシステムを自動的にインストゥルメントします。

ライブラリ	Supported methods
Confluent.Kafka	トピックに基づいて生成し消費します以下のメソッドがインストゥルメントされています。 `IProducer.Produce` `IProducer.ProduceAsync` `IConsumer.Consume` サポートされている最小バージョン：1.4.0 最新の検証済み互換バージョン: 2.10.0
NServiceBus	メッセージの配置と採用サポートされている最小バージョン：5.0 最新の検証済み互換バージョン: 9.2.7
RabbitMQ	メッセージの配置、採用、およびキューの削除 `IBasicConsumer`を使ってメッセージを受信するときは、`EventingBasicConsumer`が.NETエージェントによってインストゥルメントされる唯一の実装になります。 `BasicGet` はインストゥルメンテーションされますが、エージェントは`BasicGet`のディストリビューティッド（分散）トレーシングをサポートしていません。以下のメソッドがインストゥルメントされています。 `IModel.BasicGet` `IModel.BasicPublish` `IModel.BasicConsume` `IModel.QueuePurge` `EventingBasicConsumer.HandleBasicDeliver` サポートされている最小バージョン：3.5.2 最新の検証済み互換バージョン：6.6.0
MassTransit（エージェントバージョン10.19.0以降）	メッセージの公開/送信と消費サポートされている最小バージョン：7.1.0 最新の検証済み互換バージョン: 8.3.7
AWSSDK.SQS (Amazon Simple Queue Service) (エージェントバージョン 10.27.0 以降)	メッセージの送受信サポートされる最小バージョン: 3.7.0 Latest verified compatible version: 4.0.0.4
AWSSDK.Kinesis (Amazon Kinesis Data Streams) (エージェントバージョン 10.40.0 以降)	オペレーション`PutRecord(s)Async`と`GetRecordsAsync`は、メッセージブローカーのオペレーションとしてインストゥルメントされます。他の Kinesis 操作は、基本的なメソッド呼び出しとしてインストゥルメント化されます。サポートされる最小バージョン: 3.7.0 Latest verified compatible version: 4.0.2.3
AWSSDK.KinesisFirehose (Amazon Kinesis Firehose) (エージェントバージョン 10.40.0 以降)	すべての Kinesis Firehose 操作は、基本的なメソッド呼び出しとしてインストゥルメント化されます。サポートされる最小バージョン: 3.7.0 Latest verified compatible version: 4.0.1.2

利用できない機能

.NETエージェントでは、以下の機能は使用できません。

.NETエージェントは、トリム自己完結型デプロイメントと実行ファイルをサポートしていません。これは、エージェントが依存するアセンブリをコンパイラがトリミングする可能性があるためです。
GRPCの互換性の問題により、Alpine LinuxではInfinite Tracingはサポートされていません。詳細については、「このエージェントの問題」を参照してください。

.NETエージェントでは、エージェントが適切に機能するためにはジャストインタイム（JIT）コンパイルが必要です。このため、.NETアプリケーションのネイティブAhead of Time（AOT）をサポートしていません。

エージェントを他のNew Relic製品に接続

APMに加え、.NETエージェントは他のNew Relic製品と統合し、エンドツーエンドの可視性を提供します。

製品	統合
ブラウザのモニタリング	ASP.NET Core v6.0以降のウェブアプリケーション（MVC、Razor、Blazor）の場合、自動インストゥルメンテーションを有効化すると、.NETエージェント（バージョン10.19.0以降）は自動的にBrowser JavaScriptエージェントを挿入します。その他の種類のウェブアプリケーションの場合は、.NETエージェントAPIまたはブラウザエージェントのコピー/ペーストメソッドを使用して、エージェントを挿入できます。ブラウザインジェクションを有効化後は、APMの概要ページでブラウザデータを表示したり、特定のアプリに対してAPMとブラウザデータを素早く切り替えできます。設定オプションと手動インストゥルメンテーションについては、ブラウザモニタリングと.NETエージェントを参照してください。
インフラストラクチャのモニタリング	インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIにホストのリストを表示し、Infrastructure UIでAPMアプリ別にインフラストラクチャホストをフィルタリングできます。詳細については、Infrastructure UIのAPMデータを参照してください。
ダッシュボード	PHPエージェントはNRQLクエリを実行するため、デフォルトのイベントと属性を送信します。高度な分析のために、カスタムイベントを記録することもできます。

製品

統合

ブラウザのモニタリング

ASP.NET Core v6.0以降のウェブアプリケーション（MVC、Razor、Blazor）の場合、自動インストゥルメンテーションを有効化すると、.NETエージェント（バージョン10.19.0以降）は自動的にBrowser JavaScriptエージェントを挿入します。

その他の種類のウェブアプリケーションの場合は、.NETエージェントAPIまたはブラウザエージェントのコピー/ペーストメソッドを使用して、エージェントを挿入できます。

ブラウザインジェクションを有効化後は、APMの概要ページでブラウザデータを表示したり、特定のアプリに対してAPMとブラウザデータを素早く切り替えできます。設定オプションと手動インストゥルメンテーションについては、ブラウザモニタリングと.NETエージェントを参照してください。

インフラストラクチャのモニタリング

インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIにホストのリストを表示し、Infrastructure UIでAPMアプリ別にインフラストラクチャホストをフィルタリングできます。詳細については、Infrastructure UIのAPMデータを参照してください。

ダッシュボード

PHPエージェントはNRQLクエリを実行するため、デフォルトのイベントと属性を送信します。高度な分析のために、カスタムイベントを記録することもできます。

要件

New Relicの.NETエージェントをインストールする前に、システムが以下の要件を満たしていることを確認します。

.NET Framework 4.6.2 以降

.NET Framework 4.6.2 以降で計装アプリケーションを実行するには、 New Relic .NET agent 10.0 以降を実行する必要があります。 .NET フレームワークバージョン 4.0 以下で計装アプリケーションを実行するには、 New Relic .NET エージェントの 7.0 より前のバージョンを実行する必要があります。詳細およびダウンロード手順については、「.NET フレームワーク 4.0 以前のテクニカルサポート」を参照してください。

The .NET agent doesn't support .NET Framework versions 4.5.1, 4.5.2, and 4.6.1

以下のいずれか1つのアプリ/ウェブサーバーを使用する必要があります。

IIS
セルフホストのOWIN
セルフホストのWCF
Kestrel
KestrelとIISリバースプロキシ（AspNetCoreModule経由）
KestrelとIISリバースプロキシ（AspNetCoreModuleV2経由）
エージェントは、IISにホスティングされているアプリに対してトランザクションを自動的に作成します。WCFとOWINのバージョン3以上でセルフホストする場合も、エージェントはトランザクションを自動的に作成します。他のセルフホストサービスについては、カスタムインストゥルメンテーションを介してトランザクションを作成する必要があります。

エージェントには、以下のオペレーティングシステムのいずれか1つが必要です。

Windows Server 2008
Windows Server 2008 R2
Windows Server 2012
Windows Server 2012 R2
Windows Server 2016
Windows Server 2019
Windows Server 2022
ウィンドウズ10
Windows 11
Windows Azure （OS Family 1、2、3）
Windows 2016上で動作するWindowsコンテナ（NanoServerベースの画像には対応していません）

インストレーションには、昇格された権限（アドミニストレーター）が必要です。たとえば、次のことが可能です。

アドミニストレーターユーザーとしてログイン。
アドミニストレーターグループのメンバーになる。
新しいオペレーティングシステムでプロンプトが表示されたら、昇格した資格情報を入力します。
監視対象のプロセスには、エージェントをインストールするディレクトリへの読み取り/書き込みのアクセス権が必要です。エージェントは監視対象プロセスの一部として実行され、正常に機能するために、これらのアクセス権に依存します。
Recommendation:
newrelic.configファイルに対するアクセス許可を制限し、監視対象プロセスの所有者にのみ読み取り/書き込みアクセス許可を付与します。
アクセス権と特権を保有するユーザー数を最小限に抑えるため、エージェントによって作成されるログのアクセス権限を見直します。

.NET共通言語ランタイム（CLR）のみが、1つのプロファイラーが任意の時点でプロセスのプロファイリングAPIにアクセスできます。当社の.NETエージェントを他のモニターソフトウェアと一緒に実行すると、プロファイラー競合が発生します。詳細については、その他のAPMソフトウェアを使用中のエラーを参照してください。

自動インストゥルメンテーション

アプリケーションが ASP.NET または完全にサポートされている別のフレームワークでホストされている場合、.NET エージェントはインストール後にアプリケーションを自動的に計装します。アプリが自動的にインストゥルメント化されない場合、またはインストゥルメンテーションを追加したい場合は、カスタムインストゥルメンテーションを使用してください。

.NETエージェントは、データストアプロセスを直接モニタリングしません。また、デフォルトでは、クエリトレースの.NET SQLパラメーターキャプチャには、パラメーター化したクエリまたはストアドプロシージャのパラメーターはリストされません。SQLクエリパラメーターの収集は、エージェントの設定で有効になります。

エージェントは自動的にいくつかのアプリケーションフレームワークをインストゥルメントされました。これらのフレームワークをfully supportedと呼びます。以下にリストします。

ASP.NET MVC 2
ASP.NET MVC 3
ASP.NET MVC 4
ASP.NET MVC 5
ASP.NET Web API v2
ASP.NET Core MVC 2.0
ASP.NET Core 2.1
ASP.NET Core 2.2
ASP.NET Web Forms
Castle MonoRail v2（.NETエージェントのバージョン10.0以降ではサポートされていません）
以下を使用した、.NETフレームワーク上のOWINホスト型Web APIアプリケーション。
Microsoft.Owin.Host.HttpListener v2.x
Microsoft.Owin.Host.HttpListener v3.x
Microsoft.Owin.Host.HttpListener v4.x
SOAPベースのWebサービス
WCF

WCF インストゥルメンテーションは、次の一般的なバインディングタイプ(クライアントとサービスの両方) に対してテストされています。ディストリビューティッド（分散）トレーシング (DT) およびクロスアプリケーショントレーシング (CAT) では、さまざまなレベルのサポートが利用可能です。

バインディング	ディストリビューティッド（分散）トレーシングのサポート	クロスアプリケーショントレーシング（CAT）のサポート（非推奨）
BasicHTTP	サポート対象	サポート対象
WebHTTP	サポート対象	サポート対象
WSHTTP	サポート対象	サポート対象
NetTCP	サポート対象	サポート対象
NetNamedPipe	サポートされていない*	サポートされていない*
NetMSMQ	サポートされていない*	サポートされていない*

* ディストリビューティッド（分散）トレーシングは、これらのディストリビューティッド（分散）トレーシングAPIメソッドを使用して手動で実装できます。

サポート対象のデータストアにインスタンス詳細を収集するには、.NETエージェントのバージョン6.5.29.0以上が必要であり、デフォルトで有効化されています。現在リストされてないデータストアからインスタンスレベルの情報をリクエストするには、New Relicサポートセンターでサポートを受けてください。

こうしたデータストアに対する.NET Frameworkアプリケーション呼び出しのパフォーマンスを自動インストゥルメンテーションするには、.NETエージェントのバージョン8.14以上があることを確認してください。

データストア	インスタンスの詳細	備考
Cosmos DB		.NETエージェント`v9.2.0`以降では、Microsoft.Azure.Cosmosライブラリを自動的にインストゥルメントします。サポートされている最小バージョン：3.17.0 Latest verified compatible version: 3.51.0 バージョン 3.35.0 以降は、.NET エージェント v10.32.0 以降でサポートされます。
Couchbase		CouchbaseNetClientを使用します。サポートされている最小バージョン：2.0.0 最新の検証済み互換バージョン: 3.6.6 バージョン 3.2.0 以降は、.NET エージェント v10.40.0 以降でサポートされます。互換性のない既知のバージョン: 3.0.x、3.1.x CouchbaseNetClient 2.x では、対応するマルチドキュメントを優先して、以下はデフォルトでインストゥルメント表示されません。 `Get(string key)` `GetDocument(string key)` `Remove(string key)` `Remove(string key, ulong cas)` `Upsert<T>(string key, T value)`
IBM DB2
Microsoft SQL Server		System.Data.SqlClient NuGet packageパッケージ、Microsoft.Data.SqlClient NuGetパッケージまたはフレームワーク組み込みSystem.DataアセンブリからSqlClientを使用します。 System.Data.SqlClient サポートされている最小バージョン：4.4.0 最新の検証済み互換バージョン：4.8.6 Microsoft.Data.SqlClient サポート対象の最小バージョン：1.0.19239.1 最新の検証済み互換バージョン: 6.0.2 System.Data サポート対象の最小バージョン：.NET Framework 4.6.2 最新の検証済み互換バージョン：4.8
System.Data.ODBC		.NET フレームワークの組み込みの`System.Data.ODBC`ネームスペースを使用します。現在サポートされているすべての .NET フレームワークエージェントバージョンで利用できます。 Microsoft が現在サポートしている .NET フレームワークのすべてのバージョンは互換性があることが確認されています。
MongoDB（レガシードライバー）		サポートされている最小バージョン：1.10.0 最新の検証済み互換バージョン：1.10.0 既知の非互換性バージョン：インスタンスの詳細はバージョン2未満では利用できません。
MongoDB（最新ドライバー）		サポートされている最小バージョン：2.3.0 最新の検証済み互換バージョン: 3.3.0 バージョン 3.0.0.NET エージェント v10.40.0 以降では、バージョン 10.40.0 以降がサポートされます。エージェントバージョン10.12.0以降では、ドライババージョン2.7以降に追加された以下のメソッドがインストゥルメントされます。 `IMongoCollection.CountDocuments[Async]` `IMongoCollection.EstimatedDocumentCount[Async]` `IMongoCollection.AggregateToCollection[Async]` `IMongoDatabase.ListCollectionNames[Async]` `IMongoDatabase.Aggregate[Async]` `IMongoDatabase.AggregateToCollection[Async]` `IMongoDatabase.Watch[Async]`
MySQL		MySql.DataまたはMySQLコネクターの使用 MySql.Data サポートされている最小バージョン：6.10.7 最新の検証済み互換バージョン: 9.3.0 MySqlConnector サポートされている最小バージョン：1.0.1 最新の検証済み互換バージョン: 2.4.0
Oracle		Oracle.ManagedDataAccessを使用するサポートされる最小バージョン: 12.1.2400 最新の検証済み互換バージョン: 23.8.0
PostgreSQL		Npgsqlの使用サポートされている最小バージョン：4.0.0 最新の検証済み互換バージョン：4.0.5 Npgsqlの旧バージョンもインストゥルメントできますが、重複および/または不足メトリクスが発生する場合があります。
ServiceStack.Redis		最新の検証済み互換バージョン：4.0.40 既知の非互換性バージョン：4.0.44以降
StackExchange.Redis		サポートされている最小バージョン：1.0.488 最新の検証済み互換バージョン: 2.8.31
Elasticsearch		Elastic.Clients.Elasticsearch 、NEST、またはElasticsearch.Netを使用します。 Elastic.Clients.Elasticsearch サポートされている最小バージョン：8.0.0 サポートされる最大バージョン: 8.15.10 バージョン8.10.0以降は、.NETエージェントv10.20.1以降でサポートされます。バージョン8.12.1以降は、.NETエージェントv10.23.0以降でサポートされます。 NEST サポートされている最小バージョン：7.0.0 最新の検証済み互換バージョン：7.17.5 Elasticsearch.Net サポートされている最小バージョン：7.0.0 最新の検証済み互換バージョン：7.17.5
Memcached		EnyimMemcachedCoreを使用します。サポートされている最小バージョン：2.0.0 Latest verified compatible version: 3.4.0
DynamoDB		AWSSDK.DynamoDBv2を使用します。サポートされる最小バージョン: 3.5.0 Latest verified compatible version: 4.0.1 必要なエージェントの最小バージョン: 10.33.0

エージェントは、以下の外部呼び出しライブラリを自動的にインストゥルメントします。

ライブラリ	Supported methods
HttpClient	エージェントは、次のHttpClientメソッドをインストゥルメントします。 `SendAsync` `GetAsync` `PostAsync` `PutAsync` `DeleteAsync` `GetStringAsync` `GetStreamAsync` `GetByteArrayAsync`
RestSharp	エージェントは、以下のRestSharpメソッドをインストゥルメントします。 `ExecuteTaskAsync` `ExecuteGetTaskAsync` `ExecutePostTaskAsync` `Execute` `ExecuteAsGet` `ExecuteAsPost` `DownloadData` サポートされている最小バージョン：105.2.3 最新の検証済み互換バージョン: 112.1.0 互換性のない既知のバージョン：106.8.0、106.9.0、106.10.0、106.10.1
HttpWebRequest	エージェントは、以下のHttpWebRequestメソッドをインストゥルメントします。 `GetResponse`

ライブラリ

Supported methods

HttpClient

エージェントは、次のHttpClientメソッドをインストゥルメントします。

SendAsync
GetAsync
PostAsync
PutAsync
DeleteAsync
GetStringAsync
GetStreamAsync
GetByteArrayAsync

RestSharp

エージェントは、以下のRestSharpメソッドをインストゥルメントします。

ExecuteTaskAsync
ExecuteGetTaskAsync
ExecutePostTaskAsync
Execute
ExecuteAsGet
ExecuteAsPost
DownloadData
サポートされている最小バージョン：105.2.3
最新の検証済み互換バージョン: 112.1.0
互換性のない既知のバージョン：106.8.0、106.9.0、106.10.0、106.10.1

HttpWebRequest

エージェントは、以下のHttpWebRequestメソッドをインストゥルメントします。

GetResponse

.NETエージェントは、次のLLMフレームワークを自動的にインストゥルメントするように設定できます。

フレームワーク	フレームワークの最小バージョン	エージェントの最小バージョン	最新の検証済み互換バージョン
AWS Bedrock	3.7.200.0	10.23.0 ( `InvokeModelAsync` ) 10.37.0 ( `InvokeModelAsync` 、 `ConverseAsync` )	4.0.0.4
オープンAI	2.0.0	10.37.0 ( `CompleteChat` 、 `CompleteChatAsync` )	2.1.0
Azure.AI.OpenAI	2.0.0	10.37.0 ( `CompleteChat` 、 `CompleteChatAsync` )	2.1.0

フレームワーク	フレームワークの最小バージョン	エージェントの最小バージョン	最新の検証済み互換バージョン
Log4Net	1.2.10	9.7.0	3.0.4
セリロッグ	2.0.0	9.7.0	4.3.0
NLog	4.1.0	9.7.0	5.5.0
Microsoft.Extensions.Logging	3.0.0	9.7.0	9.0.4

エージェントは、以下に示すメッセージシステムを自動的にインストゥルメントします。

ライブラリ	Supported methods
Confluent.Kafka	トピックに基づいて生成し消費します以下のメソッドがインストゥルメントされています。 `IProducer.Produce` `IProducer.ProduceAsync` `IConsumer.Consume` サポートされている最小バージョン：1.4.0 最新の検証済み互換バージョン: 2.10.0
MSMQ	メッセージの送受信、キューのピークとパージ
NServiceBus	メッセージの配置と採用サポートされている最小バージョン：5.0 最新の検証済み互換バージョン: 8.2.4
RabbitMQ	メッセージの配置、採用、およびキューの削除 `IBasicConsumer`を使ってメッセージを受信するときは、`EventingBasicConsumer`が.NETエージェントによってインストゥルメントされる唯一の実装になります。 `BasicGet` はインストゥルメンテーションされますが、エージェントは`BasicGet`のディストリビューティッド（分散）トレーシングをサポートしていません。以下のメソッドがインストゥルメントされています。 `IModel.BasicGet` `IModel.BasicPublish` `IModel.BasicConsume` `IModel.QueuePurge` `EventingBasicConsumer.HandleBasicDeliver` サポートされている最小バージョン：3.5.2 最新の検証済み互換バージョン：6.6.0
MassTransit（エージェントバージョン10.19.0以降）	メッセージの公開/送信と消費サポートされている最小バージョン：7.1.0 最新の検証済み互換バージョン: 8.3.7
AWSSDK.SQS (Amazon Simple Queue Service) (エージェントバージョン 10.27.0 以降)	メッセージの送受信サポートされる最小バージョン: 3.7.0 Latest verified compatible version: 4.0.0.4
AWSSDK.Kinesis (Amazon Kinesis Data Streams) (エージェントバージョン 10.40.0 以降)	オペレーション`PutRecord(s)Async`と`GetRecordsAsync`は、メッセージブローカーのオペレーションとしてインストゥルメントされます。他の Kinesis 操作は、基本的なメソッド呼び出しとしてインストゥルメント化されます。サポートされる最小バージョン: 3.7.0 Latest verified compatible version: 4.0.2.3
AWSSDK.KinesisFirehose (Amazon Kinesis Firehose) (エージェントバージョン 10.40.0 以降)	すべての Kinesis Firehose 操作は、基本的なメソッド呼び出しとしてインストゥルメント化されます。サポートされる最小バージョン: 3.7.0 Latest verified compatible version: 4.0.1.2

リストされている.NET言語とテクノロジーは、インスタントオブザーバビリティダッシュボードと互換性があります。これらの言語やテクノロジーを使用している場合は、New Relicダッシュボードでデータをすぐに表示できます。

言語/テクノロジー	追加設定
アプリケーション	New Relicは、C#で記述されたサービスを自動的にインストゥルメントできます。C#ダッシュボードをインストールするには、C#クイックスタートページに移動します。
ADO.net	アプリケーションがADO.netを使用している場合、ADO.netダッシュボードを生成するNew Relicエージェントの組み合わせをインストールできます。必要な作業は次のとおりです。ガイド付きインストレーションの手順に従って、New Relic APM .NETエージェントとInfrastructureエージェントをインストールします。 nri-perfmonの指示に従って、New RelicインフラストラクチャのMicrosoft Windows Perfmon/WMIオンホストインテグレーションをインストールします。 Perfmonを手動でインストールした場合は、Infrastructureエージェントを再起動します。 ADO.NETをインストールするには、ADO.NETクイックスタートページに移動します。
Blazor Server	New Relicでアプリをインストゥルメントすることで、Blazor Serverダッシュボードで最も重要なデータを追跡できます。 New Relic APM .NETエージェントとInfrastructureエージェントをインストールするには、ガイド付きインストレーションの手順に従ってください。必要に応じて、コマンドラインからInfrastructureエージェントをインストールできます。 Blazorクイックスタートをインストールして、事前構築済みダッシュボードを入手 one.newrelic.comからAPM & servicesに移動し、アプリを選択します。インストレーションが成功したかどうかを確認するには、次のクエリを実行します。 `FROM Transaction SELECT count(*) FACET request.uri` データが表示される場合、アプリは正しくインストゥルメントされています。

言語/テクノロジー

追加設定

アプリケーション

New Relicは、C#で記述されたサービスを自動的にインストゥルメントできます。C#ダッシュボードをインストールするには、C#クイックスタートページに移動します。

ADO.net

アプリケーションがADO.netを使用している場合、ADO.netダッシュボードを生成するNew Relicエージェントの組み合わせをインストールできます。必要な作業は次のとおりです。

ガイド付きインストレーションの手順に従って、New Relic APM .NETエージェントとInfrastructureエージェントをインストールします。
nri-perfmonの指示に従って、New RelicインフラストラクチャのMicrosoft Windows Perfmon/WMIオンホストインテグレーションをインストールします。
Perfmonを手動でインストールした場合は、Infrastructureエージェントを再起動します。
ADO.NETをインストールするには、ADO.NETクイックスタートページに移動します。

Blazor Server

New Relicでアプリをインストゥルメントすることで、Blazor Serverダッシュボードで最も重要なデータを追跡できます。

New Relic APM .NETエージェントとInfrastructureエージェントをインストールするには、ガイド付きインストレーションの手順に従ってください。必要に応じて、コマンドラインからInfrastructureエージェントをインストールできます。
Blazorクイックスタートをインストールして、事前構築済みダッシュボードを入手
one.newrelic.comからAPM & servicesに移動し、アプリを選択します。インストレーションが成功したかどうかを確認するには、次のクエリを実行します。
```
FROM Transaction SELECT count(*) FACET request.uri
```
データが表示される場合、アプリは正しくインストゥルメントされています。

以下のフレームワークは、完全にサポートされていません。

ASP.NET Web API v1: .NET Framework 4.0を対象とするアプリ向けに、New Relicの.NETエージェント5.0以降のASP.NET WebAPI v1を使用する方法については、トラブルシューティング情報を参照してください。（これは.NET Framework 4.5以降には影響しません。）
Mono: New RelicはLinuxで稼働するオープンソースの.NETフレームワークであるMonoをサポートしていません。その理由は、Monoベースの.NETアプリケーションへのプロファイラーとして、.NETエージェントにインジェクションするプロファイラーAPIがないためです。プロファイラーAPIは、コンポーネントオブジェクトモデル（COM）ベースのインタフェースであり、Linuxではサポートされていません。
エージェントは.NET Frameworkベースのアプリしかインストゥルメントできないため、Classic ASPはnot supported。
Sharepointはnot supportedです。

利用できない機能

ジャストインタイム（JIT）コンパイルは.NETエージェント機能の要件であるため、ネイティブイメージジェネレーター（NGEN）で作成されたネイティブイメージは.NETエージェントではサポートされません。

エージェントを他のNew Relic製品に接続

APMに加え、エージェントはエンドツーエンドの可視性を提供するため、他のNew Relic製品とも統合されます。

製品	統合
ブラウザのモニタリング	ASP.NETウェブアプリケーションの場合、自動インストルメンテーションを有効化すると、.NETエージェントは自動的にBrowser JavaScriptエージェントを挿入します。 browserインジェクションを有効にした後、APM概要] ページでブラウザデータを表示し、特定のアプリのデータのとをすばやく切り替えることができます。設定オプションと手動インストゥルメンテーションについては、Browserモニタリングと.NETエージェントを参照してください。
インフラストラクチャのモニタリング	インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIでホストのリストを表示し、Infrastructure UIでAPMアプリ別にホストをフィルタリングできます。詳細については、Infrastructure UIのAPMデータを参照してください。
ダッシュボード	PHPエージェントはNRQLクエリを実行するため、デフォルトのイベントと属性を送信します。高度な分析のために、カスタムイベントを記録することもできます。
合成モニタリング	合成トランザクショントレースは、Syntheticモニターからのリクエストを基盤となるAPMトランザクションに接続します。

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

.NETエージェントの互換性と要件

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

アプリ/ウェブサーバー

AWS Elastic Beanstalk

Microsoft Azure

ネットワーク要件

オペレーティング·システム

権限

プロセッサアーキテクチャー

セキュリティ要件

ターゲットフレームワークのバージョン

自動インストゥルメンテーション

アプリのフレームワーク

データストア

外部呼び出しライブラリ

大規模言語モデル(LLM)

ロギングフレームワーク

メッセージング

利用できない機能

エージェントを他のNew Relic製品に接続

要件

.NET Frameworkのバージョン

アプリケーションの寿命

アプリ/ウェブサーバー

AWS Elastic Beanstalk

CLR

コードアクセスセキュリティ

Microsoft Azure

ネットワーク要件

オペレーティング·システム

権限

プロセッサアーキテクチャー

セキュリティ要件

その他のモニターソフトウェアの使用

自動インストゥルメンテーション

アプリのフレームワーク

バインディングの種類

データストア

CMS

外部呼び出しライブラリ

ホスティングモデル

呼び出しモデル

大規模言語モデル(LLM)

ロギングフレームワーク

メッセージング

ダッシュボード対応.NET言語とテクノロジー

サポートされていないフレームワーク

利用できない機能

エージェントを他のNew Relic製品に接続

要件