Skip to content

Conversation

@MaelNamNam
Copy link
Contributor

What does this PR do? What is the motivation?

The RUM SDK Benchmark Docs used to be nested under the Android section, while it covers both our Android and iOS SDKs. This PR fixes this by splitting the docs in two pages, one that stays under the Android section, and the other that moves to iOS.

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

@MaelNamNam MaelNamNam marked this pull request as ready for review November 7, 2025 09:00
@MaelNamNam MaelNamNam requested a review from a team as a code owner November 7, 2025 09:00
@MaelNamNam MaelNamNam requested a review from a team November 7, 2025 09:01
@MaelNamNam MaelNamNam self-assigned this Nov 7, 2025
@MaelNamNam MaelNamNam added the real_user_monitoring Content changed in the real_user_monitoring folder label Nov 7, 2025
@MaelNamNam MaelNamNam requested a review from rtrieu November 7, 2025 09:25
Copy link
Contributor

@aleksandr-gringauz aleksandr-gringauz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for fixing this!

Copy link
Contributor

@rtrieu rtrieu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for this PR! left some feedback and suggestions for your review. i'm going to make a commit to add the ios sdk performance impact page to the left nav.

Datadog has an internal infrastructure of continuous benchmarking. There is an internal set of UI tests that run on a special benchmark application for every change made to the SDK. This way Datadog is able to detect performance regression early to ensure that they are prevented from reaching production releases.

You can find the source code of the benchmark app here: [Android][3], [iOS][4].
You can find the source code of the benchmark app [here][2].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can find the source code of the benchmark app [here][2].
See the [benchmark app source code][2].

| Bundle size | 23.6 MB | 22.2 MB |
| Network usage | 21.88 KB sent, 1.68 KB received | n/a |

You can read the following [page][1] for more details about these benchmarks.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can read the following [page][1] for more details about these benchmarks.
See the [SDK performance details on GitHub][2] for more information.


## Continuous benchmarks

Datadog has an internal infrastructure of continuous benchmarking. There is an internal set of UI tests that run on a special benchmark application for every change made to the SDK. This way Datadog is able to detect performance regression early to ensure that they are prevented from reaching production releases.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Datadog has an internal infrastructure of continuous benchmarking. There is an internal set of UI tests that run on a special benchmark application for every change made to the SDK. This way Datadog is able to detect performance regression early to ensure that they are prevented from reaching production releases.
Datadog has an internal infrastructure of continuous benchmarking. UI tests run automatically on a benchmark application for every SDK change. This enables Datadog to detect performance regressions early to ensure that they are prevented from reaching production releases.


## Performance impact benchmarks

To simulate the typical usage of Datadog SDK, it was integrated into the [Beam][3] application and typical user behavior (scrolling the feed, browsing reddits) was simulated.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To simulate the typical usage of Datadog SDK, it was integrated into the [Beam][3] application and typical user behavior (scrolling the feed, browsing reddits) was simulated.
To simulate the typical usage of Datadog SDK, it was integrated into the [Beam][1] application and typical user behavior (scrolling the feed, browsing subreddits) was simulated.


To simulate the typical usage of Datadog SDK, it was integrated into the [Beam][3] application and typical user behavior (scrolling the feed, browsing reddits) was simulated.

The SDK features that were used:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The SDK features that were used:
The SDK features used:


{{< partial name="whats-next/whats-next.html" >}}

[2]: https://github.com/DataDog/dd-sdk-ios/blob/develop/docs/sdk_performance.md
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[2]: https://github.com/DataDog/dd-sdk-ios/blob/develop/docs/sdk_performance.md
[1]: https://github.com/awkward/beam

{{< partial name="whats-next/whats-next.html" >}}

[2]: https://github.com/DataDog/dd-sdk-ios/blob/develop/docs/sdk_performance.md
[4]: https://github.com/DataDog/dd-sdk-ios/tree/develop/BenchmarkTests
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[4]: https://github.com/DataDog/dd-sdk-ios/tree/develop/BenchmarkTests
[2]: https://github.com/DataDog/dd-sdk-ios/blob/develop/docs/sdk_performance.md


[2]: https://github.com/DataDog/dd-sdk-ios/blob/develop/docs/sdk_performance.md
[4]: https://github.com/DataDog/dd-sdk-ios/tree/develop/BenchmarkTests
[3]: https://github.com/awkward/beam
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[3]: https://github.com/awkward/beam
[3]: https://github.com/DataDog/dd-sdk-ios/tree/develop/BenchmarkTests


Datadog has an internal infrastructure of continuous benchmarking. There is an internal set of UI tests that run on a special benchmark application for every change made to the SDK. This way Datadog is able to detect performance regression early to ensure that they are prevented from reaching production releases.

You can find the source code of the benchmark app [here][2].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can find the source code of the benchmark app [here][2].
See the [benchmark app's source code on GitHub][3].


## Overview

When integrating any SDK into your iOS application, understanding its performance impact is crucial for maintaining a smooth user experience. The Datadog RUM SDK is designed with performance in mind and provides transparent measurements to help you make informed decisions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When integrating any SDK into your iOS application, understanding its performance impact is crucial for maintaining a smooth user experience. The Datadog RUM SDK is designed with performance in mind and provides transparent measurements to help you make informed decisions.
When integrating any SDK into your iOS application, understanding its performance impact is crucial for maintaining a smooth user experience. The Datadog RUM SDK is designed with minimal performance overhead. Use these benchmarks to evaluate whether the SDK fits your app's performance budget and plan your integration accordingly.

@github-actions github-actions bot added the Architecture Everything related to the Doc backend label Nov 7, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend real_user_monitoring Content changed in the real_user_monitoring folder

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants