RUM Android and Android TV Monitoring
Overview
Datadog Real User Monitoring (RUM) enables you to visualize and analyze the real-time performance and user journeys of your application’s individual users.
The Datadog Android SDK supports Android 4.4 (API level 19)+ and Android TV.
Setup
- Declare the SDK as a dependency.
- Specify application details in the UI.
- Initialize the library with application context.
- Initialize the RUM Monitor and Interceptor to start sending data.
Declare the SDK as a dependency
Declare dd-sdk-android and the Gradle plugin as a dependency in your application module’s build.gradle
file.
buildscript {
dependencies {
classpath("com.datadoghq:dd-sdk-android-gradle-plugin:x.x.x")
}
}
plugins {
id("com.datadoghq.dd-sdk-android-gradle-plugin")
//(...)
}
android {
//(...)
}
dependencies {
implementation "com.datadoghq:dd-sdk-android:x.x.x"
//(...)
}
Specify application details in the UI
Navigate to UX Monitoring > RUM Applications > New Application.
Select android
as the application type and enter an application name to generate a unique Datadog application ID and client token.
To instrument your web views, click the Instrument your webviews toggle. For more information, see Web View Tracking.
To disable automatic user data collection for either client IP or geolocation data, uncheck the boxes for those settings. For more information, see RUM Android Data Collected.
To ensure the safety of your data, you must use a client token. If you used only Datadog API keys to configure the dd-sdk-android
library, they would be exposed client-side in the Android application’s APK byte code.
For more information about setting up a client token, see the Client Token documentation.
Initialize the library with application context
In the initialization snippet, set an environment name, service name, and version number. In the examples below, APP_VARIANT_NAME
specifies the variant of the application that generates data. For more information, see Using Tags.
See ViewTrackingStrategy
to enable automatic tracking of all your views (activities, fragments, and more), trackingConsent
to add GDPR compliance for your EU users, and other configuration options to initialize the library.
class SampleApplication : Application() {
override fun onCreate() {
super.onCreate()
val configuration = Configuration.Builder(
logsEnabled = true,
tracesEnabled = true,
crashReportsEnabled = true,
rumEnabled = true
)
.useSite(DatadogSite.US1)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.build()
val credentials = Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>)
Datadog.initialize(this, credentials, configuration, trackingConsent)
}
}
public class SampleApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
final Configuration configuration =
new Configuration.Builder(true, true, true, true)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.useSite(DatadogSite.US1)
.build();
final Credentials credentials = new Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>);
Datadog.initialize(this, credentials, configuration, trackingConsent);
}
}
class SampleApplication : Application() {
override fun onCreate() {
super.onCreate()
val configuration = Configuration.Builder(
logsEnabled = true,
tracesEnabled = true,
crashReportsEnabled = true,
rumEnabled = true
)
.useSite(DatadogSite.EU1)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.build()
val credentials = Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>)
Datadog.initialize(this, credentials, configuration, trackingConsent)
}
}
public class SampleApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
final Configuration configuration =
new Configuration.Builder(true, true, true, true)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.useSite(DatadogSite.EU1)
.build();
Credentials credentials = new Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>);
Datadog.initialize(this, credentials, configuration, trackingConsent);
}
}
class SampleApplication : Application() {
override fun onCreate() {
super.onCreate()
val configuration = Configuration.Builder(
logsEnabled = true,
tracesEnabled = true,
crashReportsEnabled = true,
rumEnabled = true
)
.useSite(DatadogSite.US3)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.build()
val credentials = Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>)
Datadog.initialize(this, credentials, configuration, trackingConsent)
}
}
public class SampleApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
final Configuration configuration =
new Configuration.Builder(true, true, true, true)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.useSite(DatadogSite.US3)
.build();
Credentials credentials = new Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>);
Datadog.initialize(this, credentials, configuration, trackingConsent);
}
}
class SampleApplication : Application() {
override fun onCreate() {
super.onCreate()
val configuration = Configuration.Builder(
logsEnabled = true,
tracesEnabled = true,
crashReportsEnabled = true,
rumEnabled = true
)
.useSite(DatadogSite.US5)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.build()
val credentials = Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>)
Datadog.initialize(this, credentials, configuration, trackingConsent)
}
}
public class SampleApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
final Configuration configuration =
new Configuration.Builder(true, true, true, true)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.useSite(DatadogSite.US5)
.build();
Credentials credentials = new Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>);
Datadog.initialize(this, credentials, configuration, trackingConsent);
}
}
class SampleApplication : Application() {
override fun onCreate() {
super.onCreate()
val configuration = Configuration.Builder(
logsEnabled = true,
tracesEnabled = true,
crashReportsEnabled = true,
rumEnabled = true
)
.useSite(DatadogSite.US1_FED)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.build()
val credentials = Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>)
Datadog.initialize(this, credentials, configuration, trackingConsent)
}
}
public class SampleApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
final Configuration configuration =
new Configuration.Builder(true, true, true, true)
.trackInteractions()
.trackLongTasks(durationThreshold)
.useViewTrackingStrategy(strategy)
.useSite(DatadogSite.US1_FED)
.build();
Credentials credentials = new Credentials(<CLIENT_TOKEN>, <ENV_NAME>, <APP_VARIANT_NAME>, <APPLICATION_ID>);
Datadog.initialize(this, credentials, configuration, trackingConsent);
}
}
The initialization credentials require your application’s variant name and uses the value of BuildConfig.FLAVOR
. With the variant, RUM can match the errors reported from your application with the mapping files uploaded by the Gradle plugin. If you do not have variants, the credentials use an empty string.
The Gradle plugin automatically uploads the appropriate ProGuard mapping.txt
file at build time so you can view deobfuscated RUM error stack traces. For more information, see the Track Android Errors.
Initialize the RUM Monitor and Interceptor
Configure and register the RUM Monitor. You only need to do it once in your application’s onCreate()
method.
val monitor = RumMonitor.Builder().build()
GlobalRum.registerIfAbsent(monitor)
final RumMonitor monitor = new RumMonitor.Builder().build();
GlobalRum.registerIfAbsent(monitor);
To track your OkHttp requests as resources, add the provided Interceptor:
val okHttpClient = OkHttpClient.Builder()
.addInterceptor(DatadogInterceptor())
.build()
final OkHttpClient okHttpClient = new OkHttpClient.Builder()
.addInterceptor(new DatadogInterceptor())
.build();
This records each request processed by the OkHttpClient
as a resource in RUM, with all the relevant information automatically filled (URL, method, status code, and error). Only the network requests that started when a view is active are tracked. To track requests when your application is in the background, create a view manually.
Note: If you also use multiple Interceptors, call DatadogInterceptor
first.
You can also add an EventListener
for the OkHttpClient
to automatically track resource timing for third-party providers and network requests.
Track background events
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:
.trackBackgroundRumEvents(true)
.trackBackgroundRumEvents(true)
Tracking background events may lead to additional sessions, which can impact billing. For questions, contact Datadog support.
Further Reading
Additional helpful documentation, links, and articles: