当社の.NETエージェントは、.NET Frameworkと.NET Coreの両方をサポートしています。この文書では、.NET Frameworkアプリケーションの互換性とサポートを説明しています。.NET Coreについては、.NET Coreの互換性および要件 を参照してください。
エージェントには、フレームワーク、データベース、メッセージキューシステムなど、.NETエコシステムで最も人気ある一部のビルトイン・インストゥルメンテーションとメッセージキューシステムが含まれています。エージェントをダウンロードおよびインストール 後は、監視下のプロセス内で実行されます。エージェントは個別のプロセスまたはサービスを作成しません。
自動的にインストゥルメント されないフレームワークとライブラリについては、.NETカスタムインストゥルメンテーション を使用してエージェントを拡張できます。
New Relicの.NETエージェントをお試しになりますか?New Relicアカウントの作成 は無料です。クレジットカードは不要です。
New Relicの.NETエージェントをインストール する前に、システムが以下の要件を満たしていることを確認します。
アプリケーションの寿命 .NETエージェントは、各収集サイクル の終わりにデータをアップロードします（1分間に1回）。.NETアプリがそれほど長く実行されない場合は、newrelic.configファイルでservice elementのsendDataOnExit属性をtrueに設定できます。
アプリ/ウェブサーバー 以下のいずれか1つのアプリ/ウェブサーバーを使用する必要があります。
IIS
セルフホストのOWIN
セルフホストのWCF
Kestrel
KestrelとIISリバースプロキシ（AspNetCoreModule経由）
KestrelとIISリバースプロキシ（AspNetCoreModuleV2経由）
エージェントは、IISにホスティングされているアプリに対してトランザクションを自動的に作成します。WCFとOWINのバージョン3以上でセルフホストする場合も、エージェントはトランザクションを自動的に作成します。他のセルフホストサービスについては、カスタムインストゥルメンテーションを介してトランザクションを作成する 必要があります。
CLR エージェントにはCLRバージョン4.0が必要になります。CLR 2.0で実行しているレガシーアプリケーションは、7.0以下のバージョンのエージェントでインストゥルメントできます。
コードアクセスセキュリティ コードアクセスセキュリティ の使用は、完全信頼が有効になっている場合にのみ.NETエージェントと互換性があります。エージェントには、より制限された信頼レベルとの互換性はありません。
Microsoft Azure Azure固有のインストレーション手順については、以下を参照してください。
.NET Frameworkのバージョン 有効期限（EOL）の通知 Microsoftは、2022年4月26日に、.NET Frameworkバージョン4.5.1、4.5.2、4.6.1のサポート終了を正式に発表しました。
この情報ブログはMicrosoftのブログサイト に掲載されています。公式の製品ライフサイクルの開始日および終了日は、Microsoftのドキュメント でご覧ください。
これらのフレームワークバージョンの.NETエージェントのサポートは、最新の9.x New Relic .NETエージェントで終了します。New Relic .NETエージェントのバージョン10.0以降では、.NETフレームワーク4.6.2以降を対象としています。この移行の簡単な準備方法などの詳細については、サポートフォーラムの投稿 を参照してください。
.NET Framework 4.6.2以上
.NET Framework 4.6.2以上のバージョンには、New Relic .NETエージェントのバージョン7.0以上が必要です。
.NET Framework 4.5.1、4.5.2、および4.6.1
.NET Framework 4.5.1、4.5.2、または4.6.1で実行中のアプリケーションをインストゥルメントするには、New Relic .NETエージェントのバージョンは10.0以下で、7.0以上のバージョンを実行する必要があります。
.NET Framework 4.0以上
.NET Frameworkバージョン4.0以下で実行されている計装アプリケーションをインストゥルメントするには、New Relic .NETエージェントのバージョン7.0以下を実行する必要があります。詳細な情報とダウンロード手順については、.NET frameworks 4.0以下向けの技術サポート を参照してください。
以下に、.NET Frameworkバージョン4.0以下に関する追加詳細を示します。
.NET Frameworkのバージョン
メモ
.NET Framework 2.0
.NET Framework 4.0以上のみ をインストールした場合を除き、インストール済みのその他の.NET Frameworkのバージョンに加えて、ターゲットホストに.NET Frameworkのバージョン3.5もインストールする必要があります 。
.NET Framework 3.0
.NET Framework 4.0以上のみ をインストールした場合を除き、インストール済みのその他の.NET Frameworkのバージョンに加えて、ターゲットホストに.NET Frameworkのバージョン3.5もインストールする必要があります 。
.NET Framework 3.5
.NETエージェントのバージョン7.0以下によって完全にサポートされます。
.NET Framework 4.0
.NETエージェントのバージョン7.0以下によって完全にサポートされます。
ネットワーク要件 このエージェントでは、ファイアウォールが特定のネットワークとポート への発信接続を許可する必要があります。
オペレーティングシステム エージェントには、以下のオペレーティングシステムのいずれか1つが必要です。
Windows Server 2008 Windows Server 2008 R2 Windows Server 2012 Windows Server 2012 R2 Windows Server 2016 Windows Server 2019 Windows Server 2022 Windows 10 Windows 11 Windows Azure （OS Family 1、2、3） Windows 2016上で動作するWindowsコンテナ（NanoServerベースの画像には対応していません） アクセス権限 インストレーションには、昇格された権限（アドミニストレーター）が必要です。たとえば、次のことが可能です。
アドミニストレーターユーザーとしてログイン。
アドミニストレーターグループのメンバーになる。
新しいオペレーティングシステムでプロンプトが表示されたら、昇格した資格情報を入力します。
監視対象のプロセスには、エージェントをインストールするディレクトリへの読み取り/書き込みのアクセス権が必要です。エージェントは監視対象プロセスの一部として実行され、正常に機能するために、これらのアクセス権に依存します。
推奨事項：
newrelic.configファイルに対するアクセス許可を制限し、監視対象プロセスの所有者にのみ読み取り/書き込みアクセス許可を付与します。
アクセス権と特権を保有するユーザー数を最小限に抑えるため、エージェントによって作成されるログのアクセス権限を見直します。
プロセッサアーキテクチャー エージェントは、32ビットと64ビットの両バージョンで使用できます。64ビットのシステムでは、64ビットエージェントで32ビットと64ビットの両方のアプリケーションをインストゥルメントできます。
セキュリティ要件 標準的なデータ収集のセキュリティ対策 として、アプリサーバーはSHA-2（256ビット）をサポートしている必要があります。SHA-1はサポートされていません。
その他のモニターソフトウェアの使用 .NET共通言語ランタイム（CLR）のみが、1つのプロファイラーが任意の時点でプロセスのプロファイリングAPIにアクセスできます。当社の.NETエージェントを他のモニターソフトウェアと一緒に実行すると、プロファイラー競合 が発生します。詳細については、その他のAPMソフトウェアを使用中のエラー を参照してください。
アプリケーションがASP.NETまたは別の完全対応フレームワーク でホスティングされている場合、.NETエージェントはインストール後に、アプリケーションに自動的にインストゥルメントされます。ご利用のアプリが自動的にインストゥルメントされない、またはインストゥルメンテーションの追加を希望する場合は、カスタムインストゥルメンテーション を使用します。
.NETエージェントは、データストアプロセスを直接モニタリングしません。また、デフォルトでは、クエリトレースの.NET SQLパラメーターキャプチャには、パラメーター化したクエリまたはストアドプロシージャのパラメーターはリストされません。SQLクエリパラメーターの収集は、エージェントの設定 で有効になります。
アプリのフレームワーク エージェントは、一部のアプリケーションフレームワークを自動的にインストゥルメントします。このようなフレームワークのことを完全にサポートされている と言います。
互換性ステータス
.NETアプリフレームワーク
完全サポート
以下のフレームワークは、完全にサポートされていません 。
フルサポートではない
以下のフレームワークは、完全にサポートされていません 。
ASP.NET Web API v1 : .NET Framework 4.0をターゲットとするアプリ用に、New Relicの.NET Frameworkエージェント5.0以上のASP.NET Web API v1の使用については、トラブルシューティング情報 を参照してください。（これは.NET Framework 4.5以降には影響しません。）Mono： New RelicはLinuxで稼働するオープンソースの.NETフレームワークであるMono をサポートしていません。その理由は、Monoベースの .NETアプリケーションへのプロファイラーとして、.NETエージェントにインジェクションするプロファイラーAPIがないためです。プロファイラーAPIは、コンポーネントオブジェクトモデル（COM）ベースのインタフェースであり、Linuxではサポートされていません。サポートされていない
エージェントは.NET Frameworkベースのアプリしかインストゥルメントできないため、Classic ASPはサポートされていません 。
Sharepoint には対応していません 。
データストア サポート対象のデータストアにインスタンス詳細 を収集するには、.NETエージェントのバージョン6.5.29.0以上が必要であり、デフォルトで有効化されています。現在リストされてないデータストアからインスタンスレベルの情報をリクエストするには、New Relicサポートセンター でサポートを受けてください。
こうしたデータストアに対する.NET Frameworkアプリケーション呼び出しのパフォーマンスを自動インストゥルメンテーションするには、.NETエージェントのバージョン8.14以上 があることを確認してください。
検証済みの互換性バージョン：4.0.40
既知の非互換性バージョン：4.0.44以降
データストア
インスタンスの詳細
備考
Cosmos DB
.NETエージェントv9.2.0以降では、Microsoft.Azure.Cosmos ライブラリを自動的にインストゥルメントします。
サポートされている最小バージョン：3.17.0 検証済みの互換性バージョン：3.17.0、3.23.0 Couchbase
CouchbaseNetClient を使用します。
サポートされている最小バージョン：2.0.0
検証済みの互換性バージョン：2.3.8
既知の非互換性バージョン：2.4.0以降
Couchbaseの場合、以下の項目はデフォルトでインストゥルメントされません。その理由は、これらに相当するマルチドキュメントが優先されるためです。
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.4.0、4.6.1、4.7.0、4.8.4
Microsoft.Data.SqlClient
サポート対象の最小バージョン：1.0.19239.1
検証済みの互換バージョン：1.0.19239.1、2.1.5、3.1.1、4.1.1、5.0.1
System.Data
サポート対象の最小バージョン：.NET Framework 4.6.2
検証済みの互換バージョン：.NET Framework 4.6.2、4.7.1、4.8
MongoDB（レガシードライバー）
サポートされている最小バージョン：1.10.0
検証済みの互換性バージョン：1.10.0
既知の非互換性バージョン：インスタンスの詳細はバージョン2未満では利用できません。
MongoDB（最新ドライバー）
サポートされている最小バージョン：2.3.0
検証済みの互換性バージョン：2.3.0、2.8.1、2.13.1、2.14.1、2.17.1、2.19.0
既知の非互換性バージョン：2.7以降で追加された新しいメソッドは現在インストゥルメントされていません。
MySQL
MySql.Data またはMySQLコネクター の使用
MySql.Data
Oracle
PostgreSQL
Npgsql の使用
ServiceStack.Redis
StackExchange.Redis
サポートされている最小バージョン：1.0.488 検証済みの互換性バージョン：1.0.488、1.1.608、1.2.6, 2.0.601、2.1.58、2.2.88、2.6.66
CMS エージェントは、EPiServer コンテンツマネジメントシステムを自動的にインストゥルメントします。
外部呼び出しライブラリ エージェントは、以下の外部呼び出しライブラリを自動的にインストゥルメントします。
ライブラリ
サポート対象のメソッド
HttpClient
エージェントは、次のHttpClientメソッドをインストゥルメントします。
SendAsyncGetAsyncPostAsyncPutAsyncDeleteAsyncGetStringAsyncGetStreamAsyncGetByteArrayAsyncRestSharp
エージェントは、以下のRestSharpメソッドをインストゥルメントします。
HttpWebRequest
エージェントは、以下のHttpWebRequestメソッドをインストゥルメントします。
ロギングフレームワーク .NETエージェントは、エージェントの転送 とローカルログ装飾 を使用して、自動ログインコンテキストのロギングフレームワークを自動的にインストゥルメントするように設定できます 。
フレームワーク
サポートされている最小バージョン
検証済みの互換性バージョン
Log4Net
1.2.10
1.2.10、2.0.5、2.0.14
Serilog
1.0.0
1.5.14、2.5.0、2.10.0
NLog
4.0.0
4.1.2、4.3.11、4.5.11
メッセージング エージェントは、以下に示すメッセージシステムを自動的にインストゥルメントします。
ライブラリ
サポート対象のメソッド
MSMQ
NServiceBus
メッセージの配置と採用 サポートされている最小バージョン：5.0 RabbitMQ
メッセージの配置、採用、およびキューの削除
IBasicConsumerを使ってメッセージを受信するときは、EventingBasicConsumerが.NETエージェントによってインストゥルメントされる唯一の実装になります。
BasicGet はインストゥルメンテーションされますが、エージェントはBasicGetのディストリビューティッド（分散）トレーシング をサポートしていません。
以下のメソッドがインストゥルメントされています。
IModel.BasicGetIModel.BasicPublishIModel.BasicComsumeIModel.QueuePurgeEventingBasicConsumer.HandleBasicDeliverサポートされている最小バージョン：3.5.2
検証済みの互換性バージョン：3.5.2、5.1.0、6.2.1、3.6.9、4.1.3、5.2.0、6.0.0、6.2.1、6.4.0
ダッシュボード対応.NET言語とテクノロジー リストされている.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
データが表示される場合、アプリは正しくインストゥルメントされています。
APM に加え、エージェントはエンドツーエンドの可視性を提供するため、他のNew Relic製品とも統合されます。