.NET エージェントを使用すると、Web ページにインストゥルメンテーションを追加できます。 .NET エージェントでbrowserを使用する前に、 .NET エージェントのリリース ノートを参照し、最新の .NET エージェント リリースがインストールされていることを確認してください。
.NET エージェントの要件 から ブラウザモニタリングのインストール に従います。その後、このドキュメントの手順に従って、.NET エージェントを手動でインスツルメンテーションします。
オートインストルメント
重要
自動インストゥルメントは、.NET フレームワーク Web アプリおよび ..NET Core v6.0 以降の Web アプリでのみ使用できます。 ASP.NET Core v5.0 以前のアプリケーションでは、.NET エージェントによって監視されている場合でも、自動インストゥルメントは使用できません。
ブラウザーの自動インストゥルメンテーションを使用すると、.NET エージェントは、 content-typeがtext/htmlであり、ページ内に<head>タグもあるページにブラウザーの JavaScript ヘッダーを自動的に挿入します。 Browser自動インストゥルメンテーションはデフォルトで有効になっています。
<head>タグの検索はDOMの先頭から始まります。 .NETエージェントは、コンテンツをユーザーにストリーミングする前に、HTTP応答フィルターを使用してページを変更するHttpModuleを追加することでJavaScriptヘッダーを挿入します。
初めて自動計測を有効にするときは、aspxページが再コンパイルされるように、 asp.netキャッシュディレクトリをクリーンアップする必要がある場合があります。次のコマンドを使用します。
$flush_dotnet_temp.cmdこのインジェクションでは、 content-typeが正しく設定されていない場合、以前は機能していたページが機能しなくなる可能性があります。 修正するには、アプリ内のcontent-typesを確認して更新するか、 自動インストゥルメンテーションを無効にします。
エージェントAPIによる手動での計測
自動計測を有効にできない場合でも、New Relic .NET エージェント API を使用し、ページ内に適切なコードを含めることで、ブラウザエージェントを手動で組み込むことができます。
NewRelic.Api.Agent.dllをダウンロードするには、インストールを再実行して.dllを参照してください。- New Relic .NET エージェント ディレクトリから、 New Relic.Netエージェント セクションを選択し、 API Assemblyを選択します。
- NuGet:
Install-package NewRelic.Agent.Apiを実行して.dllインストールし、参照します。
New Relic .NET エージェント API を呼び出すように Web アプリケーションを設定するには、プロジェクトに
NewRelic.Api.Agent.dllへの参照を追加します。オプション: Web サーバーにデプロイされたアプリケーション ディレクトリを変更する場合は、
NewRelic.Api.Agent.dllアプリケーションのbinディレクトリにコピーします。<head>タグでAPIを呼び出します。X-UA-COMPATIBLE http-equiv属性のメタタグが存在する場合は、そのメタタグの後に設定します。
コピー/ペーストによる手動インストゥルメンテーション
ブラウザ監視を有効にすると、アプリの Web ページに JavaScript スニペットを手動で挿入できます。 コピー/貼り付けオプションを使用すると、Web ページのパフォーマンスを監視するために必要な JavaScript スニペットの正確な配置を制御できます。 コピー/貼り付けによるブラウザ監視を有効にする手順については、 ブラウザのドキュメントを参照してください。
計装の無効化
インストゥルメンテーションを無効にするには