What Sentry captures
When an error occurs, Sentry records:- Exceptions — both unhandled crashes and exceptions you explicitly capture
- Stack traces — with source code context around each frame
- Breadcrumbs — a timeline of events (navigation, HTTP requests, console logs) that led to the error
- User context — who was affected, including ID, email, and username
- Tags and custom context — any additional data you attach at capture time
- Release and environment — which version of your app was running and in which environment
Instrumenting your code
Use the Sentry SDK to capture errors and attach context.Most SDKs automatically capture unhandled exceptions without any extra code. Manual
captureException calls are for errors you catch yourself but still want to track.Stack traces with source context
Sentry displays the full call stack at the time of the error. Each frame shows the file, line number, and surrounding source code — so you can see exactly what was executing. If you upload source maps (for JavaScript) or configure debug symbols (for native apps), Sentry maps minified or compiled frames back to your original source code.Breadcrumbs
Breadcrumbs are a trail of events that happened before the error. Sentry automatically records:- Navigation events (page changes, route transitions)
- HTTP requests and their status codes
- Console log output
- UI interactions (clicks, form submissions)
- Prior errors and exceptions
addBreadcrumb / add_breadcrumb.
User context
Attach a user to the current scope so Sentry can tell you how many unique users were affected by an issue. You can include any of these fields:| Field | Description |
|---|---|
id | A unique identifier for the user |
email | The user’s email address |
username | A display name or handle |
ip_address | Set to "{{auto}}" to capture automatically |
Tags and custom context
Tags are key-value pairs you can search and filter by. Custom context lets you attach structured data (like a JSON object) that appears in the issue detail.Issue grouping
Sentry groups similar errors into a single issue so your inbox doesn’t fill up with thousands of individual events. Grouping uses a fingerprint derived from the stack trace and error type. You can customize grouping by:- Setting a custom
fingerprinton the event - Using stack trace rules in your project settings to ignore specific frames
- Merging issues manually in the UI
Suggested fixes with Sentry AI (Seer)
For issues with enough event history, Sentry’s AI feature Seer analyzes the error, your stack trace, and your codebase to suggest a root cause and a potential fix. Look for the “Fix with Seer” button on any issue detail page.Viewing and triaging issues
Navigate to the Issues section in your Sentry project to see all captured errors. From there you can:- Filter by environment, release, user, tag, or date range
- Search using Sentry’s query syntax (e.g.
is:unresolved user.email:jane@example.com) - Assign issues to teammates or teams
- Resolve issues when a fix is deployed
- Ignore issues that are known and acceptable
Source Maps
Upload source maps to see original JavaScript source in stack traces instead of minified code.
Releases
Tag errors with your release version to track which deploy introduced a regression.
Alerts
Set up alert rules to get notified in Slack, email, or PagerDuty when error rates spike.
Ownership Rules
Route issues automatically to the right team based on file paths or URL patterns.