JavaScript
On this page, we get you up and running with Sentry's SDK, so that it will automatically report errors and exceptions in your application.
If you don't already have an account and Sentry project established, head over to sentry.io, then return to this page.
Install
Sentry captures data by using an SDK within your application’s runtime:
# Using yarn
yarn add @sentry/browser @sentry/tracing
# Using npm
npm install --save @sentry/browser @sentry/tracingWe also support alternate installation methods.
Configure
Configure Sentry as early as possible in your app. Once this is done, the Sentry SDK captures all unhandled exceptions.
This snippet:
- Uses
process.env.npm_package_versionto configure the version of your application. Learn more about releases and how they are used with source maps. - Instruments your SDK to monitor the performance of browser applications.
To reduce the volume of performance data captured, or disable it entirely, change tracesSampleRate to a value between 0 and 1 in production.
import * as Sentry from "@sentry/browser";
import { Integrations } from "@sentry/tracing";
Sentry.init({
dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
release: "my-project-name@" + process.env.npm_package_version, // To set your release version
integrations: [new Integrations.BrowserTracing()],
tracesSampleRate: 1.0, // We recommend adjusting this in production
});We'll automatically assign you a Data Source Name (DSN), which looks like a standard URL. It's required by Sentry and configures the protocol, public key, server address, and project identifier. If you forget it, view Settings -> Projects -> Client Keys (DSN) in sentry.io.
Verify
This snippet includes an intentional error, so you can test that everything is working as soon as you set it up:
myUndefinedFunction();To view and resolve the recorded error, log into sentry.io and open your project. Clicking on the error's title will open a page where you can see detailed information and mark it as resolved.
- Package:
- npm:@sentry/browser
- Version:
- 5.25.0
- Repository:
- https://github.com/getsentry/sentry-javascript