Handled exceptions: Analyze trends, prevent crashes

With New Relic Mobile's Handled exceptions user interface, you can identify significant factors contributing to poor mobile application experience, and use filterable data to find a resolution more quickly. You can also use the handled exceptions API to customize the data you send to New Relic Mobile, and use New Relic Insights to query and share the data.

Handled exceptions workflow

To get the most out of New Relic Mobile's Handled exceptions UI, use this basic workflow:

  1. Go to rpm.newrelic.com/mobile > (select an app) > Exceptions > Handled exceptions.
  2. Use any of New Relic's standard page functions to drill down into detailed information; for example, zoom into any area of a chart.
  3. Look for obvious or general trends in the Users affected and Sessions affected percentage charts.
  4. Adjust the types of exceptions shown by using groups and filters.
  5. Optional: Query or share the chart data via New Relic Insights.
  6. Look for similar patterns where exceptions appear in stack traces with the Top 5 exception locations table.
  7. To view stack trace thread details for each occurrence of the exception, select a record from the Top 5 exceptions location table.
Mobile Handled Exceptions
rpm.newrelic.com/mobile > (select an app) > Exceptions > Handled exceptions: As you explore the wealth of data in the charts and table, use groups and filters to discover patterns that help you determine the root cause of mobile app exceptions.

Exception percentage charts

Start with the Users affected and Sessions affected percentage charts to see at a glance whether there are any unexpected spikes, dips, or patterns with exceptions in general. (If the Users affected chart is empty, there were no user sessions during the selected time period.) For example:

  • Are there any spikes near a recent version release?
  • Is there a time period when the percentage of users has been affected significantly by the exception?
  • Are there uneventful periods?

To examine data in greater detail: Below any chart, select Expand chart.

Exception percentage charts example
Mobile Handled Exceptions: Percentage charts
rpm.newrelic.com/mobile > (select an app) > Exceptions > Handled exceptions: The percentage charts help you quickly see any unexpected spikes, dips, or patterns with exceptions in general.

Groups and filters

Use the groups and filters to examine attributes for crashes, devices, locations, or other custom attributes in more detail. You can select a group, then filter to specific data. For example:

  • Group the list by exception location (default), cause, app build or version, devices, connections, or other custom attributes. This lets you discover patterns in your exceptions to determine the root cause.
  • Use the time picker to adjust the currently selected time period.
  • Filter by a specific Version or by one or more attribute Filter, such as appVersion, exceptionLocationMethod, lastInteraction, or any of the longer list of standard and custom attributes.

The currently selected filters appear at the top of the UI page. You can close them, add other filters, or select other groups and filters.

Groups and filters example
Mobile Handled Exceptions: Groups and filters
rpm.newrelic.com/mobile > (select an app) > Exceptions > Handled exceptions: Group the data by attributes that matter to the most to you, then select one or more filters to help pinpoint specific causes behind the exceptions.

Top five exception locations

Use the Top 5 exception locations table to find or sort patterns in the type of exception you selected from the groups and filters. This includes:

  • Recurring locations in the stack trace
  • Mobile app version
  • Number of occurrences
  • Number of users affected during the selected time period

For example, you can group by Exception Message, filter to timeout message, then select individual timeout locations from the table to review the stack trace thread and details about each occurrence.

  • To filter or group by other attributes, use the table's search window, or select any of the available filters. For example, filter by type of occurrence, device, a specific location, or any custom attributes.
  • To look for other historical patterns, change the selected time period.
Top five exception locations example
Mobile Handled Exceptions: Top 5 locations
rpm.newrelic.com/mobile > (select an app) > Exceptions > Handled exceptions: This example shows the Expand chart button and links to New Relic Insights, where you can query, create dashboards, and share the handled exceptions data.

Insights links

New Relic Mobile's Handled exceptions charts use New Relic Insights default attributes for mobile events (including MobileHandledException), along with any custom attributes you have added to this event type. When you mouse over the charts, direct links appear below them. These links to New Relic Insights allow you to analyze your mobile app data even deeper.

Exception locations table

The Exception locations table supplements the charts. It lists where the top five handled exceptions appear in their stack trace thread, and links them to relevant details. Each row helps you find answers to questions such as:

  • How many of this exception occurred within the selected time period?
  • Does a specific app version have a higher (or lower) number of users affected?
  • Which exception has the fewest number of occurrences?

You can change the sort order or filter options to focus on just the types of exceptions that matter the most to you and your teams. To view additional thread details for each occurrence of the exception, select a record from the Top 5 exceptions location table.

Exception locations table example
Mobile Handled Exceptions: Locations table
rpm.newrelic.com/mobile > (select an app) > Exceptions > Handled exceptions: To continue to the handled exception's Occurrences page, select any row on the table.

For more help

Recommendations for learning more: