Browser settings: UI options for browser monitoring

As part of the New Relic Browser setup requirements, you must enable browser monitoring individually for each of your apps. You can also set a specific Apdex value for page load timing (sometimes to as real user monitoring or RUM) and specify countries to view detailed page load timing information.

  • If your app has never reported any browser monitoring data through New Relic, you must first enable it from the Browser applications index. Then follow these procedures to enable additional browser monitoring features.
  • If you enabled page load timing and your app reported browser monitoring data through New Relic prior to October 2014, start here to configure New Relic Browser.

Access to some features depends on your subscription level.

Enable New Relic Browser

For a library of videos about how to get started with New Relic Browser, how to enable and configure it, and how to get the most out of the user interface, visit learn.newrelic.com.

To enable New Relic Browser:

  1. Go to rpm.newrelic.com/browser > (select an app) > Settings.
  2. From Application settings, select your Deployment method: New Relic APM instrumentation or copy/paste method.
  3. Select your choice of available options for Browser agent instrumentation features, based on your New Relic subscription level.
  4. Optional: Select an Apdex T value and countries specifically for browser monitoring, or leave the default Apdex value.
  5. Select Save application settings.
  6. Flush the webserver cache.
  7. Optional: To override how New Relic Browser groups your metrics, set up a URL whitelist.
  8. If you used the New Relic APM agent to add your JavaScript snippet, instrument your webpages for page load timing.

When you enable Browser Pro features for Session traces, AJAX calls, and JavaScript errors, it may take approximately five minutes before information becomes available. If no data appears after five minutes, refer to the troubleshooting tips, and restart your agent.

Enable New Relic Browser via copy/paste

If you used the copy/paste method to deploy a standalone browser app and need to retrieve your JavaScript code snippet, your app's Settings page includes the generated JavaScript snippet. Once your standalone app's code contains your JavaScript snippet, your standalone application is enabled.

Instrument webpages using the APM agent

This information applies to apps that are also monitored by New Relic APM.

New Relic's agents can instrument webpages with the required JavaScript for page load timing. If you use the New Relic APM agent to add the JavaScript snippet to your webpages, insert the instrumentation snippet as close to the top as possible. This allows you to take advantage of detailed information about New Relic Browser's AJAX calls and JavaScript errors.

For more information, see the instructions for your agent:

Set separate Apdex settings

For apps that are also monitored by New Relic APM, you can set separate Apdex T values for browser (end users) and for New Relic APM.

To set browser Apdex T values:

  1. Go to rpm.newrelic.com/browser > (select an app) > Settings.
  2. From Application settings, select an Apdex T value specifically for browser monitoring, or leave the default Apdex value.
  3. Select up to five countries or regions for browser monitoring to highlight on the Geography page. If you are reporting data to multiple app names, select the same countries in both the primary and secondary apps.
  4. Select Save application settings.

To view the Apdex scores for apps monitored by New Relic Browser:

Whenever you change Apdex settings, a black vertical bar appears on the Page load timing chart.

Disable browser monitoring features

If you used the copy/paste deployment method and want to stop collecting data for a browser app, simply remove the JavaScript snippet from your application's pages.

If you used the New Relic APM agent to insert your JavaScript snippet, you can turn off some of the browser monitoring features individually, or you can disable New Relic Browser entirely.

  1. Go to rpm.newrelic.com/browser > (select an app) > Settings.
  2. To disable only the Pro account level features, select Lite.
  3. To turn off New Relic Browser completely, select Off.
  4. Select Save application settings.
  5. If applicable, restart your New Relic APM agent.

When browser monitoring is off, the agent will not instrument pages with monitoring scripts.

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.