Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 53 additions & 0 deletions docs/platforms/javascript/common/troubleshooting/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,59 @@ If you set up the Sentry SDK and it's not sending any data to Sentry:

</Expandable>

<PlatformSection supported={["javascript.nextjs"]}>

<Expandable permalink title="Next.js Setup Verification Checklist">

Use this checklist to systematically verify your Next.js Sentry setup:

<VerificationChecklist checklistId="nextjs-troubleshooting">
<ChecklistItem
id="config-files-exist"
label="Configuration files exist"
description="Verify that instrumentation-client.ts, sentry.server.config.ts, and sentry.edge.config.ts exist in your project root."
/>
<ChecklistItem
id="dsn-configured"
label="DSN is configured correctly"
description="Check that each config file has a valid DSN. The DSN should start with https:// and contain your project ID."
/>
<ChecklistItem
id="next-config-wrapped"
label="next.config.ts uses withSentryConfig"
description="Your Next.js config should be wrapped with withSentryConfig from @sentry/nextjs."
/>
<ChecklistItem
id="global-error-exists"
label="global-error.tsx exists (App Router)"
description="For App Router, check that app/global-error.tsx exists to capture React rendering errors."
/>
<ChecklistItem
id="no-adblocker"
label="Ad-blocker is disabled"
description="Ad-blockers can block requests to Sentry. Disable them or configure tunnelRoute in your next.config.ts."
/>
<ChecklistItem
id="check-console"
label="No errors in browser console"
description="Open browser DevTools and check for any Sentry-related errors. Add debug: true to Sentry.init() for more details."
/>
<ChecklistItem
id="check-network"
label="Network requests are being sent"
description="In DevTools Network tab, filter for 'sentry' or 'envelope'. You should see requests when errors occur."
/>
<ChecklistItem
id="check-quota"
label="Sentry quota is not exceeded"
description="Check your Sentry Stats and Subscription pages to ensure you haven't exceeded your quota."
/>
</VerificationChecklist>

</Expandable>

</PlatformSection>

<Expandable permalink title="Updating to a new Sentry SDK version">

If you update your Sentry SDK to a new major version, you might encounter breaking changes that need some adaption on your end.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ keywords:
]
---

The Sentry Next.js SDK supports automatic code injection and source map upload during your app's build process using the `withSentryConfig` wrapper in your Next.js configuration file (`next.config.js` or `next.config.mjs`). For information on updating the configuration, see [Extend Next.js Configuration](../../manual-setup/#extend-your-nextjs-configuration).
The Sentry Next.js SDK supports automatic code injection and source map upload during your app's build process using the `withSentryConfig` wrapper in your Next.js configuration file (`next.config.js` or `next.config.mjs`). For information on updating the configuration, see the [Manual Setup guide](/platforms/javascript/guides/nextjs/manual-setup/#configure).

## Available Options

Expand Down
Loading
Loading