.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

.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以上でセルフホストする場合も、エージェントはトランザクションを自動的に作成します。他のセルフホストサービスについては、カスタムインストゥルメンテーションを介してトランザクションを作成する必要があります。

AWS Elastic Beanstalkは、サポート対象の.NET環境ではありません。

エージェントにはCLRバージョン4.0が必要になります。CLR 2.0で実行しているレガシーアプリケーションは、7.0以下のバージョンのエージェントでインストゥルメントできます。

コードアクセスセキュリティの使用は、完全信頼が有効になっている場合にのみ.NETエージェントと互換性があります。エージェントには、より制限された信頼レベルとの互換性はありません。

Azure 固有のインストレーション手順については、 「.NET インストレーション ガイド」を参照してください。

このエージェントでは、ファイアウォールが特定のネットワークとポートへの発信接続を許可する必要があります。

エージェントには、以下のオペレーティングシステムのいずれか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ファイルに対するアクセス許可を制限し、監視対象プロセスの所有者にのみ読み取り/書き込みアクセス許可を付与します。

• アクセス権と特権を保有するユーザー数を最小限に抑えるため、エージェントによって作成されるログのアクセス権限を見直します。

エージェントは、32ビットと64ビットの両バージョンで使用できます。64ビットのシステムでは、64ビットエージェントで32ビットと64ビットの両方のアプリケーションをインストゥルメントできます。

標準的なデータ収集のセキュリティ対策として、アプリサーバーはSHA-2（256ビット）をサポートしている必要があります。SHA-1はサポートされていません。

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

エージェントは自動的にいくつかのアプリケーション フレームワークをインストゥルメントされました。これらのフレームワークを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) では、さまざまなレベルのサポートが利用可能です。

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

サポート対象のデータストアにインスタンス詳細を収集するには、.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.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.8.6 Microsoft.Data.SqlClient サポート対象の最小バージョン：1.0.19239.1 最新の検証済み互換バージョン：5.2.1 System.Data サポート対象の最小バージョン：.NET Framework 4.6.2 最新の検証済み互換バージョン：4.8
  MongoDB（レガシードライバー）		サポートされている最小バージョン：1.10.0 最新の検証済み互換バージョン：1.10.0 既知の非互換性バージョン：インスタンスの詳細はバージョン2未満では利用できません。
  MongoDB（最新ドライバー）		サポートされている最小バージョン：2.3.0 最新の検証済み互換バージョン：2.26.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 最新の検証済み互換バージョン：8.4.0 MySqlConnector サポートされている最小バージョン：1.0.1 最新の検証済み互換バージョン：2.3.6
  Oracle		Oracle.ManagedDataAccessを使用する サポートされる最小バージョン: 12.1.2400 最新の検証済み互換バージョン: 23.5.1
  PostgreSQL		Npgsqlの使用 サポートされている最小バージョン：4.0.0 最新の検証済み互換バージョン：4.0.5 Npgsqlの旧バージョンもインストゥルメントできますが、重複および/または不足メトリクスが発生する場合があります。
  ServiceStack.Redis
  StackExchange.Redis		サポートされている最小バージョン：1.0.488 最新の検証済み互換バージョン：2.7.33
  Elasticsearch		Elastic.Clients.Elasticsearch 、NEST、またはElasticsearch.Netを使用します。 Elastic.Clients.Elasticsearch サポートされている最小バージョン：8.0.0 最新の検証済み互換バージョン：8.14.6 バージョン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

エージェントは、EPiServerコンテンツマネジメントシステムを自動的にインストゥルメントします。

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

次のホスティング モデルが完全にサポートされています。

• ホストされたIIS（ASP互換性あり/なし）
• セルフホスト

次の呼び出し方法 (クライアントとサービスの両方) がサポートされています。

• 同期
• 非同期処理モデル（APM）の開始/終了
• タスク非同期処理（TAP）
• イベントベースの非同期処理 (EAP、クライアント サポートのみ)

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

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

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

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

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

• 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です。