This is an example showing how to use Sentry to catch & report errors on both client + server side, using the official Sentry SDK for Next.js.
_app.js
renders on both the server and client_error.js
is rendered by Next.js while handling certain types of exceptions for you. It is overridden so those exceptions can be passed along to Sentry- Each API route is handled with
withSentry
next.config.js
automatically configures the app to use Sentry throughwithSentry
Preview the example live on StackBlitz:
Once you have access to your Sentry DSN, deploy the example using Vercel:
Check out Sentry’s Vercel Integration.
Execute create-next-app
with npm or Yarn to bootstrap the example:
npx create-next-app --example with-sentry with-sentry-app
# or
yarn create next-app --example with-sentry with-sentry-app
You can configure your app automatically or do the manual setup.
Both ways lead to having your custom config files (next.config.js
, sentry.client.config.js
, sentry.server.config.js
, and sentry.properties
); so you can delete them from the example, they are here to illustrate how an example app looks like.
You can deploy this app to the cloud with Vercel (Documentation).
To deploy your local project to Vercel, push it to GitHub/GitLab/Bitbucket and import to Vercel.
Important: When you import your project on Vercel, make sure to click on Environment Variables and set them to match your .env.local
file.
Alternatively, you can deploy using our template by clicking on the Deploy button below.
Sentry’s Vercel Integration connects your Sentry and Vercel projects to automatically upload source maps and notify Sentry of release deployment. Learn more about this integration in Sentry’s full documentation.