How to Set Up Error Tracking in Sentry
Errors in production are not just engineering problems; they are product problems. Every unhandled exception is a user who did not complete what they came to do. PMs who understand their error landscape make better prioritization decisions because they can weigh new features against the cost of existing instability. Sentry is the most widely used error tracking platform, and setting it up well means you have a clear, actionable picture of your product's health.
This guide focuses on the Sentry setup that matters for product teams: grouping errors by impact rather than stack trace, configuring alerts that distinguish between noise and signal, and building dashboards that answer the PM question 'is this release stable?' rather than the engineering question 'where is the null pointer?' You will work with engineering on the SDK integration, but the configuration decisions around alert thresholds and issue prioritization are your domain.
Step-by-step guide
Create your Sentry project and install the SDK
Create a Sentry project for each deployable service (frontend, backend API, mobile app). Work with engineering to install the appropriate Sentry SDK. For frontend, the SDK captures JavaScript exceptions, network errors, and user interaction breadcrumbs. For backend, it captures unhandled exceptions and can instrument database and API call performance. Ensure the SDK is configured to send user context (user ID, email) so you can correlate errors with specific users and accounts.
- Create a Sentry project per service (web, API, mobile)
- Install the SDK with user context configuration
- Verify errors are flowing by triggering a test exception
Configure release tracking and source maps
Set up Sentry Release tracking by including the version or commit SHA in the SDK configuration. Upload source maps (for frontend) so error stack traces show original code, not minified bundles. Release tracking allows you to see exactly which release introduced a new error and how errors trend across releases. This is the feature that transforms Sentry from a raw error log into a release health tool.
- Configure the SDK to send the release version with every event
- Add source map upload to your build pipeline
- Verify that error stack traces show original source code in Sentry
Set up issue grouping and prioritization
Sentry automatically groups similar errors into Issues. Review the default grouping and adjust fingerprinting rules if similar errors are being split into separate issues or different errors are being merged. Set up Sentry's Issue Priority feature to automatically rank issues by a combination of frequency, user impact, and recency. This prevents the common problem where the PM prioritizes a loud but low-impact error over a quiet but high-impact one.
- Review default issue grouping for accuracy
- Adjust fingerprinting rules for errors that are incorrectly grouped
- Enable auto-priority based on frequency and user impact
Configure alert rules for product-relevant signals
Create alert rules that notify the right people at the right time. Set up a 'New Issue' alert that fires when a previously unseen error type appears in production (this catches regressions from new releases). Set up a 'Volume Spike' alert for when an existing error's frequency exceeds 5x its baseline. Avoid alerting on every individual error occurrence. Route alerts to a dedicated Slack channel and tag the PM on high-priority issues.
- Create a 'New Issue in Production' alert rule
- Create a 'Volume Spike' alert with a 5x baseline threshold
- Route alerts to Slack with PM notification on high-priority issues
Build a Product Stability dashboard
Create a Sentry Discover dashboard with four queries. First, a crash-free sessions percentage over the last 7 days (this is your North Star stability metric). Second, a timeseries of new issues introduced per release. Third, a table of the top 10 most impactful issues ranked by unique user count. Fourth, an error rate breakdown by page or route so you know which parts of your product are least stable. Pin this dashboard and review it weekly.
- Add a crash-free sessions widget as the primary stability metric
- Add a new issues per release timeseries
- Add a top 10 issues table ranked by affected user count
- Add an error rate breakdown by page/route
Integrate Sentry with your issue tracker
Connect Sentry to your project management tool (Jira, Linear, Asana) so issues can be converted to bug tickets with one click. When a Sentry issue becomes a ticket, the ticket should include the error message, affected user count, first and last occurrence, and a link back to the Sentry issue for debugging. This integration ensures error context flows into your sprint planning without manual copy-pasting.
Common mistakes
Alerting on every error occurrence
If you get a notification for every single error, you will mute the channel within a week. Alert on new issue types and volume spikes, not individual events. The goal is to surface signals, not to create a firehose of notifications that trains the team to ignore alerts.
Not connecting errors to users
An error that affects one user per day is different from an error that affects your largest customer on every login. Without user context in the SDK, all errors look equal. Configure the SDK to send user ID and relevant attributes so you can prioritize by user impact, not just error count.
Ignoring the crash-free sessions metric
Teams fixate on individual errors while missing the forest for the trees. The crash-free sessions percentage tells you what percentage of user sessions complete without encountering an error. A drop from 99.5% to 98% means you doubled the number of users experiencing errors. This is the metric that should trigger prioritization discussions.
Tips
Use Sentry's Session Replay feature (if available for your plan) to see exactly what the user was doing when the error occurred, replacing the need for reproduction steps
Tag errors with the feature flag state at the time of the error so you can quickly identify whether a flag rollout introduced new errors
Set a team SLO for crash-free sessions (e.g., 99.5%) and display it on your team's dashboard to make stability a shared responsibility
Create a monthly 'Bug Bash' ritual where the team triages the top 20 unresolved Sentry issues and creates tickets for the most impactful ones
How Vantage helps
Vantage integrates with your monitoring stack so that when you start a project or write a PRD, you can query error data from your production environment. If you are writing a specification to redesign the checkout flow and it has a 3% error rate, Vantage surfaces that context so your PRD addresses the existing stability issues alongside the new functionality.