# Official Sentry SDK for Next.js [![npm version](https://img.shields.io/npm/v/@sentry/nextjs.svg)](https://www.npmjs.com/package/@sentry/nextjs) [![npm dm](https://img.shields.io/npm/dm/@sentry/nextjs.svg)](https://www.npmjs.com/package/@sentry/nextjs) [![npm dt](https://img.shields.io/npm/dt/@sentry/nextjs.svg)](https://www.npmjs.com/package/@sentry/nextjs) ## Links - [Official SDK Docs](https://docs.sentry.io/platforms/javascript/guides/nextjs/) - [TypeDoc](http://getsentry.github.io/sentry-javascript/) ## Compatibility Currently, the minimum Next.js supported version is `11.2.0`. ## General This package is a wrapper around `@sentry/node` for the server and `@sentry/react` for the client, with added functionality related to Next.js. To use this SDK, initialize it in the Next.js configuration, in the `sentry.client.config.ts|js` file, and in the [Next.js Instrumentation Hook](https://nextjs.org/docs/app/building-your-application/optimizing/instrumentation) (`instrumentation.ts|js`). ```javascript // next.config.js const { withSentryConfig } = require('@sentry/nextjs'); const nextConfig = { experimental: { // The instrumentation hook is required for Sentry to work on the serverside instrumentationHook: true, }, }; // Wrap the Next.js configuration with Sentry module.exports = withSentryConfig(nextConfig); ``` ```javascript // sentry.client.config.js or .ts import * as Sentry from '@sentry/nextjs'; Sentry.init({ dsn: '__DSN__', // Your Sentry configuration for the Browser... }); ``` ```javascript // instrumentation.ts import * as Sentry from '@sentry/nextjs'; export function register() { if (process.env.NEXT_RUNTIME === 'nodejs') { Sentry.init({ dsn: '__DSN__', // Your Node.js Sentry configuration... }); } if (process.env.NEXT_RUNTIME === 'edge') { Sentry.init({ dsn: '__DSN__', // Your Edge Runtime Sentry configuration... }); } } ``` To set context information or send manual events, use the exported functions of `@sentry/nextjs`. ```javascript import * as Sentry from '@sentry/nextjs'; // Set user information, as well as tags and further extras Sentry.setExtra('battery', 0.7); Sentry.setTag('user_mode', 'admin'); Sentry.setUser({ id: '4711' }); // Add a breadcrumb for future events Sentry.addBreadcrumb({ message: 'My Breadcrumb', // ... }); // Capture exceptions, messages or manual events Sentry.captureMessage('Hello, world!'); Sentry.captureException(new Error('Good bye')); Sentry.captureEvent({ message: 'Manual', stacktrace: [ // ... ], }); ```

	Stars	Issues	Version	Updated	Created
@sentry/nextjs	7,671	407	8.0.0	3 days ago	3 years ago
airbrake-js	422	26	1.6.8	5 years ago	10 years ago
bugsnag	48	0	2.4.3	6 years ago	12 years ago
bugsnag-js			4.7.3	6 years ago	9 years ago
trackjs-node	30	1	1.1.0	a month ago	5 years ago

@sentry/nextjs vs airbrake-js vs bugsnag vs bugsnag-js vs trackjs-node

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past