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

MobileApplicationExit

Data source:

A MobileApplicationExit event is generated when an app terminates, either due to a crash or other reasons such as low memory, ANRs, etc. Currently, this event is reported only for Android mobile applications. It leverages Android’s ApplicationExitInfo API to monitor and report on the different reasons for your app’s termination.

This event provides valuable insights into the circumstances surrounding the app's termination and includes attributes such as reason, description, etc. For example, to understand the different reasons for your app exit, you would look at the reason attribute. For all ANRs, the reason would be 6, for crashes it would be 4, and so on, as described in the Android documentation. For a human readable description for your app exit, try looking at the description attribute.

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.

appState

The perceptible state of the app (foreground versus background) based on interpretation of the returned importance field.

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).

architecture

The processor architecture of the device. For example: armv7 or arm64.

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.

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.

description

The human-readable description of the process's death, given by Android runtime. This could be null.

Note: Android provides no guarantees that the format is stable across devices or Android releases.

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.

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.

exitTimestamp

This is the recorded process time of death, in milliseconds as returned by System.currentTimeMillis().

importance

The relative priority of the process at termination.

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.

osBuild

For Android only. The specific build of the Android OS.

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.

processName

The name of the process.

reason

The underlying reason for the application exit (numeric).

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.

runTime

For Android only. The Android Runtime version where the exception/crash was generated.

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.