OneAgent for iOS auto-instrumentation features

The following features are automatically instrumented when you set up OneAgent for your project.

• Automatic OneAgent startup
• Lifecycle monitoring
  OneAgent collects data for the following events:
  • AppStart
  • Display: viewDidLoad, viewWillAppear, and viewDidAppear of the ViewController classes
  • Redisplay: viewWillAppear and viewDidAppear of the ViewController classes
• Crash reporting
  OneAgent captures all unhandled exceptions and immediately sends the crash report to the server. The crash report includes the occurrence time and the full stack trace of the exception. If a crash is triggered shortly after a monitored user interaction, OneAgent adds the crash as a child event to the monitored user action.
• Web request monitoring
  OneAgent automatically instruments and tags your web requests. To track web requests, OneAgent adds the x-dynatrace HTTP header with a unique value to the web request. This is required to correlate the server-side monitoring data to the corresponding mobile web request.
• Web request monitoring for requests passed to WKWebView
  OneAgent automatically instruments and tags web requests that are passed to WKWebView.
  Note that OneAgent does not monitor requests issued inside WKWebView. Such requests are handled by the RUM JavaScript if you've properly configured your hybrid app monitoring with Dynatrace.
• User action detection
  OneAgent detects and times user actions such as button taps, view actions, and other UI control interactions. OneAgent creates user actions based on the UI components that trigger these actions and automatically combines user action data with other monitoring data, such as information on web requests and crashes. OneAgent extends the lifetime of user actions to properly aggregate them with other events that are executed in a background thread or immediately after a user action.
• Rage tap detection
  When your mobile app doesn't respond quickly or there's a user interface issue, your app's users may repeatedly tap the screen or affected UI control. OneAgent detects such behavior as a rage tap.
• Location monitoring
  OneAgent captures the location of your app's end users and sends the captured location as a metric to the server. OneAgent only captures three fractional digits to protect the privacy of your users.

All these features are enabled by default. You can disable or refine these features by adding configuration keys to your app's Info.plist file.

Auto-instrumentation occurs during runtime. The resulting app is instrumented to the levels configured in the app's Info.plist file.

You can combine manual instrumentation with auto-instrumentation to capture additional data. For example, you might want to manually instrument certain user-defined actions, report values, or tag specific users.