• /
  • Log in
  • Free account

Report browser monitoring custom events and attributes

Important

As of April 12, 2021, we are upgrading Insights to an improved web and mobile experience! All of your Insights URLs will be redirected automatically to the corresponding dashboards in New Relic One. For more details about this migration and how you can easily plan for this transition, see our Explorers Hub post.

You can use browser monitoring in New Relic to add custom events and attributes.

Page actions and views

Use the Browser API's addPageAction call to capture events, actions, route changes, or any end-user interactions with your application. The addPageAction call adds an event named PageAction that contains the action name and any custom attribute names and values you capture along with it. The PageAction event also contains any custom attributes you added to the PageView event.

Add custom attributes to the PageView event so you can query or filter your data to answer more questions about your application.

Prerequisites

In order to report PageAction events, verify these prerequisites:

Requirement

Comments

Subscription level

This feature requires a Browser Pro subscription. The instrumentation level setting for an application does not affect the availability of JavaScript API functions.

Agent version

Your New Relic Browser agent version must be 593 or higher.

Client browser version

To record PageAction events, the browser must support cross-domain XHRs.

Max events per cycle

PageAction events are reported every 30 seconds, with a maximum of 60 events per 30-second harvest cycle, per browser. After the 60-event limit is reached, additional events are not captured for that cycle.

Event/attribute naming, data type, size

Ensure you follow general requirements around event/attribute naming syntax, data types, and size.

Create PageAction events

To create a PageAction event:

  1. Ensure the Browser agent is installed for your app.
  2. Call the newrelic.addPageAction function in the relevant part of your application's JavaScript.
  3. Wait a couple minutes for the application to run and report relevant PageAction events.
  4. Run a NRQL query of the PageAction event that includes the actionName attribute you used to capture the event (and any associated attributes you sent along with the action).

Add custom attributes to PageView event

The PageView event is a default Browser-reported event. You can add custom attributes to the PageView event. Any custom attributes you add to the PageView event are also automatically added to the PageAction event.

There are two ways to add custom attributes to the PageView event:

PageAction and PageView attributes

To see the default attributes of PageAction and PageView, see Browser events.

Troubleshooting

Here are some troubleshooting tips:

Problem

Comments

Custom attributes missing

If your custom attributes do not appear on PageView events, verify you are calling setCustomAttribute before the Load event on your page. If the custom attribute is called after the page load occurs, it will not be visible on PageView.

PageAction events

If your PageAction events do not appear when you query, check that your account is compatible.

If your account is compatible, check that you are not using reserved attribute names or invalid values.

For more help

If you need more help, check out these support and learning resources:

Create issueEdit page
Copyright © 2021 New Relic Inc.