Skip to content

Commit d2dabe9

Browse files
Update sourcemaps troubleshooting docs to focus on debugger modal
Co-authored-by: daniel.szoke <[email protected]>
1 parent 14dac89 commit d2dabe9

File tree

3 files changed

+27
-46
lines changed

3 files changed

+27
-46
lines changed

platform-includes/sourcemaps/legacy-troubleshooting/javascript.mdx

Lines changed: 9 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,17 @@
1-
Setting up source maps can be tricky, but it's worth it to get it right. To troubleshoot your source maps set up, you can either:
1+
Setting up source maps can be tricky, but it's worth it to get it right. To troubleshoot your source maps setup, you can use our built-in sourcemaps debugger modal directly in the Sentry product, or follow the manual steps listed below.
22

3-
1. Use our automated verification tool inside `sentry-cli`, or
4-
2. Follow the manual steps listed below
3+
## Use the Sourcemaps Debugger Modal
54

6-
## Use the Sentry CLI
5+
Sentry provides a built-in sourcemaps debugger modal that you can access directly from the **Issue Details** page. This tool helps you understand why your source maps might not be working correctly.
76

8-
To use the automated verification process, install and configure the Sentry [Command Line Interface](/cli/). Then, use the `sourcemaps explain` command, calling it with the relevant event ID, found in the top-left corner of the **Issue Details** page in [sentry.io](https://sentry.io).
7+
To use the debugger modal:
98

10-
For example, "Event ID: c2ad049f":
9+
1. Navigate to an issue in your Sentry project
10+
2. Click on the **Issue Details** page
11+
3. Look for the sourcemaps debugger option in the interface
12+
4. The debugger will analyze your source maps and provide detailed information about any issues
1113

12-
![Image highlighting where to find the ID of an event on Sentry](./img/event_id.png)
13-
14-
```shell
15-
sentry-cli sourcemaps explain c2ad049fd9e448ada7849df94575e019
16-
```
17-
18-
The CLI output should give you useful information about what went wrong with your source maps setup.
14+
This is the recommended approach for troubleshooting source maps issues as it provides real-time analysis and doesn't require any CLI tools.
1915

2016
<PlatformSection notSupported={["javascript.electron"]}>
2117

platform-includes/sourcemaps/legacy-uploading-methods/javascript.mdx

Lines changed: 9 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -269,30 +269,20 @@ Sentry.init({
269269

270270
If you followed all of the steps above but still have issues setting up source maps using the legacy method this section will try to help troubleshoot your setup.
271271

272-
To troubleshoot your source maps set up, you can either:
272+
To troubleshoot your source maps setup, you can use our built-in sourcemaps debugger modal directly in the Sentry product, or follow the manual steps listed below.
273273

274-
1. Use our automated verification tool inside `sentry-cli`, or
275-
2. Follow the manual steps listed below
274+
### Use the Sourcemaps Debugger Modal
276275

277-
### Use the Sentry CLI
276+
Sentry provides a built-in sourcemaps debugger modal that you can access directly from the **Issue Details** page. This tool helps you understand why your source maps might not be working correctly.
278277

279-
To use the automated verification process, install and configure the Sentry [Command Line Interface](/cli/). Then, use the `sourcemaps explain` command, calling it with the relevant event ID, found in the top-left corner of the **Issue Details** page in [sentry.io](https://sentry.io).
278+
To use the debugger modal:
280279

281-
<Alert title="Note" level="warning">
280+
1. Navigate to an issue in your Sentry project
281+
2. Click on the **Issue Details** page
282+
3. Look for the sourcemaps debugger option in the interface
283+
4. The debugger will analyze your source maps and provide detailed information about any issues
282284

283-
The `sourcemaps explain` command requires an auth token with the following scopes: `project:admin`, `release:admin`, `event:read`, and `organization:read`. We recommend creating an [internal integration token](/organization/integrations/integration-platform/internal-integration/) over a personal token.
284-
285-
</Alert>
286-
287-
For example, "Event ID: c2ad049f":
288-
289-
![Image highlighting where to find the ID of an event on Sentry](./img/event_id.png)
290-
291-
```shell
292-
sentry-cli sourcemaps explain c2ad049fd9e448ada7849df94575e019
293-
```
294-
295-
The CLI output should give you useful information about what went wrong with your source maps setup.
285+
This is the recommended approach for troubleshooting source maps issues as it provides real-time analysis and doesn't require any CLI tools.
296286

297287
<PlatformSection notSupported={["javascript.electron"]}>
298288

platform-includes/sourcemaps/troubleshooting/javascript.mdx

Lines changed: 9 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -30,25 +30,20 @@ Dependency versions that require the legacy method of uploading source maps incl
3030

3131
</Alert>
3232

33-
Setting up source maps can be tricky, but it's worth it to get it right. To troubleshoot your source maps set up, you can either:
33+
Setting up source maps can be tricky, but it's worth it to get it right. To troubleshoot your source maps setup, you can use our built-in sourcemaps debugger modal directly in the Sentry product, or follow the manual steps listed below.
3434

35-
1. Use our automated verification tool inside `sentry-cli`, or
36-
2. Follow the manual steps listed below
35+
## Use the Sourcemaps Debugger Modal
3736

38-
## Use the CLI
37+
Sentry provides a built-in sourcemaps debugger modal that you can access directly from the **Issue Details** page. This tool helps you understand why your source maps might not be working correctly.
3938

40-
To use the automated verification process, install and configure the Sentry [Command Line Interface](/cli/). Then, use the `sourcemaps explain` command, calling it with the relevant event ID, found in the top-left corner of the **Issue Details** page in [sentry.io](https://sentry.io).
39+
To use the debugger modal:
4140

42-
For example, "Event ID: c2ad049f":
41+
1. Navigate to an issue in your Sentry project
42+
2. Click on the **Issue Details** page
43+
3. Look for the sourcemaps debugger option in the interface
44+
4. The debugger will analyze your source maps and provide detailed information about any issues
4345

44-
![Image highlighting where to find the ID of an event on Sentry](./img/event_id.png)
45-
46-
```shell
47-
sentry-cli sourcemaps explain c2ad049fd9e448ada7849df94575e019
48-
```
49-
50-
The CLI output should give you useful information about what went wrong with your source maps setup.
51-
If it doesn't, let us know by filing an issue on our [Sentry CLI repo](https://github.com/getsentry/sentry-cli) so we can make it better.
46+
This is the recommended approach for troubleshooting source maps issues as it provides real-time analysis and doesn't require any CLI tools.
5247

5348
## Follow Manual Steps
5449

0 commit comments

Comments
 (0)