.NET エージェントを使用すると、Web ページにインストゥルメンテーションを追加できます。 .NET エージェントでbrowserを使用する前に、 .NET エージェントのリリース ノートを参照し、最新の .NET エージェント リリースがインストールされていることを確認してください。
.NET エージェントの要件 から ブラウザモニタリングのインストール に従います。その後、このドキュメントの手順に従って、.NET エージェントを手動でインスツルメンテーションします。
オートインストルメント
重要
自動インストゥルメントは、.NET フレームワーク Web アプリおよび ..NET Core v6.0 以降の Web アプリでのみ使用できます。 ASP.NET Core v5.0 以前のアプリケーションでは、.NET エージェントによって監視されている場合でも、自動インストゥルメントは使用できません。
browser自動インストゥルメンテーションを使用すると、.NET エージェントは、content-type が text/html であり、ページ内に <head> タグも含まれるすべてのページにbrowser JavaScript ヘッダーを自動的に挿入します。 browser自動インストゥルメントは、 .NET フレームワーク Web アプリでは既定で有効になっていますが、..NET Core v6 以降の Web アプリでは既定で無効になっています。 詳細については、「.NET Core v6+ の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 スニペットの正確な配置を制御できます。 コピー/貼り付けによるブラウザ監視を有効にする手順については、 ブラウザのドキュメントを参照してください。
計装の無効化
インストゥルメンテーションを無効にするには
トラブルシューティング
ブラウザのタイミングデータが表示されない場合は、トラブルシューティングの手順に従ってください 。
.NET Core v6+ Web アプリケーションのbrowser自動インストレーションを有効にする
.NET Core v6+ Web アプリでbrowser自動インストゥルメントを有効にするには (.NET エージェント v10.19.2 以降が必要):
newrelic.configを編集し、browserMonitoringautoInstrumentフラグをtrueに設定して、自動インストゥルメンテーションがグローバルに有効になっていることを確認します。<!-- enable auto instrumentation globally --><browserMonitoring autoInstrument="true"/>newrelic.configを編集し、appSettingsセクションに新しい項目を追加して (または、appSettingsセクションが存在しない場合は追加して)、..NET Core 6+ Web アプリの自動インストゥルメンテーションを有効にします - これは、web.configファイルのappSettingsセクションと同じではないことに注意してください。<!-- enable .NET Core 6+ instrumentation --><appSettings><add key="EnableAspNetCore6PlusBrowserInjection" value="true" /></appSettings>
Web アプリケーションとの互換性を確認するために、この機能を本番環境以外の環境で徹底的にテストすることをお勧めします。 この機能に関して問題が発生した場合は、サポートにお問い合わせください。