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

MobileHandledException

Data source:

MobileHandledException is sent when an exception is caught and is used for non-fatal exceptions reported to New Relic using the recordHandledException API for Android or iOS.

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.

carrier

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

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.

exceptionAppBuildUuid
ID

The build uuid of the application binary in which the exception was caught.

exceptionCause

The unsymbolicated, platform-specific cause of the exception.

exceptionLocation

New Relic defined location of an exception. Contains a combination of exception file name, class, line number, and method.

exceptionLocationClass

The class that generated the exception. Only present if symbolication succeeded.

exceptionLocationFile

The class that generated the exception. Only present if symbolication succeeded.

exceptionLocationLibraryOffset

For iOS agent only. The library offset of the library that generated the exception. Only present if symbolication succeeded.

exceptionLocationLine

Comes from the exception: The line number where the exception was generated. Only present if symbolication succeeded.

exceptionLocationMethod

The method that generated the exception. Only present if symbolication succeeded.

exceptionMessage

The unsymbolicated message from the exception. It can be user-generated or a generic system message. For Android, this is the Throwable message.

exceptionName

The unsymbolicated exception type.

fingerprint
ID

The New Relic-generated identifier used to group like exceptions.

handledExceptionUuid
ID

The unique ID of the exception event.

lastInteraction

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

libraryName

For iOS agent only. The library name where the exception was generated.

libraryStartAddr

For iOS agent only. The library start address where the exception was generated.

memUsageMb
megabytes (MB)

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

newRelicVersion

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

occurrenceTimestamp

Agent-reported epoch timestamp of the handled exception.

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.

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.

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

Epoch timestamp of the handled exception. This exception timestamp represents the time New Relic created the event, if it's older than two days or some other unexpected time.

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.