Browser エージェントのアップグレード

New Relic Browser の最新バージョンを利用すると、Browser のすべての機能と拡張機能が使えます。最新バージョンにアップグレードするには、バージョン番号を確認し、インストール方法に応じてアップグレード方法を選択してくだい。APM を利用してインストールしている場合、または、コピー&ペーストを利用してインストールしている場合、それぞれの手順を確認します。

バージョン番号のチェック

New Relic Browser バージョン番号は、JavaScript スニペットが含まれているページのソース (HTML) から確認できます。ソースから js-agent.newrelic.com/nr- を探します。nr- の後に続く番号が現在のバージョン番号です。例えば、js-agent.newrelic.com/nr-593.min.js の場合は、Browser のスクリプトのバージョンが 593 であることを示しています。

New Relic Browser のスクリプトの最新バージョンは、この最新バージョンのローダー [英語] [external link]から確認できます。js-agent.newrelic.com/nr- を検索し、nr- に続く番号を見て、最新のバージョン番号を確認してください。

現在お使いのバージョン番号が、最新のバージョン番号よりも古い(低い)場合は、Browser エージェントをアップグレードしてください。

APM を利用してインストールしている New Relic Browser のアップグレード

APM を利用してインストールしている New Relic Browser をアップグレードするには、APM エージェントを再起動します。そうすることで、JavaScript スニペットは自動的に最新バージョンに更新されます。

トラブルシューティングに記載されているように、確実に新しいスクリプトをインストールするために、キャッシュをクリアする必要がある場合があります。

コピー&ペースト を利用してインストールしている New Relic Browser のアップグレード

この方法でインストールしている New Relic Browser の JavaScript コード をアップグレードするには、以下の3つの方法があります。JavaScript のコードを開き、既存のコードを新しいバージョンのコードに置き換えてください。利用しているアプリが少数の場合は、スタンドアロン・インストール用の UI から JavaScript のコードを取得します。多くのアプリで、Browser を利用している場合は、更新自動化の方法として、REST APIローダーエンドポイントを使用することができます。

UI から JavaScript コードを取得する
Browser > (選択したアプリ) > Application settings から最新の JavaScript コードをダウンロードします。
これはスタンドアロンでインストールしている場合のみ、利用可能です。
REST API を利用して JavaScript コードを抽出する
特定の Browser アプリを表示する手順に従い、New Relic REST API を使って JavaScript コードを更新します。レスポンスにある loader_script 属性に、最新の JavaScript コードが含まれています。

これは管理するアプリが多い場合や、APM を利用して Browser アプリを利用している場合に、この方法は便利です。

ローダーのエンドポイントを使用して更新する
New Relic ローダーのエンドポイントから JavaScript コードを更新するには、Browser PRO エンドポイント もしくは Browser LITE エンドポイント を使います。これらのエンドポイントは、常に最新バージョンを指しています。

Browser のサブスクリプションレベルが、PRO と LITE の両方に互換性があるため、どちらの場合でも Browser PRO 用のローダーを使用することを New Relic は、推奨しています。

上記の方法とは異なり、これらのローダーのエンドポイントは、一般的なものであるため、固有のデータは含みません。よって、固有の設定データを追加するには、JavaScript コード直後に Browser のアプリケーション ID とキーを設定する必要があります。

ID とキーは、New Relic の UIAPI 経由で利用可能です。

NREUM.info = { applicationID: "YOUR-APPLICATION-ID",
               licenseKey:    "YOUR-BROWSER-LICENSE-KEY" };

注: Browser のキーは、APM のライセンスキーとは違います。

関連情報

関連する情報は以下のとおりです。