New Relicの.NETエージェントは、.NET Frameworkと.NET Coreの両方をサポートしています。本文書では、.NET Coreアプリケーションの互換性とサポートを説明します。.NET Frameworkアプリケーションについては、.NET Frameworkの互換性および要件を参照してください。
New Relicの.NETエージェントには、フレームワーク、データベース、メッセージキューシステムなど、.NET Coreエコシステムで最も人気ある一部のビルトイン・インストゥルメンテーションが含まれています。
インストレーション後、エージェントは監視下のプロセス内で実行され、エージェントが作成する別のプロセスやサービスはありません。
追加設定なしで自動的にインストゥルメントされていないフレームワークとライブラリについては、.NETカスタムインストゥルメンテーションでエージェントを拡張できます。
.NETエージェントをお試しになりますか？New Relicアカウントの作成は無料です。クレジットカードは不要です。
要件
Windowsまたは Linuxに、New Relic .NETエージェントをインストールする前に、システムが以下の要件を満たしていることを確認してください。
.NET エージェントは、.NET Core バージョン 2.0、2.1、2.2、3.0、3.1、および .NET 5.0 をサポートしています。
.NETCoreバージョンごとに最低限必要なエージェントバージョンの表
.NETCoreバージョン | 最低限必要な.NETエージェントバージョン |
|---|
.NET Core 2.0 | >= 8.19.353.0 |
.NET Core 2.1 | >= 8.19.353.0 |
.NET Core 2.2 | >= 8.19.353.0 |
.NET Core 3.0 | >= 8.21.34.0 |
.NET Core 3.1 | >= 8.21.34.0 |
.NET 5.0 | >= 8.35.0 |
エージェントは、.NET Coreバージョン1.0または1.1と互換性はありません。エージェントは、階層型コンパイルが有効化された.NET Core 2.1以上のアプリケーションの階層型コンパイルを無効化します。.NET Core 2.1のサポートには、.NET Coreランタイム2.1.3 および.NET Core SDK 2.1.401 、または.NET CoreプロファイリングAPIのバグにより、それ以降が必要です。
.NET エージェントがサポートしているのは、.NET Core 2.0、2.1、2.2、3.0、3.1およびNET 5.0をターゲットとするアプリケーションのみです。ターゲットフレームワークは、.csprojファイルにあります。
サポート:
<TargetFramework>netcoreapp2.0</TargetFramework>
<TargetFramework>netcoreapp2.1</TargetFramework>
<TargetFramework>netcoreapp2.2</TargetFramework>
<TargetFramework>netcoreapp3.0</TargetFramework>
<TargetFramework>netcoreapp3.1</TargetFramework>
<TargetFramework>net5.0</TargetFramework>
非サポート:
<TargetFramework>net452</TargetFramework>
重要
.NET FrameworkをターゲットにしているASP.NET Coreアプリケーションをモニターする場合は、.NETエージェントのインストールの.NET Frameworkサポートが有効化されていることを確認してください。
以下のアプリケーション/ウェブサーバーのいずれかを使用してください。
- Kestrel
- KestrelとIISリバースプロキシ（AspNetCoreModule経由）
- KestrelとIISリバースプロキシ（AspNetCoreModuleV2経由）
- KestrelとNginxリバースプロキシ
- KestrelとApacheリバースプロキシ
このエージェントは、以下のオペレーティングシステムでの動作を確認済みです。
オペレーティングシステム | サポート対象バージョン |
|---|
Windows（32ビットおよび64ビットのIntel互換アーキテクチャー） | - Server 2008 R2 SP1
- Server 2012
- Server 2012 R2
- Server 2016
- Server 2019
- Server 2016上で動作するWindowsコンテナ（NanoServerベースの画像には対応していません）
|
Linux（64ビットIntel互換のみ） | .NET Core 2.0+/.NET 5ランタイムがサポートするすべてのx64 Linuxの販売は、.NET Coreエージェントによってサポートされています。完全なリストについては、使用しているランタイムのバージョンに関するMicrosoftのドキュメントを参照してください。 |
Azure固有のインストレーション手順については、以下を参照してください。
エージェントは、32ビット（x86）と64ビット（x64）の両バージョンのWindowsの他、64ビット（x64）のLinuxでも利用できます。
.NETエージェントのインストールと実行には、以下の許可が必要です。
コンポーネント | 必要な許可 |
|---|
エージェントのインストール | エージェントをインストールするプロセスまたはユーザーには、環境変数を設定し、エージェントがインストールされたディレクトリへの書き込みアクセスを設定するために、十分な許可が必要です。 |
エージェントの実行 | 監視中のプロセスには、エージェントをインストールしたディレクトリへの読み取り/書き込みアクセス権が必要です。エージェントは監視対象プロセスの一部として実行され、正常に機能するために、これらの許可に依存します。 リバースプロキシ経由でIISを使用するアプリケーションには、グループIIS_IUSRSがよく使用されます。 |
標準的な データ収集のセキュリティ対策として、アプリサーバーはSHA-2（256ビット）をサポートしている必要があります。SHA-1はサポートされていません。
このエージェントでは、ファイアウォールが特定のネットワークとポートへの発信接続を許可する必要があります。
自動インストゥルメンテーション
アプリケーションがASP.NET Coreでホスティングされる場合、エージェントはトランザクションを自動的に作成してインストゥルメントします。.NETエージェントはインストール後、自動的にアプリケーションをインストゥルメントします。ご利用のアプリが自動的にインストゥルメントされない、またはインストゥルメンテーションの追加を希望する場合は、カスタムインストゥルメンテーションを使用します。
.NET Coreエージェントは、以下のアプリケーションを自動的にインストゥルメントします。
- ASP.NET Core MVC 2.0、2.1、2.2、3.0、3.1、および 5.0（Web API を含む）
.NETエージェントは、以下のデータストアへの .NETアプリケーション呼び出しのパフォーマンスを自動的にインストゥルメントします。
データストア | インスタンスの詳細 | メモ |
|---|
Microsoft SQL Server | | System.Data.SqlClientバージョン4.3.1またはMicrosoft.Data.SqlClientを使用します。 |
PostgresSQL | | Use Npgsql 4.0を使用。 Npgsqlの旧バージョンもインストゥルメントできますが、重複および/または不足メトリクスが発生する場合があります。 |
MongoDB | | ドライババージョン2.3.x、2.4.x、2.5.x、または2.6.xを使用。 ドライババージョン2.7.x：.NETエージェントは、ドライババージョン2.7により導入されたAPIメソッドをサポートしていませんが、以前のバージョンの既存のメソッドはサポートしています。 |
MySQL | | MySql.Dataバージョン6.10.4以上またはMySQL Connectorの使用 |
StackExchange.Redis | | |
.NETエージェントは、データストアプロセスを直接モニターしません。また、デフォルトでは、クエリのトレースでキャプチャされた.NET SQLパラメーターには、パラメーター化したクエリやストアドプロシージャのパラメーターはリストされません。
サポート対象のデータストアに対するインスタンス詳細の収集は、デフォルトで有効になっています。現在リストされてないデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comでサポートを受けてください。
.NETエージェントは、以下の外部呼び出しライブラリを自動的にインストゥルメントします。
ライブラリ | サポート対象のメソッド |
|---|
HttpClient | エージェントは、次のHttpClientメソッドをインストゥルメントします。 SendAsyncGetAsyncPostAsyncPutAsyncDeleteAsyncGetStringAsyncGetStreamAsyncGetByteArrayAsync
|
エージェントは、以下に示すメッセージシステムを自動的にインストゥルメントします。
RabbitMQ 5.1.0 以降：
利用できない機能
.NETエージェントでは、以下の機能は使用できません。
APMに加え、.NETエージェントは他のNew Relic製品と統合し、エンドツーエンドの可視性を提供します。
その他のヘルプ
さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください：