当社の.NETエージェントは、.NET Frameworkと.NET Coreの両方をサポートしています。この文書では、.NET Frameworkアプリケーションの互換性とサポートを説明しています。.NET Coreについては、.NET Coreの互換性および要件を参照してください。
エージェントには、フレームワーク、データベース、メッセージキューシステムなど、.NETエコシステムで最も人気ある一部のビルトイン・インストゥルメンテーションとメッセージキューシステムが含まれています。エージェントをダウンロードおよびインストール後は、監視下のプロセス内で実行されます。エージェントは個別のプロセスまたはサービスを作成しません。
自動的にインストゥルメントされないフレームワークとライブラリについては、.NETカスタムインストゥルメンテーションを使用してエージェントを拡張できます。
New Relicの.NETエージェントをお試しになりますか?New Relicアカウントの作成は無料です。クレジットカードは不要です。
要件
New Relicの.NETエージェントをインストールする前に、システムが以下の要件を満たしていることを確認します。
有効期限(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 or higher
.NET Framework 4.6.2以上のバージョンには、New Relic .NETエージェントのバージョン7.0以上が必要です。
.NET Framework 4.5.1, 4.5.2, and 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 or lower
.NET Frameworkバージョン4.0以下で実行されている計装アプリケーションをインストゥルメントするには、New Relic .NETエージェントのバージョン7.0以下を実行する必要があります。詳細な情報とダウンロード手順については、.NET frameworks 4.0以下向けの技術サポートを参照してください。
以下に、.NET Frameworkバージョン4.0以下に関する追加詳細を示します。
.NET Frameworkのバージョン | メモ |
---|---|
.NET Framework 2.0 | only .NET Framework 4.0以降をインストールした場合を除き、 mustインストール済みのその他の.NET Frameworkのバージョンに加えて、ターゲットホストに.NET Frameworkのバージョン3.5もインストールする必要があります。 |
.NET Framework 3.0 | only .NET Framework 4.0以降をインストールした場合を除き、 mustインストール済みのその他の.NET Frameworkのバージョンに加えて、ターゲットホストに.NET Frameworkのバージョン3.5もインストールする必要があります。 |
.NET Framework 3.5 | .NETエージェントのバージョン7.0以下によって完全にサポートされます。 |
.NET Framework 4.0 | .NETエージェントのバージョン7.0以下によって完全にサポートされます。 |
.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固有のインストレーション手順については、以下を参照してください。
このエージェントでは、ファイアウォールが特定のネットワークとポートへの発信接続を許可する必要があります。
エージェントには、以下のオペレーティングシステムのいずれか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ベースの画像には対応していません)
インストレーションには、昇格された権限(アドミニストレーター)が必要です。たとえば、次のことが可能です。
アドミニストレーターユーザーとしてログイン。
アドミニストレーターグループのメンバーになる。
新しいオペレーティングシステムでプロンプトが表示されたら、昇格した資格情報を入力します。
監視対象のプロセスには、エージェントをインストールするディレクトリへの読み取り/書き込みのアクセス権が必要です。エージェントは監視対象プロセスの一部として実行され、正常に機能するために、これらのアクセス権に依存します。
Recommendation:
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クエリパラメーターの収集は、エージェントの設定で有効になります。
エージェントは、一部のアプリケーションフレームワークを自動的にインストゥルメントします。このようなフレームワークのことをfully supportedと言います。
Compatibility status | .NET app frameworks | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
完全サポート | これらのフレームワーク are fully supported:
| |||||||||||||||||||||
フルサポートではない | これらのフレームワークは not fully supported:
| |||||||||||||||||||||
サポートされていない | エージェントは.NET Frameworkベースのアプリしかインストゥルメントできないため、Classic ASPはnot supported。 Sharepointはnot supportedです。 |
サポート対象のデータストアにインスタンス詳細を収集するには、.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、4.8.5、4.8.6
Microsoft.Data.SqlClient
サポート対象の最小バージョン:1.0.19239.1
検証済みの互換性バージョン:1.0.19239.1、 2.1.5、 3.1.1、 4.1.1、 5.0.1、5.1.1、 5.2.0
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.20.0、 2.21.0、2.22.0、 2.23.0、2.23.1。 2.24.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
検証済みの互換性バージョン:6.10.7、8.0.15、8.0.30、8.0.33、8.1.0、8.2.0、8.3.0
MySqlConnector
サポートされている最小バージョン:1.0.1
検証済みの互換性バージョン:1.0.1、1.3.13、2.1.2、2.3.1、2.3.3、2.3.5
Oracle
PostgreSQL
Npgsqlの使用
サポートされている最小バージョン:4.0.0
検証済みの互換性バージョン:4.0.5
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、 2.6.116、 2.7.4、 2.7.10、2.7.17、2.7.33
Elasticsearch
Elastic.Clients.Elasticsearch 、NEST、またはElasticsearch.Netを使用します。
Elastic.Clients.Elasticsearch
サポートされている最小バージョン:8.0.0
確認済みの互換性バージョン: 8.0.0、8.1.0、8.1.1、8.9.1、8.9.2、8.9.3、8.10.0、8.11.0、8.12.0
バージョン8.10.0以降は、.NETエージェントv10.20.1以降でサポートされます。
NEST
サポートされている最小バージョン:7.0.0
検証済みの互換性バージョン:7.0.0、7.17.5
Elasticsearch.Net
サポートされている最小バージョン:7.0.0
検証済みの互換性バージョン:7.0.0、7.17.5
エージェントは、EPiServerコンテンツマネジメントシステムを自動的にインストゥルメントします。
エージェントは、以下の外部呼び出しライブラリを自動的にインストゥルメントします。
ライブラリ | Supported methods |
---|---|
HttpClient | エージェントは、次のHttpClientメソッドをインストゥルメントします。
|
RestSharp | エージェントは、以下のRestSharpメソッドをインストゥルメントします。
|
HttpWebRequest | エージェントは、以下のHttpWebRequestメソッドをインストゥルメントします。
|
.NETエージェントは、エージェントの転送とローカルログ装飾を使用して、自動ログインコンテキストのロギングフレームワークを自動的にインストゥルメントするように設定できます。
フレームワーク | フレームワークの最小バージョン | エージェントの最小バージョン | 検証済みの互換性バージョン |
---|---|---|---|
Log4Net | 1.2.10 | 9.7.0 | 1.2.10、2.0.5、2.0.14、2.0.16 |
Serilog | 2.0.0 | 9.7.0 | 1.5.14、2.5.0、2.10.0、3.0.1、3.1.1 |
NLog | 4.1.0 | 9.7.0 | 4.1.2、4.3.11、4.5.11、5.2.0、5.2.2、5.2.3、5.2.4、5.2.5、5.2.6、5.2.7、5.2.8 |
Microsoft.Extensions.Logging | 3.0.0 | 9.7.0 |
エージェントは、以下に示すメッセージシステムを自動的にインストゥルメントします。
ライブラリ | Supported methods |
---|---|
Confluent.Kafka |
|
MSMQ |
|
NServiceBus |
|
RabbitMQ |
|
MassTransit(エージェントバージョン10.19.0以降) |
|
リストされている.NET言語とテクノロジーは、インスタントオブザーバビリティダッシュボードと互換性があります。これらの言語やテクノロジーを使用している場合は、New Relicダッシュボードでデータをすぐに表示できます。
言語/テクノロジー | 追加設定 |
---|---|
アプリケーション | New Relicは、C#で記述されたサービスを自動的にインストゥルメントできます。C#ダッシュボードをインストールするには、C#クイックスタートページに移動します。 |
ADO.net | アプリケーションがADO.netを使用している場合、ADO.netダッシュボードを生成するNew Relicエージェントの組み合わせをインストールできます。必要な作業は次のとおりです。
|
Blazor Server | New Relicでアプリをインストゥルメントすることで、Blazor Serverダッシュボードで最も重要なデータを追跡できます。
|
.NETエージェントは、次のLLMフレームワークを自動的にインストゥルメントするように設定できます。
フレームワーク | フレームワークの最小バージョン | エージェントの最小バージョン | 検証済みの互換性バージョン |
---|---|---|---|
AWS Bedrock | 3.7.200.0 | 10.23.0 | 3.7.200.0、 3.7.301.45 |
エージェントを他の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トランザクションに接続します。 |