Android and iOS Application Profiling in RUM #34078

arti-arutiunov · 2026-01-23T04:47:12Z

What does this PR do? What is the motivation?

Added 2 new pages about Android and iOS application profiling under the "Profiling" section of "Correlate RUM with Other Telemetry".

New pages introduced are:

Additionally, browser profiling has moved one layer down in the documentation:

https://docs.datadoghq.com/real_user_monitoring/correlate_with_other_telemetry/profiling/browser_profiling/

Merge instructions

Merge readiness:

Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

…ate RUM with Other Telemetry.

github-actions · 2026-01-23T04:51:07Z

Preview links (active after the `build_preview` check completes)

New or renamed files

Modified Files

https://docs-staging.datadoghq.com/Arti-Arutiunov/ios-android-profiling/real_user_monitoring/correlate_with_other_telemetry/profiling/

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

ambushwork · 2026-01-23T09:04:21Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

+            .setApplicationLaunchSampleRate() // default is 15%
+            .build.()
+
+             Profiling.enable(profilingConfig)


Suggested change

Profiling.enable(profilingConfig)

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {

Profiling.enable(profilingConfig)

}

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

config/_default/menus/main.en.yaml

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

0xnm · 2026-01-23T08:53:31Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

+2. Initialize the RUM SDK and configure the `profilingMaximumRate`, which sets the maximum percentage of sessions that are profiled. 
+
+<div class="alert alert-danger">
+  If no value is specified, the default <code>profilingMaximumRate</code> is 15 percent.


Suggested change

If no value is specified, the default <code>profilingMaximumRate</code> is 15 percent.

If no value is specified, the default <code>applicationLaunchSampleRate</code> is 15 percent.

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

static/images/real_user_monitoring/android/android-profiling-ttid.png

static/images/real_user_monitoring/ios/ios-profiling-ttid.png

cswatt · 2026-01-23T17:09:03Z

Created DOCS-13195 to track docs team review

rtrieu

thank you for this great PR! left a lot of feedback around:

relative URLs
consistent tense
header styling
conciseness in some places
additional context in other places

let me know if you have any questions about my feedback. happy to chat!

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

rtrieu · 2026-01-23T21:59:08Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

+      )
+
+      // Enable Profiling feature
+      Profiling.enable(with: .init()) // default is 5%


Suggested change

Profiling.enable(with: .init()) // default is 5%

Profiling.enable(with: .init()) // default is 15%

iOS has a different sample rate of 5%

I would simplify or go with the example in the google docs

Suggested change

Profiling.enable(with: .init()) // default is 5%

Profiling.enable() // default is 5%

or

Suggested change

Profiling.enable(with: .init()) // default is 5%

Profiling.enable(with: .init(applicationLaunchSampleRate: 5)) // custom sample rate (overrides the default 5%)

ah apologies, thought this was a typo because i saw 15 in another place

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

rtrieu · 2026-01-23T21:59:30Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

+
+{{< img src="real_user_monitoring/ios/ios-profiling-session.png" alt="iOS profiling data in a view event to initial display vital event." style="width:90%;" >}}
+
+Use the flame graph, thread timeline, and call graph visualizations to analyze the profiling data for the time to initial display. You can also download the profiling data for external analysis.


Suggested change

Use the flame graph, thread timeline, and call graph visualizations to analyze the profiling data for the time to initial display. You can also download the profiling data for external analysis.

Use the flame graph to identify which functions consume the most Wall time during launch, the thread timeline to see parallel execution patterns, and the call graph to trace function dependencies. You can also download the profiling data for external analysis or deeper investigation.

@rtrieu iOS Profiling measures Wall time instead of CPU time

@simaoseica-dd thanks, updated suggestion

rtrieu

thank you for this great PR! left a lot of feedback around:

relative URLs
consistent tense
header styling
conciseness in some places
additional context in other places

let me know if you have any questions about my feedback. happy to chat!

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

0xnm

I added a few suggestions, lgtm.

0xnm · 2026-01-25T23:06:23Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

+
+<div class="alert alert-warning">The total volume of profiles may not match the percentage configured in <code>applicationLaunchSampleRate</code>. This variation results from <a href="https://developer.android.com/topic/performance/tracing/profiling-manager/will-my-profile-always-be-collected#how-rate-limiting-works">rate limitations</a> within the data collector, including profiling support on older devices and the maximum profiling frequency per device.</div>
+
+The [ProfilingManager API][4] also supports disablng rate limiting during debug builds. 


Suggested change

The [ProfilingManager API][4] also supports disablng rate limiting during debug builds.

The [ProfilingManager API][4] also supports disabling rate limiting during debug builds.

0xnm · 2026-01-25T23:08:28Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

+[4]: /real_user_monitoring/application_monitoring/ios/application_launch_monitoring?tab=swift
+
+
+
+


Suggested change

[4]: /real_user_monitoring/application_monitoring/ios/application_launch_monitoring?tab=swift

[4]: /real_user_monitoring/application_monitoring/ios/application_launch_monitoring?tab=swift

0xnm · 2026-01-25T23:13:58Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

+    class SampleApplication : Application() {
+        override fun onCreate() {
+            super.onCreate()
+            val configuration = Configuration.Builder(
+                clientToken = "<CLIENT_TOKEN>",
+                env = "<ENV_NAME>",
+                variant = "<APP_VARIANT_NAME>"
+            ).build()
+
+            Datadog.initialize(this, configuration, trackingConsent)
+
+            // Enable RUM (required for Profiling)
+            val rumConfig = RumConfiguration.Builder(applicationId)
+                .build()
+            Rum.enable(rumConfig)
+
+            // Enable Profiling
+            val profilingConfig = ProfilingConfiguration.Builder()
+              .setApplicationLaunchSampleRate(15) // default is 15%
+              .build()
+
+            Profiling.enable(profilingConfig)
+        }
+    }


Suggested change

class SampleApplication : Application() {

override fun onCreate() {

super.onCreate()

val configuration = Configuration.Builder(

clientToken = "<CLIENT_TOKEN>",

env = "<ENV_NAME>",

variant = "<APP_VARIANT_NAME>"

).build()

Datadog.initialize(this, configuration, trackingConsent)

// Enable RUM (required for Profiling)

val rumConfig = RumConfiguration.Builder(applicationId)

.build()

Rum.enable(rumConfig)

// Enable Profiling

val profilingConfig = ProfilingConfiguration.Builder()

.setApplicationLaunchSampleRate(15) // default is 15%

.build()

Profiling.enable(profilingConfig)

}

}

class SampleApplication : Application() {

override fun onCreate() {

super.onCreate()

val configuration = Configuration.Builder(

clientToken = "<CLIENT_TOKEN>",

env = "<ENV_NAME>",

variant = "<APP_VARIANT_NAME>"

).build()

Datadog.initialize(this, configuration, trackingConsent)

// Enable RUM (required for Profiling)

val rumConfig = RumConfiguration.Builder(applicationId)

.build()

Rum.enable(rumConfig)

// Enable Profiling

val profilingConfig = ProfilingConfiguration.Builder()

.setApplicationLaunchSampleRate(15) // default is 15%

.build()

Profiling.enable(profilingConfig)

}

}

we can reduce indent

0xnm · 2026-01-25T23:14:30Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

+            Profiling.enable(profilingConfig)
+        }
+    }
+  ```


two spaces before can be removed

0xnm · 2026-01-25T23:14:48Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

+
+      // Enable Profiling feature
+      Profiling.enable(with: .init()) // default is 5%
+  ```


two spaces before can be removed

0xnm · 2026-01-25T23:15:40Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

+      import DatadogCore
+      import DatadogRUM
+      import DatadogProfiling
+
+      // Initialize Datadog SDK with your configuration
+      Datadog.initialize(
+        with: Datadog.Configuration(
+          clientToken: "<client token>",  // From Datadog UI
+          env: "<environment>",           // for example, "production", "staging"
+          service: "<service name>"       // Your app's service name
+        ),
+        trackingConsent: trackingConsent  // GDPR compliance setting
+      )
+
+      // Enable RUM feature
+      RUM.enable(
+        with: RUM.Configuration(
+          applicationID: "<rum application id>"
+        )
+      )
+
+      // Enable Profiling feature
+      Profiling.enable(with: .init()) // default is 5%


Suggested change

import DatadogCore

import DatadogRUM

import DatadogProfiling

// Initialize Datadog SDK with your configuration

Datadog.initialize(

with: Datadog.Configuration(

clientToken: "<client token>", // From Datadog UI

env: "<environment>", // for example, "production", "staging"

service: "<service name>" // Your app's service name

),

trackingConsent: trackingConsent // GDPR compliance setting

)

// Enable RUM feature

RUM.enable(

with: RUM.Configuration(

applicationID: "<rum application id>"

)

)

// Enable Profiling feature

Profiling.enable(with: .init()) // default is 5%

import DatadogCore

import DatadogRUM

import DatadogProfiling

// Initialize Datadog SDK with your configuration

Datadog.initialize(

with: Datadog.Configuration(

clientToken: "<client token>", // From Datadog UI

env: "<environment>", // for example, "production", "staging"

service: "<service name>" // Your app's service name

),

trackingConsent: trackingConsent // GDPR compliance setting

)

// Enable RUM feature

RUM.enable(

with: RUM.Configuration(

applicationID: "<rum application id>"

)

)

// Enable Profiling feature

Profiling.enable(with: .init()) // default is 5%

simaoseica-dd · 2026-01-26T10:45:51Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

+      )
+
+      // Enable Profiling feature
+      Profiling.enable(with: .init()) // default is 5%


iOS has a different sample rate of 5%

simaoseica-dd · 2026-01-26T10:53:31Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

+      )
+
+      // Enable Profiling feature
+      Profiling.enable(with: .init()) // default is 5%


I would simplify or go with the example in the google docs

Suggested change

Profiling.enable(with: .init()) // default is 5%

Profiling.enable() // default is 5%

or

Suggested change

Profiling.enable(with: .init()) // default is 5%

Profiling.enable(with: .init(applicationLaunchSampleRate: 5)) // custom sample rate (overrides the default 5%)

simaoseica-dd · 2026-01-26T11:09:24Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

+
+## Overview
+
+iOS profiling captures detailed data about your application's performance during launch, helping you identify slow functions and optimize startup time. iOS profiling is built on top of the [mach Kernel API][1] and samples all application threads to collect call stacks for all application processes. 


The "...for all application processes" is confusing

Suggested change

iOS profiling captures detailed data about your application's performance during launch, helping you identify slow functions and optimize startup time. iOS profiling is built on top of the [mach Kernel API][1] and samples all application threads to collect call stacks for all application processes.

iOS profiling captures detailed data about your application's performance during launch, helping you identify slow functions and optimize startup time. iOS profiling is built on top of the [mach Kernel API][1] and periodically samples all application threads to collect call stacks.

simaoseica-dd · 2026-01-26T11:16:12Z

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

+
+{{< img src="real_user_monitoring/ios/ios-profiling-session.png" alt="iOS profiling data in a view event to initial display vital event." style="width:90%;" >}}
+
+Use the flame graph, thread timeline, and call graph visualizations to analyze the profiling data for the time to initial display. You can also download the profiling data for external analysis.


@rtrieu iOS Profiling measures Wall time instead of CPU time

static/images/real_user_monitoring/ios/ios-profiling-ttid.png

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md

rtrieu

a few more tiny suggestions!

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md

Added Android and iOS Profiling docs. Added new index page for Correl…

bc80645

…ate RUM with Other Telemetry.

arti-arutiunov requested review from a team as code owners January 23, 2026 04:47

github-actions bot added Architecture Everything related to the Doc backend Images Images are added/removed with this PR labels Jan 23, 2026

arti-arutiunov requested review from 0xnm and simaoseica-dd January 23, 2026 04:50

ambushwork reviewed Jan 23, 2026

View reviewed changes

0xnm requested changes Jan 23, 2026

View reviewed changes

cswatt added the editorial review Waiting on a more in-depth review label Jan 23, 2026

arti-arutiunov added 2 commits January 23, 2026 14:06

Updated SDK code snippets and API for iOS and Android profiling

0d0bf65

Added screenshots and cleaned up language.

3e33ae3

arti-arutiunov requested review from 0xnm, ambushwork and rtrieu January 23, 2026 20:46

rtrieu requested changes Jan 23, 2026

View reviewed changes

arti-arutiunov and others added 3 commits January 24, 2026 22:00

Cleaned up language to match documentation guidelines

8d9abef

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

More clean-up for browser and iOS profiling documentation

d5bd058

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

Removed code tabs

946aeaf

arti-arutiunov requested a review from rtrieu January 25, 2026 03:18

0xnm approved these changes Jan 25, 2026

View reviewed changes

simaoseica-dd reviewed Jan 26, 2026

View reviewed changes

Cleaned up indentation and verbiage.

846db80

rtrieu reviewed Jan 26, 2026

View reviewed changes

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/android_profiling.md Show resolved Hide resolved

rtrieu requested changes Jan 26, 2026

View reviewed changes

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md Outdated Show resolved Hide resolved

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/ios_profiling.md Outdated Show resolved Hide resolved

Added thread timeline screenshots

018e7bf

rtrieu approved these changes Jan 26, 2026

View reviewed changes

arti-arutiunov added 2 commits January 27, 2026 14:00

Updated iOS profiling hero image

747d8b0

Updated iOS hero TTID vital image

c423c95

simaoseica-dd approved these changes Jan 28, 2026

View reviewed changes

Merge branch 'master' into Arti-Arutiunov/ios-android-profiling

4a84ddf

fitzage approved these changes Jan 28, 2026

View reviewed changes

arti-arutiunov merged commit 8572f08 into master Jan 28, 2026
20 checks passed

arti-arutiunov deleted the Arti-Arutiunov/ios-android-profiling branch January 28, 2026 18:02

	If no value is specified, the default <code>profilingMaximumRate</code> is 15 percent.
	If no value is specified, the default <code>applicationLaunchSampleRate</code> is 15 percent.

	Profiling.enable(with: .init()) // default is 5%
	Profiling.enable(with: .init()) // default is 15%

	Profiling.enable(with: .init()) // default is 5%
	Profiling.enable() // default is 5%

	Profiling.enable(with: .init()) // default is 5%
	Profiling.enable(with: .init(applicationLaunchSampleRate: 5)) // custom sample rate (overrides the default 5%)


		{{< img src="real_user_monitoring/ios/ios-profiling-session.png" alt="iOS profiling data in a view event to initial display vital event." style="width:90%;" >}}

		Use the flame graph, thread timeline, and call graph visualizations to analyze the profiling data for the time to initial display. You can also download the profiling data for external analysis.

	Use the flame graph, thread timeline, and call graph visualizations to analyze the profiling data for the time to initial display. You can also download the profiling data for external analysis.
	Use the flame graph to identify which functions consume the most Wall time during launch, the thread timeline to see parallel execution patterns, and the call graph to trace function dependencies. You can also download the profiling data for external analysis or deeper investigation.


		<div class="alert alert-warning">The total volume of profiles may not match the percentage configured in <code>applicationLaunchSampleRate</code>. This variation results from <a href="https://developer.android.com/topic/performance/tracing/profiling-manager/will-my-profile-always-be-collected#how-rate-limiting-works">rate limitations</a> within the data collector, including profiling support on older devices and the maximum profiling frequency per device.</div>

		The [ProfilingManager API][4] also supports disablng rate limiting during debug builds.

		[4]: /real_user_monitoring/application_monitoring/ios/application_launch_monitoring?tab=swift


		## Overview

		iOS profiling captures detailed data about your application's performance during launch, helping you identify slow functions and optimize startup time. iOS profiling is built on top of the [mach Kernel API][1] and samples all application threads to collect call stacks for all application processes.

Android and iOS Application Profiling in RUM #34078

Android and iOS Application Profiling in RUM #34078

Conversation

arti-arutiunov commented Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do? What is the motivation?

Merge instructions

Additional notes

Uh oh!

github-actions bot commented Jan 23, 2026

Preview links (active after the build_preview check completes)

New or renamed files

Modified Files

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cswatt commented Jan 23, 2026

Uh oh!

rtrieu left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

rtrieu Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rtrieu left a comment

Choose a reason for hiding this comment

Uh oh!

0xnm left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

arti-arutiunov commented Jan 23, 2026 •

edited

Loading

Preview links (active after the `build_preview` check completes)

rtrieu Jan 23, 2026 •

edited

Loading