Mobile default events for Insights

For some New Relic Mobile subscriptions, you can use New Relic Insights to query and analyze Mobile events and their associated attributes. Mobile events and attributes are also used for some Mobile UI pages, such as Crash analysis.

Default mobile events

The following table describes the standard Mobile events.

The collection of New Relic Mobile events requires Mobile agent version 5.0.0 or higher.

Use the New Relic event data dictionary to view the attributes for the default Mobile events by selecting an event name:

Event Description
Mobile A Mobile event is created when a crash occurs, when an interaction ends or has run for 1 second, or if a session completes after the app is closed, backgrounded, or has run for 10 minutes. Mobile events were once the only event type and were generated for every event, but now there are several specialized event types. Recommendation: Upgrade to the most recent New Relic Mobile agent version to take full advantage of the new event types.
MobileBreadcrumb There is no attribute list for this event type because it is a custom event; attributes will include the session attributes and any custom attributes that you add.
MobileCrash The MobileCrash event is created when an app crashes. MobileCrash includes attributes such as crash line number, class, and crash message.
MobileHandledException

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

The exceptions will be visible in Insights and on the Handled exceptions page of the Mobile UI, including stack traces. To use this event type, you must have Mobile agent version 5.15 or higher for Android or iOS.
MobileRequest

A MobileRequest event is created when an HTTP Request completes, that is, requests resulting in a response code below 400.

To use this event type, you must have Mobile agent version 5.14.0 or higher for Android or iOS.

New Relic MobileRequest data is enabled by default for:

For earlier versions, starting with Android version 5.14.0 or iOS version 5.14.0, you must enable the feature. Upgrade to the latest Android or iOS version, or enable the NetworkRequests feature flag by using the Android or iOS configuration settings.
MobileRequestError

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 an HTTP request that results in no response. The event is sent when the HTTP request completes.

For best results, use New Relic Mobile agent 5.14.0 or higher for Android or iOS. With lower agent versions, some attributes may be missing, and you will not have access to MobileRequest events.
MobileSession 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 New Relic Mobile events. MobileSession captures attributes such as device type, device OS, and geographical information.
Custom events There is no attribute list for this event type because it is a custom event; attributes will include the session attributes and any custom attributes that you add.

See also:

Examples of querying Mobile data

For examples of how to query Mobile events and attributes in New Relic Insights, see Mobile query examples.

For more help

Recommendations for learning more: