Datadog Real User Monitoring (RUM) enables you to visualize and analyze the real-time performance and user journeys of your application’s individual users.
DDURLSessionDelegate, and start sending data.Note: The minimum supported version for the Datadog iOS SDK is iOS v11+. The iOS SDK also supports tvOS.
| 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" |
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.
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: .us1)
.trackUIKitRUMViews()
.trackUIKitActions()
.trackURLSession()
.build()
)
DDConfigurationBuilder *builder = [DDConfiguration builderWithRumApplicationID:@"<rum_application_id>"
clientToken:@"<client_token>"
environment:@"<environment_name>"];
[builder setWithServiceName:@"app-name"];
[builder setWithEndpoint:[DDEndpoint us1]];
[builder trackUIKitRUMViews];
[builder trackUIKitRUMActions];
[builder trackURLSessionWithFirstPartyHosts:[NSSet new]];
[DDDatadog initializeWithAppContext:[DDAppContext new]
trackingConsent:trackingConsent
configuration:[builder 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: .eu1)
.trackUIKitRUMViews()
.trackUIKitActions()
.trackURLSession()
.build()
)
DDConfigurationBuilder *builder = [DDConfiguration builderWithRumApplicationID:@"<rum_application_id>"
clientToken:@"<client_token>"
environment:@"<environment_name>"];
[builder setWithServiceName:@"app-name"];
[builder setWithEndpoint:[DDEndpoint eu1]];
[builder trackUIKitRUMViews];
[builder trackUIKitRUMActions];
[builder trackURLSessionWithFirstPartyHosts:[NSSet new]];
[DDDatadog initializeWithAppContext:[DDAppContext new]
trackingConsent:trackingConsent
configuration:[builder 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: .us3)
.trackUIKitRUMViews()
.trackUIKitActions()
.trackURLSession()
.build()
)
DDConfigurationBuilder *builder = [DDConfiguration builderWithRumApplicationID:@"<rum_application_id>"
clientToken:@"<client_token>"
environment:@"<environment_name>"];
[builder setWithServiceName:@"app-name"];
[builder setWithEndpoint:[DDEndpoint us3]];
[builder trackUIKitRUMViews];
[builder trackUIKitRUMActions];
[builder trackURLSessionWithFirstPartyHosts:[NSSet new]];
[DDDatadog initializeWithAppContext:[DDAppContext new]
trackingConsent:trackingConsent
configuration:[builder 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: .us5)
.trackUIKitRUMViews()
.trackUIKitActions()
.trackURLSession()
.build()
)
DDConfigurationBuilder *builder = [DDConfiguration builderWithRumApplicationID:@"<rum_application_id>"
clientToken:@"<client_token>"
environment:@"<environment_name>"];
[builder setWithServiceName:@"app-name"];
[builder setWithEndpoint:[DDEndpoint us5]];
[builder trackUIKitRUMViews];
[builder trackUIKitRUMActions];
[builder trackURLSessionWithFirstPartyHosts:[NSSet new]];
[DDDatadog initializeWithAppContext:[DDAppContext new]
trackingConsent:trackingConsent
configuration:[builder 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: .us1_fed)
.trackUIKitRUMViews()
.trackUIKitActions()
.trackURLSession()
.build()
)
DDConfigurationBuilder *builder = [DDConfiguration builderWithRumApplicationID:@"<rum_application_id>"
clientToken:@"<client_token>"
environment:@"<environment_name>"];
[builder setWithServiceName:@"app-name"];
[builder setWithEndpoint:[DDEndpoint us1_fed]];
[builder trackUIKitRUMViews];
[builder trackUIKitRUMActions];
[builder trackURLSessionWithFirstPartyHosts:[NSSet new]];
[DDDatadog initializeWithAppContext:[DDAppContext new]
trackingConsent:trackingConsent
configuration:[builder 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.
DDURLSessionDelegateConfigure and register the RUM Monitor. You only need to do it once, usually in your AppDelegate code:
import Datadog
Global.rum = RUMMonitor.initialize()
@import DatadogObjc;
DDGlobal.rum = [[DDRUMMonitor alloc] init];
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
)
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]
delegate:[[DDNSURLSessionDelegate alloc] init]
delegateQueue:nil];
You can track events such as crashes and network requests when your application is in the background (for example, no active view is available).
Add the following snippet during initialization in your Datadog configuration:
.trackBackgroundEvents()
Tracking background events may lead to additional sessions, which can impact billing. For questions, contact Datadog support.
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.
Additional helpful documentation, links, and articles:
