New Relicの .NET エージェントは、.NET フレームワークと .NET Core の両方をサポートします。 このドキュメントでは、.NET ランタイム、フレームワーク、ライブラリの互換性とサポートについて説明します。
エージェントには、フレームワーク、データベース、メッセージキューシステムなど、.NETエコシステムで最も人気ある一部のビルトイン・インストゥルメンテーションとメッセージキューシステムが含まれています。エージェントをダウンロードおよびインストール後は、監視下のプロセス内で実行されます。エージェントは個別のプロセスまたはサービスを作成しません。
自動的にインストゥルメントされないフレームワークとライブラリについては、.NETカスタムインストゥルメンテーションを使用してエージェントを拡張できます。
.NETエージェントをお試しになりますか？New Relicアカウントの作成は無料です。クレジットカードは不要です。
要件
Windowsまたは Linuxに、New Relic .NETエージェントをインストールする前に、システムが以下の要件を満たしていることを確認してください。
自動インストゥルメンテーション
アプリケーションが ASP..NET Core でホストされている場合、エージェントは自動的にインストゥルメントされた瞬間を作成します。 .NET エージェントは、インストール後にアプリケーションを自動的にインストゥルメントしました。 アプリが自動的にインストゥルメント化されない場合、またはインストゥルメンテーションを追加したい場合は、カスタムインストゥルメンテーションを使用してください。
利用できない機能
.NETエージェントでは、以下の機能は使用できません。
.NETエージェントは、トリム自己完結型デプロイメントと実行ファイルをサポートしていません。これは、エージェントが依存するアセンブリをコンパイラがトリミングする可能性があるためです。
GRPCの互換性の問題により、Alpine LinuxではInfinite Tracingはサポートされていません。詳細については、「このエージェントの問題」を参照してください。
.NETエージェントでは、エージェントが適切に機能するためにはジャストインタイム（JIT）コンパイルが必要です。このため、.NETアプリケーションのネイティブAhead of Time（AOT）をサポートしていません。
エージェントを他のNew Relic製品に接続
APMに加え、.NETエージェントは他のNew Relic製品と統合し、エンドツーエンドの可視性を提供します。
製品
統合
ASP.NET Core v6.0以降のウェブアプリケーション（MVC、Razor、Blazor）の場合、自動インストゥルメンテーションを有効化すると、.NETエージェント（バージョン10.19.0以降）は自動的にBrowser JavaScriptエージェントを挿入します。
その他の種類のウェブアプリケーションの場合は、.NETエージェントAPIまたはブラウザエージェントのコピー/ペーストメソッドを使用して、 エージェントを挿入できます。
ブラウザインジェクションを有効化後は、APMの概要ページでブラウザデータを表示したり、特定のアプリに対してAPMとブラウザデータを素早く切り替えできます。設定オプションと手動インストゥルメンテーションについては、ブラウザモニタリングと.NETエージェントを参照してください。
インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIにホストのリストを表示し、Infrastructure UIでAPMアプリ別にインフラストラクチャホストをフィルタリングできます。詳細については、Infrastructure UIのAPMデータを参照してください。
PHPエージェントはNRQLクエリを実行するため、デフォルトのイベントと属性を送信します。高度な分析のために、カスタムイベントを記録することもできます。
要件
New Relicの.NETエージェントをインストールする前に、システムが以下の要件を満たしていることを確認します。
自動インストゥルメンテーション
アプリケーションが ASP.NET または完全にサポートされている別のフレームワークでホストされている場合、.NET エージェントはインストール後にアプリケーションを自動的に計装します。 アプリが自動的にインストゥルメント化されない場合、またはインストゥルメンテーションを追加したい場合は、 カスタムインストゥルメンテーションを使用してください。
.NETエージェントは、データストアプロセスを直接モニタリングしません。また、デフォルトでは、クエリトレースの.NET SQLパラメーターキャプチャには、パラメーター化したクエリまたはストアドプロシージャのパラメーターはリストされません。SQLクエリパラメーターの収集は、エージェントの設定で有効になります。
利用できない機能
ジャストインタイム（JIT）コンパイルは.NETエージェント機能の要件であるため、ネイティブイメージジェネレーター（NGEN）で作成されたネイティブイメージは.NETエージェントではサポートされません。
エージェントを他の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トランザクションに接続します。 |