Skip to content

Clarify that RUM geo.* attributes are derived from client IP, not device GPS - #36213

Merged
yuandesu merged 5 commits into
masterfrom
yuandesu/clarify-rum-geo-derived-from-client-ip
Apr 27, 2026
Merged

Clarify that RUM geo.* attributes are derived from client IP, not device GPS#36213
yuandesu merged 5 commits into
masterfrom
yuandesu/clarify-rum-geo-derived-from-client-ip

Conversation

@yuandesu

@yuandesu yuandesu commented Apr 23, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

  1. Users have reported that geo.city attributes shows a location different from where their device physically is — particularly on mobile (SIM) connections.

  2. After confirming with the engineering team, it is clear that the Android/iOS SDK does not access the device's GPS or OS location API. All geo.* attributes are resolved server-side from the client IP address on the intake connection.

  3. This PR adds a clarifying sentence to the Geo-location section in the Android/iOS data collected pages to make this behavior explicit, helping users understand why geo.* may reflect a carrier's gateway location rather than the device's actual location on mobile connections.

Changes made to:

  • layouts/shortcodes/mdoc/en/sdk/data_collected/android.mdoc.md
  • layouts/shortcodes/mdoc/en/sdk/data_collected/ios.mdoc.md

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.

AI assistance

Used Claude Code for initial draft and update.

Additional notes

@yuandesu
yuandesu requested a review from a team as a code owner April 23, 2026 02:36
@yuandesu
yuandesu force-pushed the yuandesu/clarify-rum-geo-derived-from-client-ip branch 2 times, most recently from 99aa236 to 11cb958 Compare April 23, 2026 02:45
@yuandesu
yuandesu requested a review from a team as a code owner April 23, 2026 02:45
@github-actions github-actions Bot added Architecture Everything related to the Doc backend cdocs labels Apr 23, 2026
@yuandesu
yuandesu force-pushed the yuandesu/clarify-rum-geo-derived-from-client-ip branch from 11cb958 to 0a4fd89 Compare April 23, 2026 03:04
@yuandesu
yuandesu force-pushed the yuandesu/clarify-rum-geo-derived-from-client-ip branch from 0a4fd89 to 08e98f3 Compare April 23, 2026 14:50

@iadjivon iadjivon left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hi there,
Added some suggestions and a clarifying question here.

Thanks!

Comment thread layouts/shortcodes/mdoc/en/sdk/data_collected/android.mdoc.md Outdated
Comment thread layouts/shortcodes/mdoc/en/sdk/data_collected/ios.mdoc.md Outdated
@domalessi

Copy link
Copy Markdown
Contributor

Whoops - I approved on behalf of cdocs-reviewers, but please address @iadjivon 's feedback before merging! Thanks!

@yuandesu
yuandesu force-pushed the yuandesu/clarify-rum-geo-derived-from-client-ip branch from 08e98f3 to e225455 Compare April 24, 2026 04:56
@yuandesu
yuandesu force-pushed the yuandesu/clarify-rum-geo-derived-from-client-ip branch from e225455 to 9e73e04 Compare April 24, 2026 05:02
Comment thread layouts/shortcodes/mdoc/en/sdk/data_collected/android.mdoc.md Outdated
Comment thread layouts/shortcodes/mdoc/en/sdk/data_collected/ios.mdoc.md Outdated

@iadjivon iadjivon left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Added a quick note but approved this!
Thanks so much for the conversation about this!

yuandesu and others added 3 commits April 27, 2026 11:07
Co-authored-by: Ida Adjivon <65119712+iadjivon@users.noreply.github.com>
Co-authored-by: Ida Adjivon <65119712+iadjivon@users.noreply.github.com>
@yuandesu
yuandesu merged commit 4972db4 into master Apr 27, 2026
14 checks passed
@yuandesu
yuandesu deleted the yuandesu/clarify-rum-geo-derived-from-client-ip branch April 27, 2026 02:38
estherk15 pushed a commit that referenced this pull request May 4, 2026
…ice GPS (#36213)

* Clarify that RUM geo.* attributes are resolved from client IP, not device GPS

* Update layouts/shortcodes/mdoc/en/sdk/data_collected/android.mdoc.md

Co-authored-by: Ida Adjivon <65119712+iadjivon@users.noreply.github.com>

* Update layouts/shortcodes/mdoc/en/sdk/data_collected/ios.mdoc.md

Co-authored-by: Ida Adjivon <65119712+iadjivon@users.noreply.github.com>

---------

Co-authored-by: Ida Adjivon <65119712+iadjivon@users.noreply.github.com>
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 cdocs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants