Our iOS agent gives you a comprehensive view of your app's performance. The agent monitors iOS apps written in Objective-C, Swift, or both. For a general overview of mobile monitoring functionality, see Introduction to mobile monitoring.
Compatibility and requirements
Before you install the iOS agent, review the compatibility and requirements.
Install the agent
To install the iOS agent, follow our guided install, located directly in the UI. Using this method, you can install and configure the iOS agent with Swift Package Manager (SPM) or CocoaPods.
Extend your instrumentation
After you install the iOS agent, you can extend its default instrumentation with various types of custom data:
To access: | In the mobile UI: | In New Relic dashboards: |
|---|---|---|
Custom data | Create and record custom events, interaction traces, and attributes to add details to your existing data and traces. | Query the custom events that you created in New Relic dashboards and NRQL. |
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 related to crash data. |
Mobile SDK | Use the mobile SDK API to customize the default agent instrumentation. | Then, view those custom events and attributes. |
Handled exceptions | Report exceptions so you can identify factors creating a poor mobile app experience. | To further improve performance, review MobileHandledException event records. |
Breadcrumbs | 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 you have problems with your iOS installation, or if you do not see data in the mobile monitoring UI for your iOS app, try these troubleshooting solutions.