Skip to content

Commit aea180b

Browse files
authored
Add "don't upload gzipped files" to source map troubleshooting (#781)
1 parent 6fa89f2 commit aea180b

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

docs/sourcemaps.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -366,3 +366,13 @@ For an individual artifact, Sentry accepts a max filesize of **40 MB**.
366366

367367
Often users hit this limit because they are transmitting source files at an interim build stage. For example, after Webpack/Browserify has combined all
368368
your source files, but before minification has taken place. If possible, send the original source files.
369+
370+
Verify artifacts are not gzipped
371+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
372+
373+
The Sentry API currently only works with source maps and source files that are uploaded as plain text (UTF-8 encoded). If the files are uploaded in a
374+
compressed format (e.g. gzip), they will be not be interpreted correctly.
375+
376+
This sometimes occurs with build scripts and plugins that produce pre-compressed minified files. For example, Webpack's `compression plugin
377+
<https://github.com/webpack/compression-webpack-plugin>`_. You'll need to disable such plugins and perform the compression _after_
378+
the generated source maps / source files have been uploaded to Sentry.

0 commit comments

Comments
 (0)