要件 New Relicの.NETエージェントをインストール する前に、システムが以下の要件を満たしていることを確認します。
.NET Frameworkのバージョン .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以上でセルフホストする場合も、エージェントはトランザクションを自動的に作成します。他のセルフホストサービスについては、カスタムインストゥルメンテーションを介してトランザクションを作成する 必要があります。
CLR エージェントにはCLRバージョン4.0が必要になります。CLR 2.0で実行しているレガシーアプリケーションは、7.0以下のバージョンのエージェントでインストゥルメントできます。
コードアクセスセキュリティ コードアクセスセキュリティ の使用は、完全信頼が有効になっている場合にのみ.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ソフトウェアを使用中のエラー を参照してください。
自動インストゥルメンテーション アプリケーションが 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以上 があることを確認してください。
最新の検証済み互換バージョン: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
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 の使用
ServiceStack.Redis
StackExchange.Redis
サポートされている最小バージョン:1.0.488 最新の検証済み互換バージョン: 2.8.16 Elasticsearch
Elastic.Clients.Elasticsearch 、NEST 、またはElasticsearch.Net を使用します。
Elastic.Clients.Elasticsearch
CMS エージェントは、EPiServer コンテンツマネジメントシステムを自動的にインストゥルメントします。
外部呼び出しライブラリ エージェントは、以下の外部呼び出しライブラリを自動的にインストゥルメントします。
ライブラリ
Supported methods
HttpClient
エージェントは、次のHttpClientメソッドをインストゥルメントします。
SendAsync
GetAsync
PostAsync
PutAsync
DeleteAsync
GetStringAsync
GetStreamAsync
GetByteArrayAsync
RestSharp
エージェントは、以下のRestSharpメソッドをインストゥルメントします。
HttpWebRequest
エージェントは、以下のHttpWebRequestメソッドをインストゥルメントします。
ホスティングモデル 次のホスティング モデルが完全にサポートされています。
ホストされたIIS(ASP互換性あり/なし) セルフホスト 呼び出しモデル 次の呼び出し方法 (クライアントとサービスの両方) がサポートされています。
同期 非同期処理モデル(APM)の開始/終了 タスク非同期処理(TAP) イベントベースの非同期処理 (EAP、クライアント サポートのみ) 大規模言語モデル(LLM) .NETエージェントは、次のLLMフレームワークを自動的にインストゥルメントするように設定できます 。
フレームワーク
フレームワークの最小バージョン
エージェントの最小バージョン
最新の検証済み互換バージョン
AWS Bedrock
3.7.200.0
10.23.0
3.7.403.4
ロギングフレームワーク .NETエージェントは、エージェントの転送 とローカルログ装飾 を使用して、自動ログインコンテキストのロギングフレームワークを自動的にインストゥルメントするように設定できます 。
フレームワーク
フレームワークの最小バージョン
エージェントの最小バージョン
最新の検証済み互換バージョン
Log4Net
1.2.10
9.7.0
2.0.16
セリロッグ
2.0.0
9.7.0
3.1.1
NLog
4.1.0
9.7.0
5.3.2
Microsoft.Extensions.Logging
3.0.0
9.7.0
メッセージング エージェントは、以下に示すメッセージシステムを自動的にインストゥルメントします。
ライブラリ
Supported methods
Confluent.Kafka
トピックに基づいて生成し消費します
以下のメソッドがインストゥルメントされています。
IProducer.Produce
IProducer.ProduceAsync
IConsumer.Consume
サポートされている最小バージョン:1.4.0
最新の検証済み互換バージョン: 2.5.3
MSMQ
NServiceBus
メッセージの配置と採用
サポートされている最小バージョン:5.0
RabbitMQ
MassTransit(エージェントバージョン10.19.0以降)
メッセージの公開/送信と消費
サポートされている最小バージョン:7.1.0
最新の検証済み互換バージョン:8.1.1
AWSSDK.SQS (Amazon Simple Queue Service) (エージェント バージョン 10.27.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
データが表示される場合、アプリは正しくインストゥルメントされています。
サポートされていないフレームワーク 以下のフレームワークは、完全にサポートされていません 。
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エージェントではサポートされません。
APM に加え、エージェントはエンドツーエンドの可視性を提供するため、他のNew Relic製品とも統合されます。