@sentry/nextjs
v8.37.1
Published
Official Sentry SDK for Next.js
Downloads
5,868,013
Maintainers
Keywords
Readme
Official Sentry SDK for Next.js
See the Official Sentry Next.js SDK Docs to get started.
Compatibility
Currently, the minimum supported version of Next.js is 13.2.0
.
Installation
To get started installing the SDK, use the Sentry Next.js Wizard by running the following command in your terminal or read the Getting Started Docs:
npx @sentry/wizard@latest -i nextjs
The wizard will prompt you to log in to Sentry. After the wizard setup is completed, the SDK will automatically capture unhandled errors, and monitor performance.
Custom Usage
To set context information or to send manual events, you can use @sentry/nextjs
as follows:
import * as Sentry from '@sentry/nextjs';
// Set user information, as well as tags and further extras
Sentry.setTag('user_mode', 'admin');
Sentry.setUser({ id: '4711' });
Sentry.setContext('application_area', { location: 'checkout' });
// Add a breadcrumb for future events
Sentry.addBreadcrumb({
message: '"Add to cart" clicked',
// ...
});
// Capture exceptions or messages
Sentry.captureException(new Error('Oh no.'));
Sentry.captureMessage('Hello, world!');