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

Mobile

Data source:

A Mobile event is created when a crash occurs, when an interaction ends, or when the harvest cycle is triggered. The harvest cycle typically occurs every 600 seconds (10 minutes), but this can vary depending on the app's activity. Events are created during the session and reported when event harvest cycle has ended. Recommendation: Upgrade to the most recent mobile monitoring agent version to take full advantage of the new event types.

Attribute nameDefinitionData types
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.

interactionDuration

For interaction category events only.

An iOS interaction starts automatically when a view controller's viewDidLoad or viewDidAppear method is called, which will terminate any active interactions. An Android interaction starts when an activity or fragment's onCreate method is called.

A "healthy" interaction trace ends itself after .5 seconds of inactivity, where inactivity is defined by a lack of instrumented method calls. If there is never .5 seconds of inactivity, the trace will terminate after one minute.

An interaction does not end when the view/activity is done loading. As long as there is activity from an instrumented class/method, the interaction will stay open. This means async tasks or dispatch_async calls that run after the view/activity ends will increase the duration of the interaction.

lastInteraction

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

name

For interaction category events only. This is the label of the interaction associated with the event. It is by default assigned by New Relic. For example: ApplicationsListFragment or Display iOS_Example.MasterViewController.

osBuild

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

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.

reportedTimestampMs
milliseconds(ms)

The UTC based timestamp for when the event was sent to New Relic. This is different from the attribute ‘timestamp’, which is when the event began.

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.

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.

MobileCrash

Data source:

The MobileCrash event is created when an app crashes. MobileCrash includes attributes such as crash line number, class, and crash message.

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

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.

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.

crashException

The exception associated with the crash, if one is present. For example: java.lang.NullPointerException.

Native crashes exceptions are associated with com.newrelic.agent.android.ndk.NativeException classes.

crashFingerprint
ID

The New Relic-generated fingerprint used to uniquely identify the crash and other crashes identical to this one.

crashLocation

The crashing class, file name, method, and line number if the crash is symbolicated. If not symbolicated, a memory address within the application binary (iOS), or obfuscated class, method, and line number (Android). Platform specific algorithms are applied to the stack to determine the crashing frame.

crashLocationClass

The class name in which the crash occurred. Requires symbolication.

crashLocationFile

The file in which the crash occurred.

crashLocationLineNumber

The line number in which the crash occurred. Requires symbolication.

crashLocationMethod

The method name in which the crash occurred. Requires symbolication.

crashMessage

The message associated with the crash, if one is present.

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.

diskAvailable
bytes (B)

The root filesystem and the external filesystem space available, in bytes, separated by a comma. For example: 50491392,6523789312 or 0,1495339008.

interactionHistory

The client interactions with the application that led to the crash.

isFirstOccurrence

A boolean value indicating whether or not this was the first occurrence of the crash.

lastInteraction

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

memoryUsage
megabytes (MB)

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

memUsageMb
megabytes (MB)

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

modelNumber

The model of the device. This is the same as the session-level deviceModel attribute.

networkStatus

The type of network that the device was on at the time of crash, such as wifi or LTE.

newRelicVersion

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

occurrenceId
ID

The ID for this instance of the crash.

orientation

The orientation of the device, such as landscape or portrait.

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.

parentProcess

The parent process that launched the crashing process.

parentProcessId
ID

The parent identification number (PID) of the parent process.

platform

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

processId
ID

The PID of the previously running process on the device.

processName

The name of the previously running process.

processPath

The path to the binary.

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.

reportedTimestampMs

The UTC timestamp for when the event was received by New Relic. (This is different from timestamp, which is when the MobileSession event began that crashed.)

runTime

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

screenResolution

The size of the screen for the device, grouped into three categories: normal, large, xlarge.

sessionCrashed

A boolean value indicating whether or not that session crashed.

sessionId
ID

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

symbolicated

A boolean value indicating whether or not the crash was properly symbolicated.

timeSinceLastInteraction
milliseconds (ms)

The time, in milliseconds, since the interaction before a crash event.

timestamp

The UTC epoch time at which an event began.

userImageUuids
ID

The array of build UUIDs for applications and libraries.

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.

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.

MobileRequest

Data source:

A MobileRequest event is created when an HTTP request successfully completes, resulting in a response code below 400.

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.

bytesReceived
bytes (B)

Optional: If the application received a response from the requestUrl, the size of that response in bytes.

bytesSent
bytes (B)

Optional: If the application sent a request to the requestUrl, the size of that request in bytes.

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.

connectionType

The type of connection which the device was using, such as 2G or 3G.

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.

deviceSize

The display size of the device: Small, normal, large, xlarge.

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.

duration
seconds (s)

Optional: The time to complete the request, measured in fractional seconds.

guid
ID

The unique identifier for the segment. This is equivalent to spanID in OpenTracing semantics.

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.

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.

requestDomain

The domain that the application attempted to access when the event occurred.

requestFingerprint
ID

The New Relic-generated identifier used to group like request events.

requestMethod

The REST method (GET, PUT, POST, etc.) that the application attempted when the event occurred.

requestPath

The path that the application attempted to access when the event occurred.

requestUrl

The URL that the application attempted to access when the event occurred.

requestUuid
ID

A unique identifer for the request event.

responseTime
seconds (s)

The time between the request and the response in fractional seconds.

sessionId
ID

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

statusCode

Optional: The HTTP status code for the HTTP event.

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.

trace.id
ID

The unique ID (a randomly generated string) used to identify a single request as it crosses inter- and intra- process boundaries. This ID allows the linking of spans in a distributed trace. Included when distributed tracing is enabled.

traceId
ID

The unique ID (a randomly generated string) used to identify a single request as it crosses inter- and intra- process boundaries. This ID allows the linking of spans in a distributed trace. Included when distributed tracing is enabled.

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.

MobileRequestError

Data source:

A MobileRequestError is used for HTTP errors or network failures. HTTP errors are HTTP requests that have a status code greater than 400. A network failure is a HTTP request that results in no response. The event is sent when the HTTP request completes.

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.

bytesReceived
bytes (B)

Optional: If the application received a response from the requestUrl, the size of that response in bytes.

bytesSent
bytes (B)

Optional: If the application sent a request to the requestUrl, the size of that request in bytes.

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.

connectionType

The type of connection which the device was using, such as 2G or 3G.

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.

deviceSize

The display size of the device: Small, normal, large, xlarge.

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.

duration
seconds (s)

Optional: The time to complete the request, measured in fractional seconds.

errorType

Either HTTPError or NetworkFailure, depending on whether the error is a result of a failed request to a host or a failure on the cellular network.

guid
ID

The unique identifier for the segment. This is equivalent to spanID in OpenTracing semantics.

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.

networkError

The error message associated with the iOS NSURL Error code. See networkErrorCode for more information.

networkErrorCode

If the error is a network error, this is the iOS network error code. For Android applications, this is the mapped value.

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.

requestDomain

The domain that the application attempted to access when the event occurred.

requestErrorFingerprint
ID

The New Relic-generated identifier used to group like request error events.

requestMethod

The REST method (GET, PUT, POST, etc.) that the application attempted when the event occurred.

requestPath

The path that the application attempted to access when the event occurred.

requestUrl

The URL that the application attempted to access when the event occurred.

requestUuid
ID

A unique identifer for the request event.

responseBody

Optional: The response that is sent from the requestDomain for the HTTP error, up to 4096 bytes.

responseTime
seconds (s)

The time between the request and the response in fractional seconds.

sessionId
ID

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

statusCode

Optional: The HTTP status code for the HTTP event.

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.

trace.id
ID

The unique ID (a randomly generated string) used to identify a single request as it crosses inter- and intra- process boundaries. This ID allows the linking of spans in a distributed trace. Included when distributed tracing is enabled.

traceId
ID

The unique ID (a randomly generated string) used to identify a single request as it crosses inter- and intra- process boundaries. This ID allows the linking of spans in a distributed trace. Included when distributed tracing is enabled.

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.

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.