diff --git a/docs/platforms/javascript/common/troubleshooting/index.mdx b/docs/platforms/javascript/common/troubleshooting/index.mdx index d938566e980ed..d619e0543cfcd 100644 --- a/docs/platforms/javascript/common/troubleshooting/index.mdx +++ b/docs/platforms/javascript/common/troubleshooting/index.mdx @@ -6,6 +6,20 @@ notSupported: ["javascript.capacitor"] sidebar_order: 9000 --- + + +If you set up the Sentry SDK and it's not sending any data to Sentry: + +- Check that you have configured a DSN and that you are passing it to the `dsn` option in `Sentry.init()`. + + If you are using environment variables to pass the DSN, make sure the environment variables are set in all relevant environments. Additionally, if you are using environment variables inside a framework, check that the framework will include the environment variables in your bundle. Often this means you will have to prefix your environment variables with special prefixes defined by your framework (`NEXT_PUBLIC_` in Next.js, `NUXT_` in Nuxt, `VITE_` for Vite projects, `REACT_APP_` for Create React App, ...). + +- Check that you have disabled any ad-blockers. +- Set `debug: true` in the `Sentry.init()` options and observe your console output when you start your application. The SDK may tell you why it is not sending any data. +- Check the [Stats](https://sentry.io/orgredirect/organizations/:orgslug/stats/) and [Suscription](https://sentry.io/orgredirect/organizations/:orgslug/settings/billing/overview/) pages in Sentry. You may have ran out of quota. + + + If you update your Sentry SDK to a new major version, you might encounter breaking changes that need some adaption on your end.