-
Notifications
You must be signed in to change notification settings - Fork 2.8k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
15603ab
commit 474d4cf
Showing
2 changed files
with
53 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,52 @@ | ||
--- | ||
name: Add Sentry to a Bun app | ||
--- | ||
|
||
[Sentry](https://sentry.io) is a developer-first error tracking and performance monitoring platform. Sentry has a first-class SDK for Bun, `@sentry/bun`, that instruments your Bun application to automatically collect error and performance data. | ||
|
||
Don't already have an account and Sentry project established? Head over to [sentry.io](https://sentry.io/signup/), then return to this page. | ||
|
||
--- | ||
|
||
To start using Sentry with Bun, first install the Sentry Bun SDK. | ||
|
||
```bash | ||
bun add @sentry/bun | ||
``` | ||
|
||
--- | ||
|
||
Then, initialize the Sentry SDK with your Sentry DSN in your app's entry file. You can find your DSN in your Sentry project settings. | ||
|
||
```JavaScript | ||
import * as Sentry from '@sentry/bun'; | ||
|
||
// Ensure to call this before importing any other modules! | ||
Sentry.init({ | ||
dsn: '__SENTRY_DSN__', | ||
|
||
// Add Performance Monitoring by setting tracesSampleRate | ||
// We recommend adjusting this value in production | ||
tracesSampleRate: 1.0, | ||
}); | ||
``` | ||
|
||
--- | ||
|
||
You can verify that Sentry is working by capturing a test error: | ||
|
||
```JavaScript | ||
setTimeout(() => { | ||
try { | ||
foo(); | ||
} catch (e) { | ||
Sentry.captureException(e); | ||
} | ||
}, 99); | ||
``` | ||
|
||
To view and resolve the recorded error, log into [sentry.io](https://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. | ||
|
||
--- | ||
|
||
To learn more about Sentry and using the Sentry Bun SDK, view the [Sentry documentation](https://docs.sentry.io/platforms/javascript/guides/bun). |