New Relic data dictionary

This data dictionary defines some of our default-reported data stored in NRDB and queryable via NRQL. This includes events like Transaction, MobileRequest, and BrowserInteraction, and our Metric, Log, and Span data types. These definitions are also available from our query builder UI by mousing over applicable data type and attribute names.

This dictionary doesn't contain:

  • Data from our infrastructure integrations (for that, see docs for a specific integration)
  • Custom data
  • Detailed integration-specific attributes for Metric data

AjaxRequest

Data source:

AjaxRequest events occur for any Ajax request, including during a BrowserInteraction event. The event attribute tracks geographic and browser info. Use browser app settings to block specific requests.

Attribute nameDefinitionData types
actionText

The text of the HTML element that was clicked when a browser interaction started. Added to BrowserInteraction and any AjaxRequest, JavaScriptError and BrowserTiming events that occurred during that interaction.

appId
ID

The ID of your application, as recorded by New Relic.

appName

The name of the application that handled the request as shown in browser monitoring.

asn

Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user.

asnLatitude

The latitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's latitude.

asnLongitude

The longitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's longitude.

asnOrganization

The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.

browserInteractionId
ID

A unique value generated for each browser interaction captured by the New Relic agent.

browserInteractionName

The name of the interaction. This is either the targetGroupedUrl or the custom name set via the API.

city

The city in which the event occurred, such as Portland or Seattle.

countryCode

The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2.

deviceType

The type of device that loaded the page: mobile, tablet, or desktop.

eventId
ID

A value that you can link to multiple BrowserInteraction events so you can view the interactions that occurred surrounding a specific event. For example, you can see the browser interactions that occurred prior to a JavaScript error.

groupedPageURL

The grouped URL of the view that made the AJAX request. For example: myapp.com/acct/\*/dash.

groupedRequestUrl

The grouped URL of the AJAX request. For example: myapp.com/acct/\*/ajax.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

hostname

The fully qualified domain name (FQDN) of the request URL.

httpMethod
enum

The HTTP method of the AJAX request. Example: POST.

httpResponseCode
enum

The HTTP response code. Example: 200.

jsDuration
seconds (s)

The total duration, in seconds, spent on JavaScript execution. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction. This attribute doesn't exist for initial page load events.

pageUrl

The URL of the page that was loaded for the PageView, for example: http://www.newrelic.com. This URL does not include query parameters.

parentEventId
ID

A unique value generated for each interaction with the page. You can use this value to group interactions together.

port
enum

The request port.

regionCode

The specific administrative division within a country where the PageView event occurred. In the United States, regions correspond to state codes, such as WA or NY. Outside the United States, a country's regions correspond to numerical codes.

In the United States, regions correspond to state codes ; for example, WA or NY. Outside the United States, a country's regions correspond to numerical codes .

requestBodySize
bytes (B)

The payload size of the request body, in bytes.

requestUrl

The URL of the AJAX request. For example: myapp.com/acct/1/ajax.

responseBodySize
bytes (B)

The payload size of the response body, in bytes.

session

A unique identifier for a single session. The session is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

timeSinceBrowserInteractionStart
seconds (s)

The time in seconds between the start of the BrowserInteraction and the start of the request.

timestamp

The time (date, hour, minute, second) at which the interaction occurred.

timeToLastCallbackEnd
seconds (s)

The duration, in seconds, from the start of the request (timestamp) to the end of the last callback. This is not just an additive function; the callback time can overlap with the wait time. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction.

timeToLoadEventStart
seconds (s)

The time, in seconds, from the start of the AJAX request to the start of its load event. This value represents the duration of the AJAX request with single page app (SPA) monitoring.

For more information, see the Mozilla developer documentation about XMLHttpRequest load events.

timeToSettle
seconds (s)

The time, in seconds, from the start of the request to when all resulting callbacks (including callbacks of subsequent AJAX requests) are complete. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction.

userAgentName

The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request.

userAgentOS

The browser’s reported operating system, such as Windows or Linux, that it is running on. This is obtained from the User-Agent header of an HTTP request.

userAgentVersion

The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request.

BrowserInteraction

Data source:

A BrowserInteraction represents a unit of work in a browser session, triggered by a user interacting with the webpage. It captures information about the session, AJAX calls and custom JavaScript timing that occurred as a result of the interaction. Initial load and route changes are captured as special types of browser interactions, and are used for SPA monitoring.

Attribute nameDefinitionData types
actionText

The text of the HTML element that was clicked when a browser interaction started. Added to BrowserInteraction and any AjaxRequest, JavaScriptError and BrowserTiming events that occurred during that interaction.

ajaxCount
count

A count of all XHRs included in the timing of a SPA interaction.

appId
ID

The ID of your application, as recorded by New Relic.

appName

The name of the application that handled the request as shown in browser monitoring.

asn

Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user.

asnLatitude

The latitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's latitude.

asnLongitude

The longitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's longitude.

asnOrganization

The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.

backendTransactionName

The name of the backend transaction that served the initial page load.

browserInteractionId
ID

A unique value generated for each browser interaction captured by the New Relic agent.

browserInteractionName

The name of the interaction. This is either the targetGroupedUrl or the custom name set via the API.

category

The type of interaction; either initial page load, route change, or custom.

city

The city in which the event occurred, such as Portland or Seattle.

countryCode

The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2.

deviceType

The type of device that loaded the page: mobile, tablet, or desktop.

domain

The domain portion of the request URL.

duration
seconds (s)

The total time elapsed of the interaction event

eventId
ID

A value that you can link to multiple BrowserInteraction events so you can view the interactions that occurred surrounding a specific event. For example, you can see the browser interactions that occurred prior to a JavaScript error.

firstContentfulPaint

firstContentfulPaint is the point when the browser renders the first bit of content from the DOM, which may be text, an image, SVG, or a <canvas> element.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstContentfulPaint.

See Compatibility and requirements for New Relic Browser for additional information about firstContentfulPaint browser compatibility.

firstPaint

firstPaint marks the point when the browser renders anything that is visually different from what was on the screen prior to navigation. This includes non-default background paint and the enclosing box of an iframe.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstPaint.

See Compatibility and requirements for New Relic Browser for additional information about firstPaint browser compatibility.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

jsDuration
seconds (s)

The total duration, in seconds, spent on JavaScript execution. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction. This attribute doesn't exist for initial page load events.

monitorAccountId

The synthetic monitoring account from which you are running the monitor.

monitorId
ID

A unique number identifying a particular monitor.

monitorJobId
ID

The ID of a single synthetic monitor run, which began at a specific time and originated from a specific location.

parentEventId
ID

A unique value generated for each interaction with the page. You can use this value to group interactions together.

previousGroupedUrl

The grouped version of the URL in the browser at the start of the interaction.

previousRouteName

The route name of the page at the start of the interaction. This is the last value passed by setCurrentRouteName before the start of the interaction.

previousURL

The ungrouped URL in the browser at the start of the interaction.

queueDuration
seconds (s)

The total time the request waits for a service to initiate (in seconds).

regionCode

The specific administrative division within a country where the PageView event occurred. In the United States, regions correspond to state codes, such as WA or NY. Outside the United States, a country's regions correspond to numerical codes.

In the United States, regions correspond to state codes ; for example, WA or NY. Outside the United States, a country's regions correspond to numerical codes .

session

A unique identifier for a single session. The session is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

targetGroupedUrl

The grouped version of the URL in the browser at the end of the interaction.

targetRouteName

The route name for the page at the end of the interaction. The last value passed by setCurrentRouteName before the end of the interaction.

targetUrl

The ungrouped URL in the browser at the end of the interaction.

timestamp

The time (date, hour, minute, second) at which the interaction occurred.

timeToConnectEnd
seconds (s)

The time, in seconds, from the start of the interaction to the connectEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToConnectStart
seconds (s)

The time, in seconds, from the start of the interaction to the connectStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToDomainLookupEnd
seconds (s)

The time, in seconds, from the start of the interaction to the domainLookupEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToDomainLookupStart
seconds (s)

The time, in seconds, from the start of the interaction to the domainLookupStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToDomComplete
seconds (s)

The time, in seconds, from the start of the interaction to the domComplete, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToDomContentLoadedEventEnd
seconds (s)

The time, in seconds, from the start of the interaction to the domContentLoadedEventEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToDomContentLoadedEventStart
seconds (s)

The time, in seconds, from the start of the interaction to the domContentLoadedEventStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToDomInteractive
seconds (s)

The time, in seconds, from the start of the interaction to the domInteractive, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToDomLoading
seconds (s)

The time, in seconds, from the start of the interaction to the domLoading, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToFetchStart
seconds (s)

The time, in seconds, from the start of the interaction to the fetchStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToLoadEventEnd
seconds (s)

The time, in seconds, from the start of the interaction to the loadEventEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToLoadEventStart
seconds (s)

The time, in seconds, from the start of the interaction to the loadEventStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information, see our documentation about instrumentation for the Navigation Timing API.

timeToRedirectEnd
seconds (s)

The time, in seconds, from the start of the interaction to the redirectEnd, as defined by the Navigation Timing API. This attribute exists only for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToRedirectStart
seconds (s)

The time, in seconds, from the start of the interaction to the redirectStart, as defined by the Navigation Timing API. This attribute exists only for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToRequestStart
seconds (s)

The time, in seconds, from the start of the interaction to the requestStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToResponseEnd
seconds (s)

The time, in seconds, from the start of the interaction to the responseEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToResponseStart
seconds (s)

The time, in seconds, from the start of the interaction to the responseStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToSecureConnectionStart
seconds (s)

The time, in seconds, from the start of the interaction to the secureConnectionStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToUnloadEventEnd
seconds (s)

The time, in seconds, from the start of the interaction to the unloadEventEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToUnloadEventStart
seconds (s)

The time, in seconds, from the start of the interaction to the unloadEventStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

trigger

The cause of the route change or page load. The default values are click, submit, popstate, or initial page load. For a custom event created with the API, the default value for trigger will be api. This value can also be set via the API.

userAgentName

The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request.

userAgentOS

The browser’s reported operating system, such as Windows or Linux, that it is running on. This is obtained from the User-Agent header of an HTTP request.

userAgentVersion

The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request.

webAppDuration
seconds (s)

The total server-side response time for the top-level resource of the PageView or BrowserInteraction event (in seconds) as measured by the APM agent.

This does not include network time to transmit the request or receive the response, or server-side request queueing time. The webAppDuration is measured by the APM agent and must be injected into the browser monitoring script before the request is fully finished. Its end point is slightly before the end point used to calculate the duration attribute on Transactions, so webAppDuration will be slightly less than the duration attribute on Transactions in practice.

BrowserTiming

Data source:

BrowserTiming is a custom event that captures SPA timing data for browser interactions started using the custom createTracer SPA API method. BrowserTiming contains many of the same attributes used by other events, especially AjaxRequest.

Attribute nameDefinitionData types
actionText

The text of the HTML element that was clicked when a browser interaction started. Added to BrowserInteraction and any AjaxRequest, JavaScriptError and BrowserTiming events that occurred during that interaction.

appId
ID

The ID of your application, as recorded by New Relic.

appName

The name of the application that handled the request as shown in browser monitoring.

asn

Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user.

asnLatitude

The latitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's latitude.

asnLongitude

The longitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's longitude.

asnOrganization

The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.

browserInteractionId
ID

A unique value generated for each browser interaction captured by the New Relic agent.

browserInteractionName

The name of the interaction. This is either the targetGroupedUrl or the custom name set via the API.

browserTimingName

The name of the event. This is taken from the name argument of createTracer.

city

The city in which the event occurred, such as Portland or Seattle.

countryCode

The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2.

deviceType

The type of device that loaded the page: mobile, tablet, or desktop.

eventId
ID

A value that you can link to multiple BrowserInteraction events so you can view the interactions that occurred surrounding a specific event. For example, you can see the browser interactions that occurred prior to a JavaScript error.

groupedPageURL

The grouped URL of the view that made the AJAX request. For example: myapp.com/acct/\*/dash.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

jsDuration
seconds (s)

The total duration, in seconds, spent on JavaScript execution. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction. This attribute doesn't exist for initial page load events.

pageUrl

The URL of the page that was loaded for the PageView, for example: http://www.newrelic.com. This URL does not include query parameters.

parentEventId
ID

A unique value generated for each interaction with the page. You can use this value to group interactions together.

regionCode

The specific administrative division within a country where the PageView event occurred. In the United States, regions correspond to state codes, such as WA or NY. Outside the United States, a country's regions correspond to numerical codes.

In the United States, regions correspond to state codes ; for example, WA or NY. Outside the United States, a country's regions correspond to numerical codes .

session

A unique identifier for a single session. The session is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

timeSinceBrowserInteractionStart
seconds (s)

The time in seconds between the start of the BrowserInteraction and the start of the request.

timestamp

The time (date, hour, minute, second) at which the interaction occurred.

timeToLastCallbackEnd
seconds (s)

The duration, in seconds, from the start of the request (timestamp) to the end of the last callback. This is not just an additive function; the callback time can overlap with the wait time. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction.

timeToSettle
seconds (s)

The time, in seconds, from the start of the request to when all resulting callbacks (including callbacks of subsequent AJAX requests) are complete. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction.

timeToTracedCallbackStart
seconds (s)

The time in seconds from the start of the custom tracer until the start of the traced callback. This attribute is unique to the BrowserTiming event.

tracedCallbackDuration
seconds (s)

The duration in seconds of the traced callback. This attribute is unique to the BrowserTiming event.

userAgentName

The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request.

userAgentOS

The browser’s reported operating system, such as Windows or Linux, that it is running on. This is obtained from the User-Agent header of an HTTP request.

userAgentVersion

The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request.

JavaScriptError

Data source:

As JavaScript errors are triggered, we capture details as events. The JavaScriptError event contains information to help you segment errors to understand how they impact performance.

Attribute nameDefinitionData types
actionText

The text of the HTML element that was clicked when a browser interaction started. Added to BrowserInteraction and any AjaxRequest, JavaScriptError and BrowserTiming events that occurred during that interaction.

appId
ID

The identification number for the reporting browser agent.

appName

The name of the application that handled the request as shown in browser monitoring.

asn

Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user.

asnLatitude

The latitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's latitude.

asnLongitude

The longitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's longitude.

asnOrganization

The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.

browserInteractionId
ID

A unique value generated for each browser interaction captured by the New Relic agent.

browserStackHash
ID

An unique identifier generated for a stack trace. The browserStackHash for a stack trace is different across different browsers. An identical stack trace will generate the same identifier.

city

The city in which the event occurred, such as Portland or Seattle.

countryCode

The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2.

deviceType

The type of device that loaded the page: mobile, tablet, or desktop.

domain

The domain portion of the request URL.

error.group.name

An optional attribute set using the Browser agent API that can be used to inform how errors should be grouped in Errors Inbox. For more info, see our docs.

errorClass

The error type of the JavaScript Error object. Examples: ReferenceError, SyntaxError, and UncaughtException.

errorMessage

The error message that was delivered.

firstErrorInSession

A value to indicate whether or not this was the first JS error in the session. Example: true.

firstOccurrenceTimestamp

The timestamp of when the first JS error occurs on the page.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

monitorAccountId

The synthetic monitoring account from which you are running the monitor.

monitorId
ID

A unique number identifying a particular monitor.

monitorJobId
ID

The ID of a single synthetic monitor run, which began at a specific time and originated from a specific location.

pageUrl

The URL of the page that was loaded for the PageView, for example: http://www.newrelic.com. This URL does not include query parameters.

parentEventId
ID

A unique value generated for each interaction with the page. You can use this value to group interactions together.

regionCode

The specific administrative division within a country where the PageView event occurred. In the United States, regions correspond to state codes, such as WA or NY. Outside the United States, a country's regions correspond to numerical codes.

In the United States, regions correspond to state codes ; for example, WA or NY. Outside the United States, a country's regions correspond to numerical codes .

releaseIds
ID

The releases in which the app was updated. Example: {\"jQuery\":\"v3.1.1\",\"multiverse\":\"96e9ac7\"}.

requestUri

The URI of the requested resource.

session

A unique identifier for a single session. The session is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

stackHash
ID

A unique identifier generated by the Browser agent for a stack trace. The stackHash for a stack trace is the same across different browsers. An identical stack trace will generate the same identifier.

stackTrace

A collection of the active stack frames when the error occurred.

stackTraceGzip

A compressed version of the stackTrace attribute.

timestamp

The time that the error occurred, in Unix time.

transactionName

The full metric name of the transaction in which the error occurred, or Unknown if the error occurs outside of a transaction.

userAgentName

The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request.

userAgentOS

The browser’s reported operating system, such as Windows or Linux, that it is running on. This is obtained from the User-Agent header of an HTTP request.

userAgentVersion

The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request.

PageAction

Data source:

The Browser PageAction event is the result of the addPageAction API call that sends a user-defined name and optional attributes, along with several default attributes, such as app and geographic data. It is used to capture any event that is not already tracked automatically by the Browser agent, such as clicking a Subscribe button or accessing a tutorial.

Attribute nameDefinitionData types
actionName

The name of the PageAction, as defined by you in your code.

appId
ID

The ID of your application, as recorded by New Relic.

appName

The name of the application that handled the request as shown in browser monitoring.

asn

Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user.

asnLatitude

The latitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's latitude.

asnLongitude

The longitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's longitude.

asnOrganization

The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.

browserHeight

The height of the end user's browser window at the time when the PageAction occurred.

browserWidth

The width of the end user's browser window at the time when the PageAction occurred.

city

The city in which the event occurred, such as Portland or Seattle.

countryCode

The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2.

currentUrl

The URL value at the time of observing the event. This URL may differ from the Page URL if soft navigations have occurred.

deviceType

The type of device that loaded the page: either mobile, tablet, or desktop.

name

The name of the invoked web transaction. For example: Controller/customers/show.

pageUrl

The URL of the page that was loaded for the PageView, for example: http://www.newrelic.com. This URL does not include query parameters.

referrerUrl

The URL of the page that loaded before the PageAction occurred.

regionCode

The specific administrative division within a country where the PageView event occurred. In the United States, regions correspond to state codes, such as WA or NY. Outside the United States, a country's regions correspond to numerical codes.

In the United States, regions correspond to state codes ; for example, WA or NY. Outside the United States, a country's regions correspond to numerical codes .

session

A unique identifier for a single session. The session is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

timeSinceLoad
seconds (s)

The time (in seconds) elapsed from when the page was requested to when the PageAction was created.

timestamp

The time (date, hour, minute, second) at which the interaction occurred.

userAgentName

The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request.

userAgentOS

The browser’s reported operating system, such as Windows or Linux, that it is running on. This is obtained from the User-Agent header of an HTTP request.

userAgentVersion

The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request.

PageView

Data source:

PageView events occur when a user navigates to (loads) a new page. It tracks geographic and timing data for each browser page load.

Attribute nameDefinitionData types
appId
ID

The ID of your application, as recorded by New Relic.

appName

The name of the application that handled the request as shown in browser monitoring.

asn

Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user.

asnLatitude

The latitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's latitude.

asnLongitude

The longitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's longitude.

asnOrganization

The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.

backendDuration
seconds (s)

The backend response time in seconds.

Includes app server (webAppDuration) and network time (networkDuration), as well as queue time if available. Representative of Time to First Byte. Derived from the Navigation Timing API as responseStart minus navigationStart.

browserTransactionName

The transaction name (page view group) as it appears in New Relic Browser.

city

The city in which the event occurred, such as Portland or Seattle.

connectionSetupDuration
seconds (s)

The time to establish a connection with the server in seconds (inclusive of secureHandshakeDuration). Derived from the Navigation Timing API as connectEnd minus connectStart.

countryCode

The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2.

deviceType

The type of device that loaded the page: mobile, tablet, or desktop.

dnsLookupDuration
seconds (s)

The time to resolve the DNS record for the top-level resource (in seconds). Derived from the Navigation Timing API as domainLookupEnd minus domainLookupStart.

domain

The domain portion of the request URL.

domProcessingDuration
seconds (s)

The time it takes to parse the HTML into a DOM and retrieve or execute synchronous scripts.

Often includes time for scripts and static assets to be retrieved. Derived from the Navigation Timing API as domContentLoadedEventEnd minus responseStart.

duration
seconds (s)

The browser response time in seconds. Derived from the Navigation Timing API as loadEventEnd minus navigationStart.

firstContentfulPaint

firstContentfulPaint is the point when the browser renders the first bit of content from the DOM, which may be text, an image, SVG, or a <canvas> element.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstContentfulPaint.

See Compatibility and requirements for New Relic Browser for additional information about firstContentfulPaint browser compatibility.

firstPaint

firstPaint marks the point when the browser renders anything that is visually different from what was on the screen prior to navigation. This includes non-default background paint and the enclosing box of an iframe.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstPaint.

See Compatibility and requirements for New Relic Browser for additional information about firstPaint browser compatibility.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

name

The name of the invoked web transaction. For example: Controller/customers/show.

networkDuration
seconds (s)

The total time spent in redirects as well as in requesting and receiving HTML (in seconds). If webAppDuration (server side timing information) is not available, time on the server will be included in this duration.

pageRenderingDuration
seconds (s)

The page rendering phase is the time between DOM completion (domContentLoadedEventEnd) and the window load event (loadEventEnd), in seconds. This phase measures browser-side processing and display of the page content.

pageTraceId

An ID that is generated per hard page load. This ID remains the same across soft navigations but changes on page refreshes and hard navigations.

pageUrl

The URL of the page that was loaded for the PageView, for example: http://www.newrelic.com. This URL does not include query parameters.

queueDuration
seconds (s)

The total time the request waits for a service to initiate (in seconds).

regionCode

The specific administrative division within a country where the PageView event occurred. In the United States, regions correspond to state codes, such as WA or NY. Outside the United States, a country's regions correspond to numerical codes.

In the United States, regions correspond to state codes ; for example, WA or NY. Outside the United States, a country's regions correspond to numerical codes .

secureHandshakeDuration
seconds (s)

A subset of connectionSetupDuration, the time to establish a TLS connection with the server. Derived from the Navigation Timing API as connectEnd minus secureConnectionStart (in seconds).

session

A unique identifier for a single session. The session is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

timestamp

The time (date, hour, minute, second) at which the interaction occurred.

userAgentName

The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request.

userAgentOS

The browser’s reported operating system, such as Windows or Linux, that it is running on. This is obtained from the User-Agent header of an HTTP request.

userAgentVersion

The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request.

webAppDuration
seconds (s)

The total server-side response time for the top-level resource of the PageView or BrowserInteraction event (in seconds) as measured by the APM agent.

This does not include network time to transmit the request or receive the response, or server-side request queueing time. The webAppDuration is measured by the APM agent and must be injected into the browser monitoring script before the request is fully finished. Its end point is slightly before the end point used to calculate the duration attribute on Transactions, so webAppDuration will be slightly less than the duration attribute on Transactions in practice.

PageViewTiming

Data source:

This event represents individual timing events during a page view lifecycle (for example, time when the largest element is displayed, or the first user interaction with the page). See the PageViewTiming docs for a list of reported events.

Attribute nameDefinitionData types
appId
ID

The ID of your application, as recorded by New Relic.

appName

The name of the application that handled the request as shown in browser monitoring.

asn

Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user.

asnLatitude

The latitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's latitude.

asnLongitude

The longitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's longitude.

asnOrganization

The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.

browserTransactionName

The transaction name (page view group) as it appears in New Relic Browser.

city

The city in which the event occurred, such as Portland or Seattle.

countryCode

The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2.

cumulativeLayoutShift

An important, user-centric metric for measuring visual stability because it helps quantify how often users experience unexpected layout shifts—a low CLS helps ensure that the page is delightful.

For more information, see the PageViewTiming documentation.

deviceType

The type of device that loaded the page: either mobile, tablet, or desktop.

domain

The domain portion of the request URL.

element

Per the web-vitals v4 library, if specified, this is the element corresponding to the largest contentful paint for the page.

This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

elementId

This is the ID, if specified, of the largestContentfulPaint element. This value will only be reported with the LCP metric. This value can be null or empty and is captured from the LargestContentfulPaint.id property.

Please see the web-vitals documentation for current browser support.

elementRenderDelay

Per the web-vitals v4 library, this is the delta between when the LCP resource finishes loading until the LCP element is fully rendered. For more information, please see Optimize LCP.

This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

elementSize

This is the reported size of the largestContentfulPaint element. This value will only be reported with the LCP metric and is captured from the LargestContentfulPaint.size property.

elementTagName

This is the tag name of the largestContentfulPaint element. This value will only be reported with the LCP metric and is captured from the LargestContentfulPaint.element.tagName property.

elementUrl

This is the request url of the largestContentfulPaint element, if the element is an image. This value will only be reported with the LCP metric. The value is captured from the LargestContentfulPaint.url property (if present).

Please see the web-vitals documentation for current browser support.

eventTarget

This is the selector string of the element the user first interacted with as part of the frame where the interaction to next paint (INP) interaction occurred. If this value is an empty string, that generally means the element was removed from the DOM after the interaction.

Note: this has been renamed to interactionTarget as per the web-vitals v4 library in browser agent version 1.267 or higher.

Deprecated, please use interactionTarget instead.

eventTime

The time when the user first interacted during the frame where the interaction to next paint (INP) interaction occurred. If more than one interaction occurred within the frame, only the first time is reported.

Note: this has been renamed to interactionTime as per the web-vitals v4 library in browser agent version 1.267 or higher.

Deprecated, please use interactionTime instead.

firstByteToFCP

Per the web-vitals v4 library, this is the delta between time to first byte (TTFB) and the first contentful paint (FCP).

This attribute only occurs when the value of the timingName attribute is firstContentfulPaint.

Please see the web-vitals documentation for current browser support.

firstContentfulPaint
seconds (s)

The first contentful paint timing rounded down to the nearest second. This attribute only occurs when the value of the timingName attribute is firstContentfulPaint.

For more information, see the PageViewTiming documentation.

firstInteraction
seconds (s)

First interaction is a timing that captures when customers begin to engage with a website, such as clicking a button or typing in a box. The first interaction timing is rounded down to the nearest second. This attribute only occurs when the value of the timingName attribute is firstInteraction.

Events are handled at the document level with addEventListener(). Clicking an empty page will cause an interaction to fire. Valid event type values include:

  • pointerdown
  • mousedown
  • click
  • keydown
  • touchstart

Note that this attribute represents the time of the event; to know which event triggered it, use interactionType.

For more information, see the PageViewTiming documentation.

firstPaint
seconds (s)

The first paint timing rounded down to the nearest second. Occurs when the timingName value is firstPaint.

For more information, see the PageViewTiming documentation.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

inputDelay
milliseconds (ms)

The time from when the user interacted with the page until when the browser was first able to start processing event listeners for that interaction. This time captures the delay before event processing can begin due to the main thread being busy with other work. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint.

Introduced in browser agent version 1.267 as part of web-vitals v4 library. Please see the web-vitals documentation for current browser support.

interactionTarget

This is the selector string of the element the user first interacted with as part of the frame where the interaction to next paint (INP) interaction occurred. If this value is an empty string, that generally means the element was removed from the DOM after the interaction. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint.

Renamed from eventTarget in browser agent version 1.267 or higher as part of web-vitals v4. Please see the web-vitals documentation for current browser support.

interactionTime

The time when the user first interacted during the frame where the interaction to next paint (INP) interaction occurred. If more than one interaction occurred within the frame, only the first time is reported. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint.

Renamed from eventTime in browser agent version 1.267 or higher as part of web-vitals v4 library. Please see the web-vitals documentation for current browser support.

interactionToNextPaint
seconds (s)

A core web vitals metric that assesses responsiveness, or how quickly a web page visually responds to user actions like clicks or taps. A low INP means the page was consistently able to respond quickly to all or nearly all user interactions.

For more information, see the PageViewTiming documentation.

interactionType

The event type of the first interaction that occurs on the web application.

Since Browser agent version 1.267, the type can be pointer or keyboard as per the web-vitals v4 library. interactionType will only occur when value of the timingName attribute is interactionToNextPaint.

Prior to Browser agent version 1.267, this attribute only occurs when the value of the timingName attribute is firstInteraction and it can be one of the following types:

  • pointerdown
  • mousedown
  • click
  • keydown
  • touchstart

For more information, see the PageViewTiming documentation.

Please see the web-vitals documentation for current browser support.

largestContentfulPaint
seconds (s)

This metric reports the render time of the largest content element visible in the viewport, which is a more accurate way to measure when the main content of a page is loaded and useful.

For more information, see the PageViewTiming documentation.

largestShiftTarget

Per the web-vitals v4 library, if specified, this is a selector identifying the first element (in document order) that shifted when the single largest layout shift contributing to the page's CLS score occurred.

This attribute only occurs when the value of the timingName attribute is cumulativeLayoutShift.

Please see the web-vitals documentation for current browser support.

largestShiftTime

Per the web-vitals v4 library, if specified, this is the time when the single largest layout shift contributing to the page's CLS score occurred.

This attribute only occurs when the value of the timingName attribute is cumulativeLayoutShift.

Please see the web-vitals documentation for current browser support.

largestShiftValue

Per the web-vitals v4 library, if specified, this is the layout shift score of the single largest layout shift contributing to the page's CLS score occurred.

This attribute only occurs when the value of the timingName attribute is cumulativeLayoutShift.

Please see the web-vitals documentation for current browser support.

loadState

The loading state of the document at the time of the corresponding event. It can have one of the following values:

  • 'loading'
  • 'dom-interactive'
  • 'dom-content-loaded'
  • 'complete'

For more information, see the web-vitals v4 library documentation.

metricId

A unique ID used by the Google Core Web Vitals library to track changes for a particular metric instance. For more information, see this link.

networkDownlink

This is the estimated effective bandwidth in megabits per second at the time the PageViewTiming event was captured. This value will only be reported with the largestContentfulPaint and firstInteraction events on compatible browsers.

The value is captured from the NetworkInformation API. For a full browser compatibility table and description see the MDN web docs.

networkEffectiveType

This is the effective connection type ('slow-2g', '2g', '3g' or '4g'), of the current network connection at the time the PageViewTiming event was captured. This value will only be reported with the largestContentfulPaint and firstInteraction events on compatible browsers.

The value is captured from the NetworkInformation API. For a full browser compatibility table and description see MDN Web Docs: NetworkInformation.effectiveType. See also Effective connection type for a description of each type.

networkRtt

This is the estimated round trip time, in milliseconds, of the current network connection at the time the PageViewTiming event was captured. This value will only be reported with the largestContentfulPaint and firstInteraction events on compatible browsers.

The value is captured from the NetworkInformation API. For a full browser compatibility table and description see the MDN web docs.

networkType

This is the type of the current network connection at the time the PageViewTiming event was captured. This value will only be reported with the largestContentfulPaint and firstInteraction events on compatible browsers.

The value is captured from the NetworkInformation API. For a full browser compatibility table and description see the MDN web docs.

nextPaintTime

The best-guess timestamp of the next paint after the interaction. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint. For more information, see the web-vitals v4 library documentation.

Introduced in browser agent version 1.267 as part of web-vitals v4 library. Please see the web-vitals documentation for current browser support.

pageHide

Sent when the document becomes hidden to the user, which could mean the user switched tabs or navigated to another page. This is the most reliable event to indicate the (potential) end of a user session or visit to the page.

pageUrl

The URL of the page that was loaded for the PageView, for example: http://www.newrelic.com. This URL does not include query parameters.

presentationDelay
milliseconds (ms)

The time from when the browser finished processing all event listeners for the user interaction until the next frame is presented on the screen and visible to the user. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint. For more information, see the web-vitals v4 library documentation.

Introduced in browser agent version 1.267 as part of web-vitals v4 library.Please see the web-vitals documentation for current browser support.

processingDuration
milliseconds (ms)

The time from when the first event listener started running in response to the user interaction until when all event listener processing has finished. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint.

Introduced in browser agent version 1.267 as part of web-vitals v4 library. Please see the web-vitals documentation for current browser support.

regionCode

The specific administrative division within a country where the PageView event occurred. In the United States, regions correspond to state codes, such as WA or NY. Outside the United States, a country's regions correspond to numerical codes.

In the United States, regions correspond to state codes ; for example, WA or NY. Outside the United States, a country's regions correspond to numerical codes .

resourceLoadDelay

Per web-vitals v4, this is the delta between time to first byte (TTFB) and when the browser starts loading the largest contentful paint (LCP) resource (if there is one, otherwise 0). For more information, please see Optimize LCP.

This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

resourceLoadDuration
milliseconds (ms)

Per web-vitals v4, this is the total time it takes to load the LCP resource itself (if there is one, otherwise 0). For more information, please see Optimize LCP.

This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

resourceLoadTime
milliseconds (ms)

The total time it takes to load the LCP resource itself (if there is one, otherwise 0). This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Note: this has been renamed to resourceLoadDuration as per web-vitals library v4 in browser agent version 1.267 or higher.

Deprecated, please use resourceLoadDuration instead.

session

A unique identifier for a single session. The session is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

targetGroupedUrl

The grouped version of the URL in the browser at the end of the interaction.

timestamp

The time (date, hour, minute, second) at which the interaction occurred.

timeToFirstByte

Per web-vitals v4, this is the time from when the user initiates loading the page until when the browser receives the first byte of the response (for example, time to first byte (TTFB)).

This attribute only occurs when the value of the timingName attribute is firstContentfulPaint or largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

timingName

The name of the timing event: firstPaint, firstContentfulPaint, or firstInteraction.

The name of the timing event: firstPaint, firstContentfulPaint, or firstInteraction. For more information, see the PageViewTiming documentation.

userAgentName

The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request.

userAgentOS

The browser’s reported operating system, such as Windows or Linux, that it is running on. This is obtained from the User-Agent header of an HTTP request.

userAgentVersion

The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request.

windowLoad
seconds (s)

The windowLoad event is fired when the whole has loaded.

See supporting documentation and browser compatibility for the Window Load event MDN docs.

windowUnload
seconds (s)

Sent when the page unloading is detected, which marks the definitive end of a user session or visit to the page.

UserAction

Data source:

The Browser UserAction event is captured as the result of a user interaction with the web application and includes action information and DOM target identifiers along with several default attributes, such as app and geographic data.

The types of interactions captured include:

  • auxclick
  • blur (window only)
  • click
  • copy
  • focus (window only)
  • keydown
  • paste
  • scrollend

Please see element events for more information about the type of events the agent subscribes to when capturing UserAction events.

Attribute nameDefinitionData types
action

The action performed by the end user.

actionCount

The number of times the matching action was seen.

actionDuration
milliseconds (ms)

The duration between the first and last event of the aggregation set.

actionMs

A stringified array of the MS timestamps relative to the origin point of the first observed event in the set.

appId
ID

The ID of your application, as recorded by New Relic.

appName

The name of the application that handled the request as shown in browser monitoring.

asn

Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user.

asnLatitude

The latitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's latitude.

asnLongitude

The longitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's longitude.

asnOrganization

The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.

city

The city in which the event occurred, such as Portland or Seattle.

countryCode

The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2.

currentUrl

The URL value at the time of observing the event. This URL may differ from the Page URL if soft navigations have occurred.

deviceType

The type of device that loaded the page: mobile, tablet, or desktop.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

name

The name of the invoked web transaction. For example: Controller/customers/show.

pageUrl

The URL of the page that was loaded for the PageView, for example: http://www.newrelic.com. This URL does not include query parameters.

rageClick

A boolean flag indicating if the event qualifies as a "rage click" (repeated clicks on an element).

regionCode

The specific administrative division within a country where the PageView event occurred. In the United States, regions correspond to state codes, such as WA or NY. Outside the United States, a country's regions correspond to numerical codes.

In the United States, regions correspond to state codes ; for example, WA or NY. Outside the United States, a country's regions correspond to numerical codes .

session

A unique identifier for a single session. The session is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

target

The window, document or CSS selector path generated for the event.

targetClass

The value of the className property of the DOM target which was acted upon.

targetId

The value of the id property of the DOM target which was acted upon.

targetTag

The value of the tagName property of the DOM target which was acted upon.

targetType

The value of the type property of the DOM target which was acted upon.

timestamp

The time (date, hour, minute, second) at which the interaction occurred.

userAgentName

The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request.

userAgentOS

The browser’s reported operating system, such as Windows or Linux, that it is running on. This is obtained from the User-Agent header of an HTTP request.

userAgentVersion

The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request.