Browserエージェントのインストール

を開始するには、監視対象ビューのHTMLにBrowserエージェントを追加します。Browserエージェントは、サイトのパフォーマンスを監視し、そのデータをNew Relicに送信する、JavaScriptコードのスニペットです。

開始する前に

まだ確認していない場合は、お使いのブラウザアプリが当社の互換性要件を満たしているかご確認ください。

Browserエージェントをインストールするには、次の4つの方法があります。特定のニーズに応じて、以下を実行できます。

one.newrelic.com > Integrations & Agents > Browser and mobile > Browser monitoringに移動し、指示に従って、UIでブラウザ用のnpmスニペットを生成します。

スニペットを取得したら、ソースファイルの最初の行（他のコードの前）に貼り付けます。これにより、他のスクリプトが実行される前に、Browserエージェントが確実に読み込まれます。

one.newrelic.com > Integrations & Agents > Browser and mobile > Browser monitoringに移動し、指示に従って、UIでJavaScriptスニペットを生成します。

スニペットを取得したら、それを<head>タグのできるだけ先頭近く、ただし位置に依存するMETAタグ（ X-UA-Compatibleやcharsetなど）の後に貼り付けます。

スニペットの配置に関する詳細については、JavaScriptの配置要件を参照してください。

インスタンス化が遅れると、エージェントが完全にロードされて初期化されるまでの情報が失われます。これらのスクリプトの実行順序により、ページビューの開始時からインストゥルメンテーションのデータがいくらか失われます。

パフォーマンスやその他の理由により、Browserエージェントの初期化をページ読み込みサイクルの開始から遅らせたい場合があります。エージェントが完全に初期化されるまで、newrelic API は使用できません。この遅延により、ブラウザ監視UIにも不完全なデータが作成されます。

エージェントが完全に初期化されると、期待どおりに動作します。遅延は、エージェントがグローバルをラップするとき、または取得データに影響を与える他のライブラリやコードに関連するイベントをサブスクライブするときにも影響します。

次の方法でエージェントの初期化を遅らせることができます。

APMエージェントを使用すると、コードにスニペットを手動で追加することなく、ブラウザ監視をデプロイできます。エージェントを再起動すると、Browserエージェントの最新バージョンが自動的に使用されます。

APMエージェントを使ってブラウザアプリのバックエンドを監視していて、そのアプリが非SPAの場合は、この方法を使用することをおすすめします。

各APMエージェントには固有の手順があります。

ブラウザをプログラムで作成したい場合は、NerdGraph、GraphQL APIを介して作成できます。

詳細については、NerdGraphチュートリアルを参照して、ブラウザスニペットを作成し、設定してください。

スニペットができたら、それをアプリの<head>タグに追加します。

複数のウェブアプリにわたってブラウザ監視デプロイメントを自動化したい場合は、NerdGraphとBrowserエージェントnpmパッケージを使用して、アプリケーションのビルドプロセスの一部としてエージェントを設定し、デプロイすることができます。

Browserエージェントをインストールしたら、数分待って、ブラウザモニタリングUIでデータを検索します。

15分以上経ってもデータが表示されない場合は、ブラウザインストレーションのトラブルシューティングを参照してください。

UIにBrowserデータが表示されたら、そのデータを最大限に活用するための次の手順に従います。