• EnglishEspañol日本語한국어Português
  • Log inStart now

Update the browser agent

Running the latest version of our browser agent ensures you can access all browser features and enhancements. To update to the latest version, check your version number, then follow the steps for either updating an APM-managed installation or upgrading a copy/paste installation.

Check your version number

To verify your browser version number, try one of the following:

  • Inspect the agent harvest payloads (Any Browser Agent Version):
    1. Open the developer tools of your browser.
    2. Open the view in the developer tools that shows network traffic.
    3. Filter the results to only those that include nr-data.net.
    4. The version will be included in the query parameters of each call to the nr-data.net endpoint, in the format of ?v=<version>.
  • Inspect the source code of the agent snippet:
    • Forv1217 or higher:
      1. View the source code of a page which includes the JavaScript snippet.
      2. Search the page source for PROD -- The version will be prepended, in the format of <version>.PROD.
    • For v1216 or lower:
      1. View the source code of a page which includes the JavaScript snippet.
      2. Search the page source for js-agent.newrelic.com/nr-.
      3. The numbers that follow nr- are your current version. For example, js-agent.newrelic.com/nr-593.min.js indicates you are running version 593 of the browser script.
  • Inspect the newrelic global object (v1224 or higher):
    1. Open the developer tools of your browser.
    2. Open the console view.
    3. In the console, enter newrelic.initializedAgents.
    4. In the resulting object, expand the relevant agent object.
    5. Inside the relevant agent object, find runtime.version.

Check your installation type

There are different agent types. The Pro+SPA agent loader files use the format js-agent.newrelic.com/nr-loader-<type>-<version>.min.js. To verify the version of the browser script loader on your page, inspect the newrelic global object (v1224 or higher):

  1. Open the developer tools of your browser.
  2. Open the console view.
  3. In the console, enter newrelic.initializedAgents.
  4. In the resulting object, expand the relevant agent object.
  5. Inside the relevant agent object, find runtime.loaderType.

Check if your version is outdated

To verify if your browser version if outdated:

  1. See the browser agent end of life table.
  2. If the latest version number is higher than the number of the version you are currently running, update your browser agent.

Check deployment method

Your browser agent may have been deployed in two ways: either using a manual implementation (copying and pasting the snippet) or automatically instrumented using an agent. To check which deployment method was used, run this command in the JavaScript console:

> newrelic.info.sa

If the command returns 1, then your browser agent used the copy/paste method.

Update your APM-managed installation

To update your APM-managed browser installation, restart your APM agent. Your app will automatically update to the latest JavaScript snippet.

To ensure the new script registers, you may need to clear your cache. For more information, follow the troubleshooting procedures to manually check and clear the cache.

Update your copy/paste installation

Use any of the following options to access the browser JavaScript snippet needed to update a copy/paste installation. After accessing the snippet, be sure to replace all of your existing snippet with the new version.

  • If you have a standalone installation with a few applications, you can retrieve the snippet from the UI, and then replace it with the new version.
  • If you have many applications, you can use the REST API or the loader endpoint to automate the update process.

Caution

Do not simply change the version number in the existing snippet. This can result in incomplete data collection. For best results after you use any of the following options, always update the agent.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.