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

MobileSession

Data source:

A MobileSession event is sent when an app is closed, backgrounded, or when 10 minutes of active use has elapsed. This is the source of the general session data used by the other mobile monitoring events. MobileSession captures attributes such as device type, device OS, and geographical information.

Attribute nameDefinitionData types
appBuild
ID

Indicates the technical build number of the app binary. As a developer, you can use this attribute to identify specific builds of your app.

appId
ID

A unique identifier for a monitored app, based on the app token. For example: 35091.

appName

The name of the monitored app. For example: My Mobile App - iOS.

appVersion

The version number of the monitored app. For example: 2.2.9.

appVersionId
ID

An internal identifier New Relic uses to order lists of multiple instances of app versions (appVersion).

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.

asnOwner

The telecom owner of the ASN.

bundleId
ID

The unique string used to identify the application.

carrier

The network over which the app transferred data, such as Wi-Fi, Verizon, or Sprint.

category

The type of data: session, crash, or interaction.

city

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

countryCode

The country from which the device ran the application. For a list of country codes, see ISO 3166-1 alpha-2.

device

The specific type of the device: iPhone 8, iPad Pro, etc. Duplicate of deviceType.

deviceGroup

The category of the device, such as iPhone or Tablet.

deviceManufacturer

The manufacturer of the device, such as Motorola or HTC.

deviceModel

The model number of the device, such as XT1039 or SM-G900F.

deviceName

The device's name.

deviceType

The specific type of device: iPhone 8, iPad Pro, etc. Duplicate of device.

deviceUuid
ID

A unique identifier assigned at the time of app installation by New Relic. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Duplicate of uuid.

install

Indicates true only if the current session is the first session after app install.

lastInteraction

The last interaction before a crash or harvest event, if one is present.

memUsageMb
megabytes (MB)

The total amount of memory, in MB, used by the application. Updated every 60 seconds.

newRelicAgent

The New Relic agent running on the application. For example: the iOSAgent or the androidAgent.

newRelicVersion

The version number of the agent running on the application. For example: 4.232.0. Duplicate of newRelicAgentVersion.

osMajorVersion

The simplified version number of the app's host operating system, such as iOS 11, as compared to iOS 11.0.4.

osName

The name of the app's host operating system, for example, iOS or Android.

osVersion

The exact version number of the app's host operating system, such as iOS 11.0.4, as compared to iOS 11.

platform

The platform type of the mobile monitoring agent, such as native or Cordova.

regionCode

The specific region within a country where the monitored app is located. In the United States, regions are states. The regionCode is based on IP address and may not always match your region.

sessionCrashed

A boolean value indicating whether or not that session crashed.

sessionDuration
seconds (s)

The length of time for which the user used the application in seconds. If the session crashes, sessionDuration is not captured (although other events and attributes are still recorded).

For sessions longer than the configured event harvest cycle, events in the Interaction and Custom event categories are sent to New Relic while the session is ongoing, and therefore do not have sessionDuration attributes, but they do have timeSinceLoad attributes. Events recorded near the end of the session may include the duration.

sessionId
ID

A unique identifier for a single user session. A new sessionId is created each time the app is brought into the foreground.

timeSinceLoad
seconds (s)

The time, in seconds, from the beginning of the mobile session to the time the event occurred.

timestamp

The UTC epoch time at which an event began.

upgradeFrom

Indictates previous version number only if this is the first launch after app upgrade.

uuid
ID

A unique identifier assigned by New Relic for a specific app on a particular device. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Dupliate of deviceUuid.