RUM iOS Monitoring

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

Datadog Real User Monitoring (RUM) enables you to visualize and analyze the real-time performance and user journeys of your application’s individual users.

Setup

Declare the SDK as a dependency.
Specify application details in the UI.
Initialize the library.
Initialize the RUM Monitor, DDURLSessionDelegate, and start sending data.

Note: The minimum supported version for the Datadog iOS SDK is iOS v11+.

Declare SDK as dependency

Declare dd-sdk-ios as a dependency, depending on your package manager.

Package manager	Installation method
CocoaPods	`pod 'DatadogSDK'`
Swift Package Manager	`.package(url: "https://github.com/DataDog/dd-sdk-ios.git", .upToNextMajor(from: "1.0.0"))`
Carthage	`github "DataDog/dd-sdk-ios"`

Specify application details in UI

In UX Monitoring > RUM Applications, click New Application.
Select iOS as your Application Type in the Datadog UI and provide a new application name to generate a unique Datadog application ID and client token.

To keep your data safe, do not use a Datadog API key to configure the dd-sdk-ios library. Instead, use the client token to prevent your API key from being publicly exposed on the client side in the iOS application byte code.

For more information about setting up a client token, see the Client token documentation.

Initialize the library

Dropdown

Datadog.initialize(
    appContext: .init(),
    trackingConsent: trackingConsent,
    configuration: Datadog.Configuration
        .builderUsing(
            rumApplicationID: "<rum_application_id>",
            clientToken: "<client_token>",
            environment: "<environment_name>"
        )
        .set(serviceName: "app-name")
        .trackUIKitRUMViews()
        .trackUIKitActions()
        .trackURLSession()
        .build()
)

Datadog.initialize(
    appContext: .init(),
    trackingConsent: trackingConsent,
    configuration: Datadog.Configuration
        .builderUsing(
            rumApplicationID: "<rum_application_id>",
            clientToken: "<client_token>",
            environment: "<environment_name>"
        )
        .set(serviceName: "app-name")
        .set(endpoint: .eu)
        .trackUIKitRUMViews()
        .trackUIKitActions()
        .trackURLSession()
        .build()
)

The RUM SDK automatically tracks user sessions depending on options provided at the SDK initialization. To add GDPR compliance for your EU users and other initialization parameters to the SDK configuration, see the Set tracking consent documentation.

Initialize RUM Monitor and `DDURLSessionDelegate`

Configure and register the RUM Monitor. You only need to do it once, usually in your AppDelegate code:

import Datadog

Global.rum = RUMMonitor.initialize()

To monitor requests sent from the URLSession instance as resources, assign DDURLSessionDelegate() as a delegate of that URLSession:

let session = URLSession(
    configuration: .default,
    delegate: DDURLSessionDelegate(),
    delegateQueue: nil
)

iOS Crash Reporting and Error Tracking

Crash Reporting and Error Tracking for iOS displays any issues and latest available errors. You can view error details and attributes including JSON in the RUM Explorer.

Crash Reporting and Error Tracking is available in beta. To sign up, see Crash Reporting (beta).