• /
  • Log in

Introduction to New Relic Mobile for iOS

New Relic Mobile for iOS monitors your mobile app, giving you a comprehensive view of your app's performance. It works for iOS apps written using Objective-C, Swift, or both languages. For a general overview of New Relic Mobile functionality, see Introduction to New Relic Mobile.

Compatibility and requirements

Before you install New Relic Mobile for iOS, review the compatibility and requirements.

Install the agent

As part of the installation process, New Relic Mobile automatically generates an application token. This is a 40-character hexadecimal string for authenticating each mobile app that you monitor in New Relic Mobile.

There are two ways you can install New Relic Mobile for iOS:

Extend your instrumentation

After you install the agent, extend the agent's instrumentation by using the New Relic Mobile UI and following up on information in New Relic Insights.

To access:

In New Relic Mobile:

In New Relic Insights:

Custom data

Create and record custom events, interaction traces, and attributes to add details to your existing data and traces.

Then, view the custom events that you created in New Relic Insights.

Network requests

Enable the MobileRequest event feature so you can perform a full network analysis.

To further investigate network request error rates and response times, query MobileRequest and MobileRequestError events.

Crash analysis

Review detailed information using groups and filters to analyze trends that lead to crashes.

To view more information about crashes, create NRQL queries to review Insights charts related to crash data.


Use the iOS SDK API for New Relic Mobile to instrument parts of your code that are not instrumented by default.

Then, view those custom events and attributes in New Relic Insights.

Handled exceptions

Report exceptions so you can identify factors creating a poor mobile app experience.

To further improve performance, review MobileHandledException event records in New Relic Insights.


Boost the level of detail in crash event trails by adding breadcrumbs.

Then, query MobileBreadcrumbs events to see all breadcrumbs or just breadcrumbs related to crashes.

Troubleshoot your installation

If New Relic Mobile for iOS isn't reporting data, try these troubleshooting suggestions.

For more help

If you need more help, check out these support and learning resources:

Create issueEdit page
Copyright © 2021 New Relic Inc.