Skip to content

Commit c4220a7

Browse files
fdehauclaude
andauthored
Fix circular reference and improve source maps documentation (#33757)
The browser error tracking page was linking to the app URL which then linked back to the same page, creating a circular loop. Changes: - Fix circular reference by changing link [17] in browser.md to point to the upload guide documentation instead of the app URL - Move "See all uploaded symbols" information from browser.md to the upload guide where it's more contextually relevant - Remove redundant "Manage uploaded source maps" section from browser.md - Fix "the the" typo in upload guide - Fix markdown bold syntax to HTML in alert blocks 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Sonnet 4.5 <[email protected]>
1 parent 92a989f commit c4220a7

File tree

2 files changed

+6
-11
lines changed

2 files changed

+6
-11
lines changed

content/en/error_tracking/frontend/browser.md

Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -198,14 +198,6 @@ Learn more about [tagging][19] in Datadog.
198198

199199
Refer to the [Browser SDK API Reference][9] for the full list of available configuration options.
200200

201-
## Advanced features (optional)
202-
203-
### Manage uploaded source maps
204-
205-
See all uploaded symbols and manage your source maps on the [Explore RUM Debug Symbols][17] page.
206-
207-
**Note**: Source maps are limited in size to **500 MB** each.
208-
209201
## Next steps
210202

211203
You can monitor unhandled exceptions, unhandled promise rejections, handled exceptions, handled promise rejections, and other errors that the Browser SDK does not automatically track. Learn more about [Collecting Browser Errors][3].
@@ -230,6 +222,6 @@ You can monitor unhandled exceptions, unhandled promise rejections, handled exce
230222
[14]: https://bitbucket.org/product
231223
[15]: /integrations/guide/source-code-integration/
232224
[16]: /error_tracking/explorer
233-
[17]: https://app.datadoghq.com/source-code/setup/rum
225+
[17]: /real_user_monitoring/guide/upload-javascript-source-maps
234226
[18]: /getting_started/tagging/unified_service_tagging/
235227
[19]: /getting_started/tagging/

content/en/real_user_monitoring/guide/upload-javascript-source-maps.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ If your front-end JavaScript source code is minified, upload your source maps to
2424
Configure your JavaScript bundler such that when minifying your source code, it generates source maps that directly include the related source code in the `sourcesContent` attribute.
2525

2626
<div class="alert alert-danger">
27-
Ensure that the size of each source map augmented with the size of the related minified file does not exceed the limit of **500 MB**.
27+
Ensure that the size of each source map augmented with the size of the related minified file does not exceed the limit of <b>500 MB</b>.
2828
</div>
2929

3030
See the following configurations for popular JavaScript bundlers.
@@ -104,7 +104,7 @@ See the following example:
104104
```
105105

106106
<div class="alert alert-danger">
107-
If the sum of the file size for <code>javascript.364758.min.js</code> and <code>javascript.364758.js.map</code> exceeds the <b>the 500 MB</b> limit, reduce it by configuring your bundler to split the source code into multiple smaller chunks. For more information, see <a href="https://webpack.js.org/guides/code-splitting/">Code Splitting with WebpackJS</a>.
107+
If the sum of the file size for <code>javascript.364758.min.js</code> and <code>javascript.364758.js.map</code> exceeds the <b>500 MB</b> limit, reduce it by configuring your bundler to split the source code into multiple smaller chunks. For more information, see <a href="https://webpack.js.org/guides/code-splitting/">Code Splitting with WebpackJS</a>.
108108
</div>
109109

110110
## Upload your source maps
@@ -157,6 +157,8 @@ Only source maps with the `.js.map` extension work to correctly unminify stack t
157157

158158
<div class="alert alert-info">If you are serving the same JavaScript source files from different subdomains, upload the related source map once and make it work for multiple subdomains by using the absolute prefix path instead of the full URL. For example, specify <code>/static/js</code> instead of <code>https://hostname.com/static/js</code>.</div>
159159

160+
See all uploaded symbols and manage your source maps on the [Explore RUM Debug Symbols][5] page.
161+
160162
### Link stack frames to your source code
161163

162164
If you run `datadog-ci sourcemaps upload` within a Git working directory, Datadog collects repository metadata. The `datadog-ci` command collects the repository URL, the current commit hash, and the list of file paths in the repository that relate to your source maps. For more details about Git metadata collection, refer to the [datadog-ci documentation][4].
@@ -183,3 +185,4 @@ On the other hand, an unminified stack trace provides you with all the context y
183185
[2]: https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/setup/#initialization-parameters
184186
[3]: https://docs.datadoghq.com/logs/log_collection/javascript/#initialization-parameters
185187
[4]: https://github.com/DataDog/datadog-ci/tree/master/packages/datadog-ci/src/commands/sourcemaps#link-errors-with-your-source-code
188+
[5]: https://app.datadoghq.com/source-code/setup/rum

0 commit comments

Comments
 (0)