Skip to content

[RUM] Document manual debug symbol upload (UI and API)#37943

Draft
qsellem wants to merge 1 commit into
masterfrom
quentin.sellem/rum_manual_upload_debug_symbols
Draft

[RUM] Document manual debug symbol upload (UI and API)#37943
qsellem wants to merge 1 commit into
masterfrom
quentin.sellem/rum_manual_upload_debug_symbols

Conversation

@qsellem

@qsellem qsellem commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Documents that customers can now upload debug symbols / source maps manually — from the Debug Symbols page in the Datadog UI (/source-code/setup/rum), or programmatically via the public source map upload API — in addition to the existing automated CI/CD upload. Until now, every RUM symbolication page described CI/CD upload only, and the Debug Symbols page was referenced solely for viewing uploaded symbols.

Changes

Adds manual-upload (UI + API) guidance as an alternative path across the RUM docs, with consistent phrasing:

  • Hubs: guide/debug-symbols.md (lead, missing-symbols troubleshooting, supported types incl. Unity + native ELF/PE), error_tracking/_index.md (new Upload debug symbols section), _index.md (RUM landing).
  • Browser: JS source maps guide + build-plugin pages (source_maps, source_code_context, _index).
  • Mobile: iOS (dSYM), Android (ProGuard/R8 + NDK), Flutter, React Native, Expo, CodePush — both the error_tracking/mobile/* and application_monitoring/*/error_tracking variants.
  • Unity: IL2CPP symbol files.
  • C/C++: expands the Symbolication section to document native ELF (Linux) and PE/PDB (Windows) symbol formats and both upload paths.

All existing CI/CD instructions are preserved; changes are additive (+104 / −7).

Notes for reviewers

  • UI support for native ELF/PE is in progress — this documents it alongside the API (which already supports elf_symbol_file / pe_symbol_file). Hold merge of the C/C++ UI-specific wording until that UI support ships if preferred.
  • Pre-existing unrelated broken ref [14] in error_tracking/mobile/expo.md (line 177) was left untouched to keep scope focused.

Customers can now upload debug symbols / source maps manually from the
Debug Symbols page in the Datadog UI, or via the public source map
upload API, in addition to automated CI/CD upload.

Adds this as an alternative upload path across the RUM error-tracking
docs (browser, iOS, Android, Flutter, React Native, Expo, Unity, C/C++),
the debug-symbols guide, the JS source maps guide, and the Error
Tracking hub. Documents native ELF (Linux) and PE/PDB (Windows) symbol
formats for the C++ SDK.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added the Guide Content impacting a guide label Jul 2, 2026
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant