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

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.