Browser Agent インストールのトラブルシューティングフレームワーク

原文: Browser Troubleshooting Framework Install

Browser Agentのインストールが完了すると、数分後にはデータのレポートが表示されるはずです。問題が発生した場合は、サポートチームがトラブルシューティングのために行う手順をご紹介しますので、問題の早期発見と解決にお役立ていただければ幸いです。

1. New Relic Browser Agentのインストールが成功した場合、数分後にデータが Browser Overview UI に表示され始めるはずです。
2. データが報告されない場合は、ブラウザのスニペットがウェブページに読み込まれているかどうかを確認します。
3. アプリケーションをブラウザで開き、開発者ツールのコンソールを開きます。例えば、Chromeブラウザであれば、右クリックメニューの「検証」から開発者ツールを開きます。
4. コンソールを開き、newrelic.infoと入力します。

   このページでBrowserのスクリプトが正常に実行されていれば、以下のような結果になります。

   

   そうでない場合は、以下のようなエラーが表示されます。これはブラウザエージェントが正しくインストールされていないことを意味します。

   

5. エラーが発生した場合、トラブルシューティングとして、使用したインストール方法を確認し、以下の案内に従ってください。

コピー・ペーストによる方法の場合

1. アプリの「Application settings」ページにあるコードをそのままコピーしてください。
2. コピーしたコードはheadタグの内部で、他のscriptタグより前で、タグの後に正確に貼り付ける必要があります。以下のスクリーンショットをご覧ください。

   

3. このコードが正しく貼り付けられたら、コードが保存され、Webページに変更が反映されていることを確認します。
4. 変更が反映されていない場合は、Webブラウザのキャッシュコンテンツを消去してください。

APM Agent(自動挿入)による方法の場合

1. APMエージェントのログには、ブラウザの注入に成功したことや、ブラウザの注入に失敗した理由などが表示されているはずです。
2. New Relicの設定ファイル(.ymlファイルなど)でbrowser_monitoringを確認してください。
3. auto_instrumentを有効にして、値をfalseや0ではなくtrueや1に設定してください。
4. デフォルトでは、APMエージェントがインストールされると有効になります。
5. 最近有効にした場合は、この変更を反映させるために、アプリと関連サーバーを再起動してください。
6. New Relic Browser UIのアプリケーション設定ページから、ブラウザの監視がLite、Pro、Pro+SPAのいずれかに有効になっているかを確認します。これを「オフ」に設定すると、APMエージェントがWebページにブラウザスクリプトを注入しないことを意味します。

   

7. お客様のエージェントに応じた具体的な手順については、以下のリンクを参照してください。
   • Go
   • Java
   • .NET
   • Node.js
   • PHP
   • Python
   • Ruby

その他の確認事項

1. ブラウザに Adblock ソフトウェアが使用されておらず、Browser スクリプトが注入されるのをブロックしていないことを確認します。
2. APM エージェント の IP アドレスに加えて、New Relic ブラウザー アプリケーションは以下のドメインへ送信します。お客様のアプリケーションは、New Relic サーバーにデータをアップロードするためにこれらのエンドポイントにアクセスできる必要があります。

Browserのエンドポイント

• US リージョンのアカウントの場合
  • bam.nr-data.net
  • js-agent.newrelic.com
• EU地域のアカウントの場合
  • eu01.nr-data.net
  • bam.eu01.nr-data.net

それでも問題が解決しない場合は、support.newrelic.comにアクセスして、New Relic グローバルテクニカルサポートに連絡してください。その際には、すでに試した手順や、期待していた結果と実際の挙動に関して、できるだけ詳しく記載いただくようお願いいたします。