Skip to content

Commit

Permalink
Recommend to check symbolicator if source maps are not working on S…
Browse files Browse the repository at this point in the history
…elf-Hosted
  • Loading branch information
lforst committed Nov 8, 2024
1 parent 974baee commit b3ccf6c
Show file tree
Hide file tree
Showing 3 changed files with 19 additions and 8 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -239,7 +239,12 @@ Sometimes build scripts and plugins produce pre-compressed minified files (for e

If you're <PlatformLink to="/sourcemaps/uploading/hosting-publicly/">hosting your source maps publicly</PlatformLink>, make sure you have the "Enable JavaScript source fetching" option activated under **[Settings] > Projects > Select your project > General Settings**.

## Verify workers are sharing the same volume as web (if running self-hosted Sentry via Docker)
## (Self-Hosted Sentry) Verify the `symbolicator` service is operating normally

If you are running a self-hosted version of Sentry, verify that the `symbolicator` service/container is operating normally.
You can do so by checking the container's logs.

## (Self-Hosted Sentry via Docker) Verify workers are sharing the same volume as web

Sentry does source map calculation in its workers. This means the workers need access to the files uploaded through the front end. Double check that the cron workers and web workers can read/write files from the same disk.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -73,16 +73,15 @@ export default defineConfig({
],
});
```
</PlatformSection>

</PlatformSection>

## Uploading using Sentry Webpack Plugin Version 1.x

Assuming you have the `@sentry/webpack` package installed on version `1.x`, you can learn more on how to configure the plugin in the [Sentry webpack plugin v1 documentation](https://github.com/getsentry/sentry-webpack-plugin#readme).

Example:


```javascript {filename:webpack.config.js}
const SentryWebpackPlugin = require("@sentry/webpack-plugin");

Expand Down Expand Up @@ -111,7 +110,6 @@ module.exports = {

The Sentry webpack plugin will automatically inject a release value into the SDK so you must either omit the `release` option from `Sentry.init` or make sure `Sentry.init`'s `release` option matches the plugin's `release` option exactly:


```javascript
Sentry.init({
dsn: "___PUBLIC_DSN___",
Expand All @@ -136,7 +134,6 @@ This applies when using the following packages on version `2.x` and above:

Example of using the `release.uploadLegacySourcemaps` option:


```javascript {filename:webpack.config.js} {tabTitle:Webpack}
const { sentryWebpackPlugin } = require("@sentry/webpack-plugin");

Expand Down Expand Up @@ -251,7 +248,6 @@ export default {

The Sentry bundler plugins will automatically inject a release value into the SDK so you must either omit the `release` option from `Sentry.init` or make sure `Sentry.init`'s `release` option matches the plugin's `release.name` option exactly:


```javascript
Sentry.init({
dsn: "___PUBLIC_DSN___",
Expand Down Expand Up @@ -506,7 +502,12 @@ If you are using `sentry-cli` to upload your artifacts, starting with version `2

Sometimes build scripts and plugins produce pre-compressed minified files (for example, webpack's [compression plugin](https://github.com/webpack/compression-webpack-plugin)). In these cases, you'll need to disable such plugins and perform the compression **after** the generated source maps/source files have been uploaded to Sentry.

### Verify workers are sharing the same volume as web (if running self-hosted Sentry via Docker)
### (Self-Hosted Sentry) Verify the `symbolicator` service is operating normally

If you are running a self-hosted version of Sentry, verify that the `symbolicator` service/container is operating normally.
You can do so by checking the container's logs.

### (Self-Hosted Sentry via Docker) Verify workers are sharing the same volume as web

Sentry does source map calculation in its workers. This means the workers need access to the files uploaded through the front end. Double check that the cron workers and web workers can read/write files from the same disk.

Expand Down
7 changes: 6 additions & 1 deletion platform-includes/sourcemaps/troubleshooting/javascript.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -166,10 +166,15 @@ Sometimes build scripts and plugins produce pre-compressed minified files (for e
### Verify Source Fetching is Enabled

If you're <PlatformLink to="/sourcemaps/uploading/hosting-publicly/">hosting your source maps publicly</PlatformLink>, make sure you have the "Enable JavaScript source fetching" option activated under **[Settings] > Projects > Select your project > General Settings**.

</PlatformSection>

### (Self-Hosted Sentry) Verify the `symbolicator` service is operating normally

If you are running a self-hosted version of Sentry, verify that the `symbolicator` service/container is operating normally.
You can do so by checking the container's logs.

### Verify Workers Are Sharing Same Volume as Web (if running self-hosted Sentry via Docker)
### (Self-Hosted Sentry via Docker) Verify workers are sharing the same volume as web

Sentry does source map calculation in its workers. This means the workers need access to the files uploaded through the front end. Double check that the cron workers and web workers can read/write files from the same disk.

Expand Down

0 comments on commit b3ccf6c

Please sign in to comment.