Upgrade the Browser agent

Running the latest version of New Relic Browser ensures you can access all Browser features and enhancements. To upgrade to the latest version, check your version number, then follow the steps to upgrade an APM-managed installation or to upgrade a copy/paste installation.

Check your version number

To verify your New Relic Browser version number, view the source code of a page which includes the JavaScript snippet. Search the page source for js-agent.newrelic.com/nr-. 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.

The latest version of the New Relic Browser script is available by checking the latest version of the loader. Find the version number by searching for js-agent.newrelic.com/nr- and noting the numbers that follow nr-.

If the latest version number is higher than the number of the version you are currently running, upgrade your Browser agent installation.

Upgrade your APM-managed installation

To upgrade 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 as described in our troubleshooting documentation.

Upgrade your copy/paste installation

There are three ways to access the Browser JavaScript snippet needed to upgrade a copy/paste installation. After accessing the snippet, replace your existing snippet with the new version. Retrieve the snippet from the UI for standalone installations where you have only a few applications. If you have many applications, you may want to use the REST API or the loader endpoint to automate the update process.

Retrieve the snippet from the UI

Download the latest version of the snippet from Browser > (selected app) > Application settings.

This option is only available for standalone installations.

Extract the snippet with the REST API

To update the snippet using the New Relic REST API, follow the process for viewing a specific Browser app. The loader_script attribute in your response will include the latest JavaScript snippet.

This may be a good solution if you have many applications to manage, or if your Browser app is linked to an APM app.

Update using the loader endpoint

To update the snippet from the New Relic loader endpoint, use the Browser Pro endpoint or the Browser Lite endpoint. These endpoints always point to the latest version of the script snippet.

New Relic suggests using the Browser Pro loader regardless of your Browser subscription level because it is compatible with both the Pro and Lite subscription levels.

If you have opted in to the SPA monitoring Beta release, you can use the Browser Pro + SPA endpoint.

Unlike the methods above, these loader endpoints are generic and do not include your specific configuration data. To add your configuration data, set the Browser application ID and key immediately after the snippet. Your browser key is not the same as your license key.

The ID and key are available from the New Relic UI, or via the API.

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

For more help

Additional documentation resources include:

Discuss Browser monitoring in the New Relic Online Technical Community! Troubleshoot and ask questions, or discuss JavaScript error reporting or AJAX timing in detail.

If you need additional help, get support at support.newrelic.com.