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

Service characterization: Optimize your web telemetry

Make sure you have the web telemetry you need to detect and resolve poor user experience. This guide will help you do that by showing you how to check that you're getting the right data and that is configured for you to make the most of it.


  • Your web application is instrumented with New Relic Browser
  • Your web application is configured for Pro + SPA

In this guide, you will check and tune the following:

Tune Browser application naming and sub-account placement

How's your naming and data organization?

  1. Web application instrumentation from different environments (dev/qa/production) should report into different Browser applications.
  2. Developers, operations, and product owners can work out the following using sub-account names and Browser application names:
    • Which environment a Browser application supports (such as Dev, QA, and production environments).
    • The purpose of a Browser application (customer facing, internal facing, website, website component, region or regions, etc).

Need to make a change?

  1. If you have data from multiple environments reporting into one Browser application, you can create new Browser apps and update the JavaScript snippet in your pages to report the right app.
  2. You can change the name of your browser application following the renaming guide

Tune JavaScript errors

JavaScript errors negatively impact user experience and SEO by disrupting the page load process, displaying errors, and preventing the user from completing an action. Make sure you have the data you need to track and resolve JavaScript errors.

  1. Make sure JavaScript errors are being captured.

You can resolve missing JavaScript errors by:

  • Making sure your Browser agent is up to date. Newer Browser versions may capture JavaScript errors previously overlooked for one reason or another.
  • Making sure the Browser agent is places in the <HEAD/> tag of your pages. You can use Chrome developer tools to verify this.
  • Following these instructions for missing AngularJS errors.
  • Checking to see if your site uses an error handler that’s handling errors before the Browser agent gets the chance to see them.
  • Reviewing what's supported for JavaScript errors.
  • Using the noticeError API to capture missing errors.
  1. Check that your JavaScript errors have event logs. The event log shows the browser interactions, AJAX calls, and traces that led up to a JS error. This can help you troubleshoot the root cause of errors.

    Follow these instructions to troubleshoot missing event logs.

  2. Make sure your JavaScript errors have stack traces.

Follow these instructions to troubleshoot missing stack traces. Or, follow these instructions if you can see stack tracks but can't un-minify them.

Check page view grouping

Page URLs in the Page views UI are automatically grouped to help you manage page performance better. The algorithm that determines the automatic grouping runs when your web app is instrumented for the first time. If your web traffic today is much different from when the app was first instrumented, you may be seeing too few groups.

Use Segment allow lists to tune how your page view URLs are being grouped.

Check AJAX call grouping

AJAX calls are grouped to make it is easier to navigate them at scale. Sometimes there are so many AJAX calls that navigating them by individual request URL is too cumbersome. Follow these steps to check whether or not you need to adjust AJAX grouping.

Use Segment allow lists to tune how your AJAX Requests are being grouped.

Enable distributed tracing

Distributed tracing in Browser helps you improve AJAX performance by tracing requests to the backend all the way to the final endpoint. Tracing information is useful for understanding which applications are impacting user experience. You can use this information to address services issues yourself or delegate to the team responsible.

Set up deployments

Use NerdGraph to track changes in your web application so you can see the impact of change against performance KPIs, conversions, and user engagement.

Add Custom attributes

Use custom attributes to filter and group data. Custom attributes are optional but provide a lot of value. Below are the most commonly recommended attributes. Many customers add more.

Additional custom attributes for retailers

Value Realization

Following the steps in this guide ensures that your team is getting maximum value from New Relic Browser. It ensures you are:

  1. Getting the most value from the data you're collecting
  2. Seeing opportunities to optimize
  3. Able to quickly triage and troubleshoot
  4. Getting the data you need to create real-time business KPI dashboards
Copyright © 2024 New Relic Inc.

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