Initial setup for iOS frontends

  • Latest Dynatrace
  • How-to guide
  • Published Dec 22, 2025

On this page, you will learn how to perform initial setup for iOS frontends.

Prerequisites

Before you begin, ensure your environment meets the following requirements:

  • iOS 12.0+
  • tvOS 12.0+
  • Xcode 16.0+

Activate the New RUM Experience for a mobile frontend

  1. Go to Experience Vitals Experience Vitals > Overview.
  2. Select Mobile to view all mobile frontends.
  3. Select the frontend you want to configure.
  4. Navigate to the Settings tab.
  5. Under Enablement and cost control, turn on New Real User Monitoring Experience.

Activate the New RUM Experience at the environment level

To enable the New RUM Experience for web frontends at the environment level:

  1. Go to Settings Settings > Collect and capture > Real User Monitoring > Mobile frontends > Traffic and cost control.
  2. Turn on Enable New Real User Monitoring Experience.

Perform initial setup

1. Create a Dynatrace mobile application

  1. Go to Experience Vitals Experience Vitals.
  2. Select Add Frontend in the upper-right corner.
  3. Follow the steps in the Frontend creation wizard.
  4. Select iOS as your platform.
  5. The wizard provides your application's identification keys that you'll need in the following steps.

2. Add OneAgent to your project

Follow the instrumentation wizard in the experience vitals app to include the agent into your setup.

3. Configure Info.plist

Add your application's identification keys to your app's Info.plist file. You can find these values in the instrumentation wizard.

<key>DTXApplicationID</key>
<string>YOUR_APPLICATION_ID</string>
<key>DTXBeaconURL</key>
<string>YOUR_BEACON_URL</string>

Replace YOUR_APPLICATION_ID and YOUR_BEACON_URL with the actual values from the instrumentation wizard in Dynatrace.

4. Import and verify

Import the Dynatrace module in your app to verify the integration.

import Dynatrace

Trigger a project build once before using any OneAgent SDK methods or import declarations.

5. Build and run

Build and run your application to verify the installation.

  1. Build your project in Xcode (Product > Build).
  2. Run the application on a device or simulator.
  3. Perform some actions to generate traffic.
  4. Check your Dynatrace environment—data should appear within a few minutes.

Configuration options

After completing the basic setup, you can customize OneAgent behavior using configuration keys in your Info.plist file. For detailed configuration options including manual startup, debug logging, and all available keys, see Configuration.

Configuration keyDefaultDescription
DTXApplicationID—Your application's unique identifier (required)
DTXBeaconURL—The beacon endpoint URL (required)
DTXStartupWithGrailEnabledfalseSends data to Grail from the first app start

For a complete list of configuration options, see Configuration keys.

Verify your installation

After installing and configuring OneAgent, verify that data is being collected:

  1. Open your app and perform several actions (navigate between screens, tap buttons, and make network requests).

  2. Go to your mobile frontend in Dynatrace:

    1. Go to Experience Vitals Experience Vitals > Overview.
    2. Select Mobile to view all mobile frontends.
    3. Select the frontend you want to configure.

  3. Verify that sessions and user actions appear in the data.

This data can also be analyzed directly in Grail using DQL.

It may take a few minutes for data to appear in Dynatrace after the first app launch.

Known limitations

For information about supported versions, known limitations, and compatibility with other monitoring tools, see Support and limitations.

Related tags
Digital Experience